Documentation Index
Fetch the complete documentation index at: https://docs.castari.com/llms.txt
Use this file to discover all available pages before exploring further.
CLI Overview
The cast CLI is the fastest way to deploy and manage agents on Castari.
Installation
npm install -g @castari/cli
Commands
| 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 |
Global Options
All commands support these options:
| Option | Description |
|---|
--help | Show help for a command |
--version | Show CLI version |
Configuration
The CLI stores configuration in ~/.castari/:
~/.castari/
├── config.json # API URL, preferences
└── credentials.json # Auth tokens (do not share!)
Environment Variables
| Variable | Description |
|---|
CASTARI_API_URL | Override API base URL |
CASTARI_API_KEY | Use API key instead of OAuth |
Examples
# 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
