Skip to main content

cast init

Create a new agent from a template.

Usage

cast init <name> [options]

Arguments

ArgumentDescriptionRequired
nameName for the new agent directoryYes

Options

OptionDescriptionDefault
-t, --template <name>Template to useInteractive prompt
--no-installSkip npm installfalse

Templates

TemplateDescription
defaultCoding agent with file and bash tools (like Claude Code)
research-agentDeep research with web search and document synthesis
support-agentCustomer support with ticket handling and escalation
mcp-toolsAgent with example MCP server integration

Examples

Interactive mode

cast init my-agent
Prompts you to select a template:
? 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

Specify template

cast init my-agent --template research-agent

Skip npm install

cast init my-agent --no-install

Created Files

my-agent/
├── castari.json      # Agent configuration
├── package.json      # Dependencies
├── tsconfig.json     # TypeScript config
├── src/
│   └── index.ts      # Agent entry point
├── CLAUDE.md         # Agent instructions
└── README.md         # Documentation

Next Steps

After creating an agent:
cd my-agent
cast deploy

See Also