cast agents
Commands for listing and managing your agents.
cast agents list
List all your agents.
Usage
Output
NAME SLUG STATUS CREATED
My Agent my-agent active 2024-01-15
Research Bot research-bot active 2024-01-14
Test Agent test-agent stopped 2024-01-10
cast agents get
Get details for a specific agent.
Usage
Example
Output
Name: My Agent
Slug: my-agent
Status: active
Created: 2024-01-15 10:30:00
Updated: 2024-01-15 14:22:00
Sandbox ID: sbx_xyz789
Git Repo: https://github.com/user/my-agent
cast agents create
Create a new agent without deploying.
Usage
cast agents create <name> <git-url> [options]
Arguments
| Argument | Description | Required |
|---|
name | Display name for the agent | Yes |
git-url | Git repository URL | Yes |
Options
| Option | Description |
|---|
--slug <slug> | Custom slug (auto-generated from name if not provided) |
Example
cast agents create "My Agent" https://github.com/user/my-agent
cast agents create "My Agent" https://github.com/user/my-agent --slug my-custom-slug
Most users should use cast init + cast deploy instead of cast agents create. This command is for advanced use cases.
cast agents delete
Delete an agent.
Usage
cast agents delete <slug>
Example
cast agents delete my-agent
Output
? Are you sure you want to delete 'my-agent'? (y/N) y
✓ Agent 'my-agent' deleted
This permanently deletes the agent, its secrets, and all invocation history. This cannot be undone.
Options
| Option | Description |
|---|
-f, --force | Skip confirmation prompt |
cast agents delete my-agent --force
See Also
