Cast Agent

Build, test, and deploy AI agents.

Cast Agent is a CLI and terminal UI for creating, testing, and deploying AI agents. You describe what the agent should do; Cast Agent scaffolds it and deploys it as an A2A server.

Install

curl -sL https://raw.githubusercontent.com/scott/castagent/main/install.sh | bash

Node.js 18+, Python 3.11+, and Bun. Full install instructions

Why Cast Agent?

  • Interactive Builder: Describe your agent in plain language, get a fully scaffolded agent with proper instructions, tools, and configuration
  • Built-in Runtime: Python-based runtime with A2A protocol support, streaming responses, and secure auth
  • Multiple Deployment Options: Deploy to Docker, Railway, Fly.io, DigitalOcean, or Sprites with a single command
  • Production-Ready: Automatic change tracking, semantic release management, secure token storage, OAuth credential vault, and deployment tracking
  • Agent Versioning: Track every change to your agent with automatic snapshots, create intentional semantic releases, compare with diffs, and rollback to any state
  • GitHub Integration: Full Git operations for agents—init, commit, push, pull, and branch management
  • Agent Memory: Persistent memory system for agents to maintain context across sessions

What you can build

Agents you build with Cast Agent are flexible AI assistants that can be customized for virtually any task. Here are examples of agents you can create:

Developer agents

  • Code review assistant — reviews PRs, suggests improvements, checks style
  • Debugging partner — analyzes errors, traces issues, proposes fixes
  • Documentation writer — generates API docs, README files, code comments

Business agents

  • Customer support agent — answers questions, handles tickets, escalates issues
  • Data analyst — queries databases, generates reports, creates visualizations
  • Meeting scheduler — coordinates calendars, sends invites, handles conflicts

Productivity agents

  • Email assistant — drafts responses, summarizes threads, manages inbox
  • Research assistant — finds information, summarizes papers, extracts insights
  • File organizer — categorizes documents, renames files, manages storage

Communications agents

  • Slack bot — responds to mentions, runs commands, posts updates
  • Newsletter writer — curates content, writes summaries, formats for delivery
  • Social media manager — schedules posts, monitors mentions, engages followers

Create any agent with cast new. Describe what you want, and Cast Agent builds the complete agent scaffold with instructions, tools, and configuration ready for development.

Deployment providers

  • DigitalOcean --provider digitalocean

    Droplet with Docker container hosting

  • DigitalOcean MicroVM --provider microvm

    Firecracker microVM in MKC1. Pauses when idle, resumes on the next request.

  • Docker (local) --provider docker

    Self-hosted Docker container on this machine

  • Fly.io --provider fly

    Distributed containers close to your users

  • Local (no container) --provider local

    Run the agent directly on this machine without Docker

  • Railway --provider railway

    Managed containers with automatic deployments

  • Sprites --provider sprites

    Persistent Firecracker VMs on Fly.io (sprites.dev)