Commands
A complete reference for every command available in Whisper, both in the Terminal and inside interactive mode.
Terminal Commands
These are run from your regular Terminal prompt (not inside Whisper).
whisper
Start Whisper in interactive mode. If you have multiple accounts, pass the account name to choose which one.
bash
whisper
whisper myaccount| Flag | What it does |
|---|---|
--strict-grounding | When verification cannot confirm a stat, the assistant withholds it instead of showing a tentative number |
--disable-verifier | Turns off cloud numeric verification for that session |
--no-verifier | Same as --disable-verifier |
whisper login
Open your browser to sign in and link the CLI to your dashboard account. Run this once during setup, or again any time you need to refresh your session or pick up newly connected accounts.
bash
whisper loginwhisper logout
Sign out of the CLI. You'll need to run whisper login again to reconnect.
bash
whisper logoutwhisper accounts
List all connected accounts. This syncs with the dashboard, so newly connected or removed accounts are reflected automatically.
bash
whisper accountswhisper accounts remove <name>
Remove an account from your local CLI config. Your data files (chat history, profiles) are kept on disk.
bash
whisper accounts remove sunshinevibeswhisper account
Show a quick revenue and data dashboard for your default account (or a specific one).
bash
whisper account
whisper account myaccountwhisper insights
Run the full analytics pipeline: strategy extraction, segment analysis, and playbook generation. Scoring data seeds automatically on first startup, so you only need this for deep analysis and campaign playbooks.
bash
whisper insights
whisper insights myaccount| Option | What it does |
|---|---|
--deep | Syncs more conversation history per subscriber (slower, more thorough) |
--top 50 | Analyze more than the default 30 top spenders |
--force | Re-run even if data is still fresh from a recent run |
For established accounts, we recommend running whisper insights --deep at least once. It pulls significantly more conversation history per subscriber, which means better scoring, better recommendations, and better playbooks. It takes longer but the results are worth it. If you work on a team, only one person needs to run it.
whisper backfill
Pull data for a chosen lookback window into the local cache (and into your cloud backup when you are signed in), so /analyze, account views, and other tools have enough to work with. This does not change your dashboard settings; it only affects that run's depth.
Whisper runs three stages in order:
- Earnings — transaction rows for the window (usually quick).
- Vault — your vault catalog and folders (usually quick).
- Chats and profiles — for subscribers who had recent inbox activity in the window or appear in cached earnings for that window, Whisper deep-syncs chat history (up to a large cap per person) and refreshes their profile snapshot. This stage can take a long time on busy accounts (think tens of minutes to a few hours), because it walks the full history per person with gentle rate limits. The Terminal shows elapsed time (after an hour it switches to hours plus minutes and seconds), which fan is in progress, how many messages are being pulled, and after a few fans a rolling ETA that keeps adjusting, so you can tell it is still working.
bash
whisper backfill
whisper backfill myaccount --days 180| Option | What it does |
|---|---|
--days N | How many days back to use for earnings, vault, and the chat or profile window (default 90, max 730) |
Stopping and resuming: Press Ctrl+C once to stop gracefully. Whatever finished up to that point is usually saved. Run /backfill or whisper backfill again when you are ready; you do not lose the earlier stages.
The first time you open an account with no cached transactions, Whisper may ask if you want to pull the last 90 days before you start chatting. You can skip and run /backfill or whisper backfill whenever you are ready.
whisper campaign
Run a personalized outreach campaign using a playbook and a subscriber list.
bash
whisper campaign my-playbook --list "VIP Fans"
whisper campaign my-playbook --list "VIP Fans" --dry-run| Option | What it does |
|---|---|
--list "Name" | The subscriber list to target (required) |
--dry-run | Preview drafts without sending anything |
whisper autopilot start
Start the Autopilot cockpit. Drafts replies for unread messages and surfaces them inline for your approval.
bash
whisper autopilot start
whisper autopilot start myaccount
whisper autopilot start --mode draft_assist
whisper autopilot start --mode bounded_auto --auto-send| Option | What it does |
|---|---|
--mode <name> | One of shadow, draft_assist, bounded_auto (default draft_assist). |
--auto-send | Required for bounded_auto. Acts as a deliberate second confirmation. |
--poll-ms <n> | Poll interval in milliseconds (default 12000). |
--no-bell | Disable the bell sound when a new approval needs attention. |
At the cockpit prompt, single-key actions are:
| Key | Action |
|---|---|
A | Approve and send the draft. |
E | Edit, then send. |
R | Reject and discard. |
S | Skip for later. |
X | Explain why this draft was suggested. |
Q | Quit the cockpit. |
Press Ctrl+D at the prompt to enter silent mode (keep queueing without inline prompts). Press Ctrl+C to stop cleanly.
whisper autopilot review
Drain approvals queued by Autopilot. Same approve / edit / reject / skip / explain prompt as the live cockpit, but operates only on the already-queued backlog (no polling, no drafting).
bash
whisper autopilot review
whisper autopilot review myaccount
whisper autopilot review --reconcile| Option | What it does |
|---|---|
--reconcile | Pull the cloud mirror first so your local view matches anything other operators already handled. |
This is also where any [FAILED — verify in OF before retrying] rows surface. Verify those in the chat directly before resending anything.
whisper autopilot status
Print the active run (if any), the most recent iteration summary, and the count of pending approvals.
bash
whisper autopilot status
whisper autopilot status myaccountwhisper autopilot stop
Stop active Autopilot runs and release locks. You don't usually need this. Ctrl+C in the cockpit does the same thing. Use stop if you started a run on another machine, or to clean up after a crash.
bash
whisper autopilot stop
whisper autopilot stop myaccountwhisper update
Download and install the latest version of Whisper.
bash
whisper updatewhisper check-updates
Check if a newer version is available without installing it.
bash
whisper check-updateswhisper --no-update-check
Start Whisper without checking for updates. Only affects that session.
bash
whisper --no-update-checkwhisper --version
Print the current version number.
bash
whisper --versionInteractive Commands
These work at the > prompt inside Whisper's interactive mode.
/unreads
Fetch, score, and automatically process all unread conversations. Messages are sent without approval. See Managing Unreads.
/analyze
Run a cloud-backed deep analysis on an open-ended question (patterns, comparisons, anything that needs more than a quick earnings lookup). Whisper streams progress to the Terminal and saves a transcript under your account data folder.
Example: /analyze How did tip revenue trend over the last month versus mass messages?
/backfill
Same pipeline as whisper backfill: earnings for the window, vault catalog, then chat history and subscriber profiles for people in that window. Use /backfill with no arguments for the default 90-day window, or /backfill 180 (any positive number up to 730) for a longer window for that run only.
/grounding
Show or change how Whisper verifies numeric claims against live account data for this session. Use /grounding on, /grounding off, or /grounding strict (strict toggles whether uncertain numbers are withheld or only tagged).
/review
Same as /unreads, but you approve (or edit) every message before it's sent. See Managing Unreads.
/sub <name>
Switch your focus to a specific subscriber. Your prompt changes to @name> and everything you type goes to that subscriber's AI session. See Subscriber Routing.
/sub clear
Return to the general > prompt, clearing your subscriber focus.
/sub
Show your current context and list known subscribers you can switch to. Supports tab completion.
@name <instruction>
Send a one-off instruction routed to a specific subscriber without changing your sticky context. See Subscriber Routing.
/note <text>
Add a standing directive that applies to every conversation. See Directives.
/note Push the Beach Day photoset to outdoor fans
/note --expires 2026-02-28 Valentine's sale is live/notes
List all active directives (both operator-created and AI-created).
/note remove <number>
Remove a specific directive by its number in the /notes list.
/note clear
Remove all directives.
/help
Show available commands.
/quit
Exit Whisper and return to your regular Terminal. Also releases any active conversation claims. You can also use /exit or press Ctrl+C.