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 invokeInvoke a deployed agent
cast agents listList all agents
cast agents getGet agent details
cast agents deleteDelete an agent
cast secrets listList secrets for an agent
cast secrets setSet a secret
cast secrets deleteDelete a secret

​
Global Options

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

​
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