Castari CLI

Deploy AI agents with one command.

Installation

npm install -g @castari/cli

Quick Start

# Authenticate with Castari
cast login

# Create an agent from a git repository
cast agents create my-agent https://github.com/user/my-agent --slug my-agent

# Deploy the agent
cast deploy my-agent

# Invoke the agent
cast invoke my-agent "Hello, world!"

Commands

Authentication

cast login                  # Authenticate via browser (OAuth)
cast logout                 # Clear stored credentials
cast whoami                 # Show current user info
cast apikey create          # Create an API key for CI/CD
cast apikey revoke          # Revoke your API key

Agent Management

cast agents list                                    # List all agents
cast agents create <name> <git-url> --slug <slug>   # Create a new agent
cast agents get <slug>                              # Get agent details
cast agents delete <slug> [--force]                 # Delete an agent

Deployment & Invocation

cast deploy <slug>                    # Deploy an agent
cast invoke <slug> "<prompt>"         # Invoke an agent
cast invoke <slug> --input <file>     # Invoke with prompt from file

Secrets

cast secrets list <slug>                  # List secret keys
cast secrets set <slug> <key> <value>     # Set a secret
cast secrets delete <slug> <key>          # Delete a secret

Usage Statistics

cast usage                  # Show usage summary (last 30 days)
cast usage --days 7         # Show usage for specific period
cast usage --daily          # Show daily breakdown

Authentication

Interactive (OAuth)

For local development, authenticate via browser:

cast login

This opens your browser to sign in and stores credentials in ~/.castari/credentials.yaml.

CI/CD (API Key)

For automated environments, use an API key:

# Create an API key
cast apikey create

# Use it in CI/CD
export CASTARI_API_KEY="cast_..."
cast deploy my-agent

SDK

The CLI is built on @castari/sdk, which you can use directly for programmatic access:

npm install @castari/sdk

import { CastariClient } from '@castari/sdk';

const client = new CastariClient({
  apiKey: process.env.CASTARI_API_KEY,
});

// List agents
const agents = await client.agents.list();

// Deploy an agent
await client.agents.deploy('my-agent');

// Invoke an agent
const result = await client.agents.invoke('my-agent', {
  prompt: 'Hello, world!',
});

console.log(result.response_content);
console.log(`Cost: $${result.total_cost_usd}`);

Configuration

Credentials are stored in ~/.castari/credentials.yaml (mode 0600).

Environment variables:

• CASTARI_API_KEY - API key for authentication
• CASTARI_API_URL - Override API base URL (default: https://api.castari.com)

License

MIT - see LICENSE for details.