Docs/Smooth Agent (self-hosted)
CLI reference
Every smooth-agent command and its main options on one page.
Global option: -c, --config <file> uses another config file.
#Talk
| Command | What it does |
|---|
smooth-agent run | Interactive session with tools (/reset, /exit) |
|---|
smooth-agent run --resume [id] | Continue the last (or a given) session |
|---|
smooth-agent ask "<task>" | One task with tools, then exit (reads stdin if no prompt) |
|---|
smooth-agent ask --terminal "<task>" | Allow shell for this run, asking before each command |
|---|
smooth-agent ask --terminal -y "<task>" | …without asking |
|---|
smooth-agent chat "<text>" | Plain chat, no tools (--no-stream, --max-tokens) |
|---|
-p <provider> and -m <model> work on run, ask and chat.
#Set up and check
| Command | What it does |
|---|
smooth-agent setup | Wizard: provider, model, key, channels (--provider, --model, --key, --channels, --no-channels, --force) |
|---|
smooth-agent doctor [--ping] | What works on this machine; --ping tests the model |
|---|
smooth-agent providers | Configured providers |
|---|
smooth-agent version | Version |
|---|
#Channels and background
| Command | What it does |
|---|
smooth-agent channels list | Configured channels |
|---|
smooth-agent channels test <name> [chat_id] "<msg>" | Send a test message |
|---|
smooth-agent daemon | Channels + scheduled jobs (--no-channels, --once, --interval) |
|---|
smooth-agent service [--install] | Print or install the service (--kind systemd|launchd, --name) |
|---|
#Memory, sessions, jobs
| Command | What it does |
|---|
smooth-agent memory list|add|search|remove|pin|unpin | Long-term memory (--kind) |
|---|
smooth-agent sessions list|show|search|delete | Saved conversations |
|---|
smooth-agent cron list|add|run|pause|resume|remove | Scheduled jobs (--deliver, --script, --skill, --repeat, --model) |
|---|
smooth-agent jobs | The job queue and results (--state) |
|---|
#Skills and MCP
| Command | What it does |
|---|
smooth-agent skills list [--all] | Skills |
|---|
smooth-agent skills search <words> | Search skills |
|---|
smooth-agent skills install <name|git-url|path> | Install a skill |
|---|
smooth-agent skills remove <name> | Remove a skill |
|---|
smooth-agent mcp add <name> --url <url> | Remote MCP server (--header K=V) |
|---|
smooth-agent mcp add <name> -- <command…> | Local MCP server (--env K=V) |
|---|
smooth-agent mcp list|tools <name>|remove <name> | Manage MCP servers |
|---|
Last updated:
