Skip to main content
Use AI 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 AI agent in the workspace:
Show one AI agent by ID:
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 AI agent:
Update name, instructions, model, and other fields:
Update chat widget appearance (theme, colors, etc.):
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:
Clone an AI agent and its sources (Notion sources are excluded):

​
Delete an AI agent

Permanently remove an AI agent:
Deletion cannot be undone. In scripts and CI, pass --confirm agt_123 to skip the interactive prompt.

​
Commands

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