Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
New: Deploy agents directly from Claude Code with /castari-deploy. Learn more
The cast command-line interface
cast CLI is the fastest way to deploy and manage agents on Castari.
npm install -g @castari/cli
| Command | Description |
|---|---|
cast login | Authenticate with Castari |
cast logout | Clear stored credentials |
cast whoami | Show current user |
cast init | Create a new agent from a template |
cast deploy | Deploy an agent |
cast stop | Stop a running agent |
cast invoke | Invoke a deployed agent |
cast agents list | List all agents |
cast agents get | Get agent details |
cast agents update | Update agent configuration |
cast agents delete | Delete an agent |
cast secrets list | List secrets for an agent |
cast secrets set | Set a secret |
cast secrets delete | Delete a secret |
cast apikey list | List API keys |
cast apikey create | Create a new API key |
cast apikey revoke | Revoke an API key |
cast usage | Show usage statistics |
cast buckets | Manage storage buckets |
cast mounts | Mount buckets to agents |
cast files | Manage files in storage |
cast sessions list | List agent sessions |
cast sessions delete | Delete a session |
cast invocations list | List invocation history |
| Option | Description |
|---|---|
--help | Show help for a command |
--version | Show CLI version |
~/.castari/:
~/.castari/
├── config.json # API URL, preferences
└── credentials.json # Auth tokens (do not share!)
| Variable | Description |
|---|---|
CASTARI_API_URL | Override API base URL |
CASTARI_API_KEY | Use API key instead of OAuth |
# Full workflow
cast login
cast init my-agent
cd my-agent
cast deploy
cast invoke my-agent "Hello!"
# Check agent status
cast agents get my-agent
# Add a secret
cast secrets set my-agent OPENAI_API_KEY sk-xxx
Was this page helpful?