Town CLI

Run AI agents from the command line.

Quick Start

npx @townco/cli configure              # Set up API keys
npx @townco/cli create
npx @townco/cli run my-agent           # Run in terminal (TUI)
npx @townco/cli run my-agent --gui     # Run with web interface

Commands

create [name] - Create an agent

npx @townco/cli create                 # Interactive wizard
npx @townco/cli create --name my-agent        # With name
npx @townco/cli create \
  --name my-agent \
  --model claude-sonnet-4-5-20250929 \
  --tools web_search,todo_write \
  --system-prompt "You are a helpful assistant"

list - List all agents

npx @townco/cli list

configure - Set up API keys

npx @townco/cli configure

Sets ANTHROPIC_API_KEY, EXA_API_KEY, etc. in ~/.config/town/.env

run <name> - Run an agent

npx @townco/cli run my-agent           # TUI mode (default)
npx @townco/cli run my-agent --gui     # Web interface
npx @townco/cli run my-agent --http    # HTTP API server
npx @townco/cli run my-agent --http --port 8080

delete <name> - Delete an agent

npx @townco/cli delete my-agent

Models

• claude-sonnet-4-5-20250929 - Latest (recommended)
• claude-opus-4-20250514 - Most capable
• claude-3-5-haiku-20241022 - Fastest

Tools

• todo_write - Task management
• web_search - Web search (requires EXA_API_KEY)
• generate_image - Image generation (requires GEMINI_API_KEY)
• browser - Browser automation (requires KERNEL_API_KEY)