setup / doctor / reset

snippbot setup

Launch the Snippbot installation wizard.

snippbot setup                         # Browser-based wizard (default)
snippbot setup --headless              # CLI-only interactive setup
snippbot setup --resume                # Resume from last completed step
snippbot setup --step api-key          # Jump to a specific step
snippbot setup --force                 # Re-run even if already complete

Option	Default	Description
--mode	self-hosted	self-hosted or cloud
--headless	off	CLI-only setup (no browser)
--port	18781	Backend API port
--host	127.0.0.1	Host to bind
--resume	off	Resume from last completed step
--step	—	Jump to step: genesis, identity, api-key, ignition, awakening
--force	off	Re-run setup even if already complete

Browser mode (default): Opens http://127.0.0.1:18781/setup in your browser. The 6-step wizard walks through system checks, identity, authentication, voice, model selection, and final verification.

Headless mode: Prompts for display name, email, and API key directly in the terminal. Useful for server environments without a browser.

---

snippbot doctor

Run a full health check on your Snippbot installation.

snippbot doctor                   # Show all diagnostics
snippbot doctor --fix             # Auto-fix detected issues
snippbot doctor --json            # JSON output

Option	Description
--fix	Attempt to automatically fix detected issues
--json	Output as JSON

Checks performed:

Check	What it verifies
Python version	Python 3.11+ is installed
Disk space	Sufficient free space for data directory
Port availability	Ports 18781 and 18790 are not in use
Database integrity	SQLite databases are valid and readable
API key validity	At least one AI provider API key is configured
Server connectivity	Daemon is reachable at configured host/port

Example output:

✓ Python 3.12.2 (3.11+ required)
✓ Disk space: 45.2 GB free
✓ Port 18781 available
✓ Port 18783 available
✓ Database: snippbot.db (OK)
✓ Database: auth.db (OK)
✓ API key: anthropic (configured)
✗ Server: not running (run `snippbot start` to start)

---

snippbot reset

Reset your Snippbot installation. Always creates a backup first.

snippbot reset                         # Full reset (keeps agent workspaces)
snippbot reset --soft                  # Reset setup wizard state only
snippbot reset --keep-config           # Keep config.toml
snippbot reset --keep-data             # Keep databases
snippbot reset --keep-agents           # Keep agent workspaces
snippbot reset --force                 # Skip confirmation prompt

snippbot reset --list-backups          # List available backups
snippbot reset --restore               # Restore from most recent backup

Option	Description
--soft	Reset setup state only — fastest way to re-run the wizard
--keep-agents	Preserve agent workspaces
--keep-config	Preserve config.toml
--keep-data	Preserve all databases
--force	Skip confirmation prompt
--restore	Restore from most recent backup
--list-backups	List all available backups

Reset levels (least to most destructive):

Level	Command	What’s wiped
Soft	reset --soft	Setup state only
Partial	reset --keep-agents	Config + databases
Full	reset	Config + databases + workspaces

All destructive resets create a timestamped backup in ~/.snippbot/backups/ before proceeding.

# Restore from a backup
snippbot reset --list-backups
# pre-install-20260301-120000

snippbot reset --restore pre-install-20260301-120000