Command Reference

Whisper has two types of commands: Terminal commands that you run from your regular Terminal prompt, and session commands that you use inside Whisper at the > prompt.

Terminal Commands

Run these from your regular Terminal (outside of Whisper). If you're inside Whisper, type /quit first.

whisper

Start Whisper in interactive chat mode.

whisper [account]

Option	Description
account	Optional. The account alias to use. Defaults to your primary account.
--auto	Run in autonomous mode (hands-free, no approval needed)
-p, --prompt "..."	Run a single instruction and exit without entering interactive mode
--no-update-check	Skip the automatic update check on startup

Examples:

whisper                              # Start with default account
whisper myaccount                    # Start with a specific account
whisper --auto                       # Start in auto mode
whisper -p "how much did I earn today?"  # Run one command and exit

whisper login

Set up or update your configuration. Walks you through API key, account selection, AI provider, persona, and optional analytics setup.

whisper login

Run this again any time you need to change settings.

whisper accounts

List all configured accounts.

whisper accounts

whisper accounts remove

Remove a configured account.

whisper accounts remove <alias>

whisper account

Show the account dashboard with revenue, subscriber stats, and local data coverage.

whisper account [account]

Option	Description
account	Optional. The account alias. Defaults to your primary account.

whisper insights

Run the analytics pipeline. Analyzes your top conversations, finds conversion patterns, and generates playbooks.

whisper insights [account]

Option	Description
account	Optional. The account alias. Defaults to your primary account.
--deep	Sync more conversation history per subscriber (slower, more thorough)
--top <number>	Number of top spenders to analyze. Default: 30
--force	Re-run even if recent data is still fresh

Examples:

whisper insights                     # Standard run
whisper insights --deep              # Deep analysis
whisper insights --top 50            # Analyze top 50 spenders
whisper insights --deep --top 50     # Deep analysis of top 50

whisper campaign

Run a personalized outreach campaign using a playbook and a subscriber list.

whisper campaign <playbook> [account] --list <name>

Option	Description
playbook	Required. The name of the playbook to use (generated by whisper insights)
account	Optional. The account alias. Defaults to your primary account.
--list <name>	Required. The subscriber list name or ID to target
--dry-run	Preview messages without actually sending them

Examples:

whisper campaign vip-engagement --list "VIP Fans"
whisper campaign vip-engagement --list "VIP Fans" --dry-run

whisper update

Download and install the latest version of Whisper.

whisper update

whisper check-updates

Check if a newer version is available without installing it.

whisper check-updates

Session Commands

Use these inside Whisper at the > prompt. They start with / or @.

Chat Management

Command	Description
/unreads	Process all unread messages automatically. Scores and ranks by opportunity, then sends replies.
/review	Review AI drafts before sending. For each unread: see the draft, then Send, Edit, Skip, or Quit. Edits teach Whisper your style.
/help	Show available commands and a quick usage summary.
/quit	Exit Whisper. Also works: /exit or Ctrl+C.

Subscriber Routing

Command	Description
/sub	Show your current subscriber context and list known subscribers.
/sub <name>	Switch to a subscriber's context. Prompt changes to @name>. Tab completion supported.
/sub clear	Return to the general > prompt.
@name <instruction>	Send a one-off instruction routed to that subscriber's session without changing your context. Tab completion supported.

Directives

Command	Description
/note <text>	Add a standing directive that applies to every conversation.
/note --expires <date> <text>	Add a directive with an expiry date (e.g. 2026-02-28).
/note remove <number>	Remove a directive by its number (from /notes list).
/note clear	Remove all directives.
/notes	List all active directives with numbers and source tags.