CLI Overview

The snippbot CLI manages the daemon, projects, devices, channels, secrets, authentication, the Singularity marketplace, and more — a total of 17 command groups.

Quick reference

Command	Description
snippbot start	Start the daemon
snippbot stop	Stop the daemon
snippbot status	Check daemon status
snippbot config	Manage configuration
snippbot project	Manage projects
snippbot channel	Manage messaging channels
snippbot device	Manage paired devices
snippbot setup	Run installation wizard
snippbot doctor	Diagnose system health
snippbot reset	Reset installation
snippbot secrets	Manage encrypted secrets
snippbot auth	Manage user account & API keys
snippbot export	Export data as JSON
snippbot security	Security scans & findings
snippbot skills	Skill vetting & verification
snippbot marketplace	Singularity Marketplace
snippbot completions	Shell completion scripts (bash/zsh/fish)

Installation

The CLI is installed as part of Snippbot:

pip install snippbot          # Installs snippbot CLI globally

Or from source:

pip install -e packages/cli   # Install from monorepo

Verify installation:

snippbot --version
snippbot --help

Common first-run workflow

snippbot setup          # Run interactive setup wizard
snippbot start          # Start the daemon
snippbot status         # Verify it's running
# Open http://localhost:18781 in your browser

Global options

All snippbot commands support:

Option	Description
--help	Show help for any command
--version	Show version number

Note

Most commands that communicate with the running daemon use --port (default: 18781) and --host (default: "", empty string for dual-stack IPv4 + IPv6) to target the right instance.

Sub-command structure

Each top-level command has sub-commands:

snippbot
├── start
├── stop
├── status
├── config
│   ├── list
│   ├── get <key>
│   ├── set <key> <value>
│   ├── delete <key>
│   ├── path
│   └── init
├── project
│   ├── list
│   ├── show <id>
│   ├── approve <id>
│   └── cancel <id>
├── channel
│   ├── start
│   ├── stop
│   ├── status
│   └── list
├── device
│   ├── list
│   ├── info <id>
│   ├── revoke <id>
│   ├── block <id>
│   ├── delete <id>
│   └── exec <id> <tool>
├── setup
├── doctor
├── reset
├── secrets
│   ├── set <name>
│   ├── get <name>
│   ├── list
│   ├── delete <name>
│   ├── rotate <name>
│   ├── export
│   ├── import <file>
│   └── audit
├── auth
│   ├── create-user
│   ├── change-password
│   ├── status
│   ├── create-key
│   ├── list-keys
│   ├── revoke-key <id>
│   └── regenerate-key <id>
├── export
│   ├── conversations
│   ├── projects
│   └── all
├── security
│   ├── scan
│   ├── report
│   ├── findings
│   └── history
├── skills
│   ├── verify <path>
│   └── scan <path>
├── marketplace
│   ├── search [query]
│   ├── install <ref>
│   ├── uninstall <ref>
│   ├── list
│   ├── info <ref>
│   ├── publish [dir]
│   ├── login
│   ├── logout
│   ├── whoami
│   ├── register
│   ├── init [dir]
│   ├── update
│   └── ... (see marketplace page for advanced commands)
└── completions <shell>

Related pages

• start / stop / status — daemon lifecycle
• config — configuration management
• project — project management
• setup / doctor — setup and diagnostics
• device — device management
• channel — channel management
• secrets — encrypted secret store
• auth — daemon user account & API keys
• export — data export
• security / skills — security scans & skill vetting
• marketplace — Singularity Marketplace
• completions — shell completion scripts