Skip to main content

​
Quick Start

Deploy your first Claude agent in under 5 minutes.
Prerequisites: Node.js 18+ and npm installed.
Using Claude Code? Type /castari-deploy and the skill handles all of these steps for you. Install it with npx skills add castari/cli. Learn more.
1

Install the CLI

npm install -g @castari/cli
Verify installation:
cast --version
2

Login to Castari

cast login
This opens your browser to authenticate. Once complete, you’ll see:
✓ Logged in as [email protected]
3

Create your first agent

cast init my-agent
Select the default template when prompted. This creates a coding agent with file and bash tools.
? Select a template:
❯ default — Coding agent with file and bash tools (like Claude Code)
  research-agent — Deep research with web search and document synthesis
  support-agent — Customer support with ticket handling and escalation
  mcp-tools — Agent with example MCP server integration

✓ Created my-agent/ from default template
✓ Installed dependencies
4

Deploy your agent

cd my-agent
cast deploy
Wait for deployment to complete:
⠋ Deploying my-agent...
✓ Agent 'my-agent' deployed!
5

Invoke your agent

cast invoke my-agent "What files are in the current directory?"
Your agent responds:
The current directory contains:
- src/index.ts
- package.json
- castari.json
- CLAUDE.md
- README.md

​
You did it!

Your agent is deployed and running. Here’s what you can do next:

Customize Your Agent

Edit the code and CLAUDE.md to change behavior

Add Secrets

Add API keys and environment variables

Try Other Templates

Research agents, support agents, and more

Use the SDK

Invoke agents programmatically