CLI Agents

Create, inspect, update, clone, and delete Chatbase agents from the terminal.

Use agent commands to manage the AI agents in your workspace. For REST details, see Agents API. Authenticate first — see CLI Auth.

List and inspect

List every agent in the workspace:

chatbase agents list

Show one agent by ID:

chatbase agents get agt_123

Use --json or --plain for scripting. Set a default agent with CLI Config so you can omit the ID on get and other commands.

Create and configure

Create a new agent:

chatbase agents create --name "Support Bot" --instructions "Be helpful"

Update name, instructions, model, and other fields:

chatbase agents update agt_123 --name "Support Bot v2"

Update chat widget appearance (theme, colors, etc.):

chatbase agents styles agt_123 --data '{"chat":{"theme":"dark"}}'

Pass a JSON file with @styles.json instead of inline JSON when you have many style properties.

Auto-resync and duplicate

Sources train on their own when you add or change them, so there is no train step. chatbase agents train is deprecated and does nothing.

Turn on the weekly auto-resync for websites, Notion pages, and tickets:

chatbase agents auto-retrain agt_123 --enabled

Clone an agent and its sources (Notion sources are excluded):

chatbase agents clone agt_123

Delete an agent

Permanently remove an agent:

chatbase agents delete agt_123

Deletion cannot be undone. In scripts and CI, pass --confirm agt_123 to skip the interactive prompt.

Commands

Command	Purpose
chatbase agents auto-retrain	Enable or disable the weekly auto-resync of websites, Notion pages, and tickets
chatbase agents clone	Clone an agent, including all its sources (excluding Notion)
chatbase agents create	Create a new agent
chatbase agents delete	Permanently delete an agent (cannot be undone)
chatbase agents get	Show one agent
chatbase agents list	List all agents in the workspace
chatbase agents styles	Update visual styles for an agent
chatbase agents train	Deprecated. Sources train on write; this command does nothing
chatbase agents update	Update an existing agent

For every flag, run chatbase agents <command> --help.