Skip to main content

​
CLI Overview

The cast CLI is the fastest way to deploy and manage agents on Castari.

​
Installation

npm install -g @castari/cli

​
Commands

CommandDescription
cast loginAuthenticate with Castari
cast logoutClear stored credentials
cast whoamiShow current user
cast initCreate a new agent from a template
cast deployDeploy an agent
cast stopStop a running agent
cast invokeInvoke a deployed agent
cast agents listList all agents
cast agents getGet agent details
cast agents updateUpdate agent configuration
cast agents deleteDelete an agent
cast secrets listList secrets for an agent
cast secrets setSet a secret
cast secrets deleteDelete a secret
cast apikey listList API keys
cast apikey createCreate a new API key
cast apikey revokeRevoke an API key
cast usageShow usage statistics
cast bucketsManage storage buckets
cast mountsMount buckets to agents
cast filesManage files in storage
cast sessions listList agent sessions
cast sessions deleteDelete a session
cast invocations listList invocation history

​
Global Options

All commands support these options:
OptionDescription
--helpShow help for a command
--versionShow CLI version

​
Configuration

The CLI stores configuration in ~/.castari/: 
~/.castari/
├── config.json      # API URL, preferences
└── credentials.json # Auth tokens (do not share!)

​
Environment Variables

VariableDescription
CASTARI_API_URLOverride API base URL
CASTARI_API_KEYUse 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