CLI Reference

The whiz command-line tool lets you manage your whiz.pub blog from the terminal.

Installation

Install script

curl -sL https://whiz.pub/install | sh

Installs to ~/.local/bin. No sudo required.

Commands

auth

Save an API key for subsequent commands.

whiz auth [API_KEY]

Flag	Description
--api-base	API server URL (default: https://whiz.pub)

whiz auth sk_abc123

---

signup

Create a new whiz.pub account interactively.

whiz signup

Flag	Description
--api-base	API server URL (default: https://whiz.pub)
--email	Email address (skips prompt)
--password	Password (skips prompt)
--subdomain	Subdomain (skips prompt)

whiz signup
whiz signup --email you@example.com --password secret --subdomain yourname

On success, prints your API key and saves it locally.

---

verify

Verify your email address with a 6-digit code.

whiz verify [CODE]

whiz verify 123456

---

resend-verification

Request a new verification code.

whiz resend-verification

whiz resend-verification

---

forgot-password

Request a password reset email.

whiz forgot-password [--email EMAIL]

whiz forgot-password --email user@example.com

If --email is not provided, you will be prompted for it. A reset link will be sent to the email if the account exists.

---

reset-password

Reset your password using a token from the reset email.

whiz reset-password [--token TOKEN] [--password PASSWORD]

whiz reset-password --token abc123def456

If --token or --password are not provided, you will be prompted for them.

---

write

Create a new markdown file with frontmatter scaffolding and open it in $EDITOR.

whiz write [FILE]

whiz write hello.md

---

edit

Fetch an existing post by slug and open it in $EDITOR for editing. Saves changes on exit.

whiz edit [SLUG]

whiz edit my-first-post

---

publish

Upload a markdown file as a post. Creates a new post or updates an existing one (upsert by slug).

whiz publish [FILE]

whiz publish hello.md

---

list

List all posts on your blog.

whiz list

whiz list

---

delete

Delete a post by slug.

whiz delete [SLUG]

Flag	Description
-f, --force	Skip confirmation prompt

whiz delete my-first-post
whiz delete my-first-post -f

---

domain add

Register a custom domain for your blog.

whiz domain add [DOMAIN]

whiz domain add example.com

Prints DNS instructions including the required CNAME record (for subdomains), A record (for apex domains), and TXT verification record values.

---

domain verify

Verify DNS records for a previously added custom domain.

whiz domain verify [DOMAIN]

whiz domain verify example.com

---

domain remove

Remove the custom domain from your blog.

whiz domain remove

Flag	Description
-f, --force	Skip confirmation prompt

whiz domain remove
whiz domain remove -f

---

headless enable

Enable headless (CMS-only) mode. Public blog pages return 404; API, CLI, and MCP continue to work. Your subdomain stays reserved. Cannot be enabled while a custom domain is configured.

whiz headless enable

whiz headless enable

---

headless disable

Disable headless mode. Public blog pages are served normally again.

whiz headless disable

whiz headless disable

---

version

Print the CLI version.

whiz version

whiz version