cas

  ██████╗ █████╗ ███████╗
 ██╔════╝██╔══██╗██╔════╝
 ██║     ███████║███████╗
 ██║     ██╔══██║╚════██║
 ╚██████╗██║  ██║███████║
  ╚═════╝╚═╝  ╚═╝╚══════╝

Multi-agent coding factory with persistent memory.

Factory · Context System · Quick Start · Installation · Architecture · Contributing

What is CAS?

CAS is a multi-agent coding factory and persistent context system for AI agents. It has two core capabilities:

1. Factory — A terminal UI that orchestrates multiple Claude Code instances working in parallel on the same codebase, with a supervisor agent coordinating worker agents across isolated git worktrees.

2. Context System — An MCP server that gives agents persistent memory, task tracking, rules, and skills across sessions, backed by SQLite and full-text search.

Factory

Factory mode turns your terminal into a multi-agent coding operation. A supervisor agent breaks work into tasks while worker agents execute them in parallel — each in its own git worktree to avoid conflicts.

# Launch the factory TUI
cas

# Launch with 3 workers in isolated worktrees
cas -w 3

How it works

┌─────────────────────────────────────────────────────────┐
│  CAS Factory                                            │
├──────────────────────┬──────────────────────────────────┤
│                      │                                  │
│  Supervisor          │  Worker 1        Worker 2        │
│                      │                                  │
│  Plans EPICs,        │  Executes tasks  Executes tasks  │
│  breaks down work,   │  in isolated     in isolated     │
│  assigns tasks,      │  git worktree    git worktree    │
│  reviews & merges    │                                  │
│                      │                                  │
├──────────────────────┴──────────────────────────────────┤
│  Shared: CAS database (memories, tasks, rules, skills)  │
└─────────────────────────────────────────────────────────┘

• Supervisor plans work, creates tasks, assigns them to workers, reviews completed work, and merges branches
• Workers each get their own git worktree and branch — no merge conflicts during parallel execution
• Shared context — all agents read/write the same CAS database for memories, tasks, rules, and coordination messages
• Built-in terminal multiplexer — side-by-side or tabbed views of all agent sessions, with a custom VT parser (based on Ghostty)

Factory features

When to use Factory

• Large features — break an epic into subtasks and parallelize across workers
• Codebase-wide refactors — workers modify different files simultaneously without conflicts
• Multi-step workflows — tasks with dependencies execute in the right order
• Code review — supervisor reviews worker output before merging to the main branch

Context System

CAS runs as an MCP server that gives your agent persistent context across sessions — 50+ tools for memory, tasks, rules, skills, and search.

MCP Tools

When your agent has CAS configured, it can:

# Remember something across sessions
mcp__cas__memory action=remember content="This project uses Zod for validation"

# Create and track tasks
mcp__cas__task action=create title="Implement auth" priority=1

# Search past context
mcp__cas__search action=search query="error handling patterns"

# Create a rule that auto-syncs to .claude/rules/
mcp__cas__rule action=create content="Always validate input at API boundaries"

What persists

Quick Start

# Install
curl -fsSL https://cas.dev/install.sh | sh

# Initialize in your project
cas init

# Launch the factory TUI
cas

Installation

curl (recommended)

curl -fsSL https://cas.dev/install.sh | sh

Homebrew

brew tap codingagentsystem/cas
brew install cas

Build from source

git clone https://github.com/codingagentsystem/cas.git
cd cas
cargo build --release
# Binary at target/release/cas

CLI

cas                   # Launch the factory TUI
cas -w 3              # Launch with 3 workers
cas serve             # Start MCP server for Claude Code
cas init              # Initialize CAS in your project
cas attach            # Attach to a running factory session
cas list              # List running factory sessions
cas kill              # Kill a factory session
cas config list       # View all configuration options
cas doctor            # Run diagnostics
cas update            # Self-update to latest version
cas login             # Log in to CAS Cloud (optional)
cas cloud sync        # Sync data to/from cloud (optional)

Claude Code Integration

Add to your Claude Code MCP config (.claude/settings.json or project .mcp.json):

{
  "mcpServers": {
    "cas": {
      "command": "cas",
      "args": ["serve"]
    }
  }
}

Architecture

Data storage

CAS stores all data locally in your project:

.cas/
├── cas.db          # SQLite — memories, tasks, rules, skills
├── config.yaml     # Project configuration
└── indexes/
    └── tantivy/    # Full-text search index

Storage tiers:

• Project (.cas/) — project-specific context
• Global (~/.config/cas/) — cross-project preferences and learnings

Workspace Crates

Built With

• Rust for performance and reliability
• SQLite for local-first storage
• Tantivy for full-text search (BM25)
• Ratatui for the factory TUI
• Ghostty VT for terminal emulation
• rmcp for MCP protocol support

Configuration

CAS is configured via .cas/config.yaml in your project root. Run cas config list to see all options or cas config describe <key> for details on any setting.

Cloud Sync (optional)

CAS works fully offline. Optionally sync your context across devices:

cas login
cas cloud sync

Cloud sync is not required — all core features work locally with SQLite.

Contributing

CAS is source-available under the MIT license. We welcome bug reports and feature suggestions through Issues and Discussions.

See CONTRIBUTING.md for details.

License

MIT