CLI commands
This page covers the anton command-line surface. For commands you type inside a chat, see Slash commands.
This page mirrors anton/cli.py. If you change the CLI, update this page in the same pull request.
anton — start a chat
anton [--folder PATH] [--resume]
Running anton with no subcommand starts an interactive chat in the current directory. On first run it walks you through accepting the terms and choosing an LLM provider; after that it drops you straight into the prompt. It also checks for updates and initializes the workspace's .anton/ folder if needed.
| Option | Short | What it does |
|---|---|---|
--folder PATH | -f | Use PATH as the workspace instead of the current directory |
--resume | -r | Resume a previous chat session instead of starting fresh |
anton -f ~/projects/sales-analysis -r
The --folder and --resume options belong to the top-level command and also apply when running subcommands (for example, to point a subcommand at another workspace).
anton setup
Configure the LLM provider, model, and API key. Runs the same guided flow as first-run onboarding: pick Minds-Enterprise-Cloud, a self-hosted Minds server, or bring your own key (Anthropic, OpenAI, Google Gemini, or any OpenAI-compatible endpoint). Validates the key with a live probe before saving. See Pick a provider.
anton setup
anton setup-search
Configure an external web-search provider — Exa.ai or Brave Search. Only needed when your LLM endpoint is a generic OpenAI-compatible one without native web search (Anthropic, OpenAI, and mdb.ai provide search themselves). The key is validated and saved to the global ~/.anton/.env, so it carries across all workspaces. See Search providers.
anton setup-search
anton dashboard
Show the Anton status dashboard in the terminal. See Dashboard.
anton dashboard
anton sessions
List recent sessions as a table: ID, task, status, and a short summary preview.
anton sessions
anton session <id>
Show one session's details — its task, status, and full summary. Get the ID from anton sessions. Exits with an error if the ID isn't found.
anton session 20260227_143052
anton learnings
List stored learnings from the legacy learning store as a topic + summary table. See The learnings command for what this is and how old learnings are migrated into current memory.
anton learnings
anton version
Print the installed Anton version.
anton version
anton connect [slug]
Connect a database or API to the Local Vault. With no argument, starts the interactive connect flow (same as /connect in chat). Pass an existing connection slug to reconnect using stored credentials without re-entering them.
anton connect
anton connect postgres-mydb
anton list
List all saved data-source connections in the Local Vault.
anton list
anton edit <name>
Edit credentials for an existing Local Vault connection, by slug.
anton edit postgres-mydb
anton remove <name>
Remove a saved connection from the Local Vault, by slug.
anton remove postgres-mydb
anton test <name>
Test a saved Local Vault connection by running its test snippet.
anton test postgres-mydb
For more on connections, see Connecting data sources.