|
1 | | -# CAS — Persistent Context for AI Agents |
| 1 | +# CAS — Run a Team of Claude Code Agents |
2 | 2 |
|
3 | | -Your AI agent forgets everything when the session ends. CAS fixes that. |
4 | | - |
5 | | -CAS is the context layer for AI coding agents. Memories that persist. Tasks that coordinate. Rules that evolve. Skills that compound. Agents that actually learn. |
| 3 | +One supervisor plans. Multiple workers execute. You review the results. |
6 | 4 |
|
7 | 5 | ## Install |
8 | 6 |
|
9 | 7 | ```bash |
10 | | -curl -fsSL https://codingagentsystem.com/install.sh | sh |
11 | | -``` |
12 | | - |
13 | | -## What CAS Does |
14 | | - |
15 | | -| Feature | What It Does | |
16 | | -|---------|--------------| |
17 | | -| **Memory** | Stores learnings, preferences, and observations across sessions | |
18 | | -| **Tasks** | Tracks work with dependencies, priorities, and structured notes | |
19 | | -| **Rules** | Coding conventions that auto-sync to Claude Code | |
20 | | -| **Skills** | Reusable agent capabilities with usage tracking | |
21 | | -| **Factory** | Multi-agent coordination with supervisor + workers | |
22 | | -| **Search** | Hybrid BM25 + semantic retrieval across all context | |
23 | | - |
24 | | -## Quick Start |
25 | | - |
26 | | -### For Agents (MCP Tools) |
27 | | - |
28 | | -CAS exposes 57+ tools via MCP. When your agent has CAS access: |
29 | | - |
30 | | -``` |
31 | | -mcp__cas__memory action=remember content="This codebase uses Zod for validation" |
32 | | -mcp__cas__task action=create title="Implement auth" priority=1 start=true |
33 | | -mcp__cas__search action=search query="error handling patterns" |
34 | | -``` |
35 | | - |
36 | | -### For Humans (CLI) |
37 | | - |
38 | | -```bash |
39 | | -# Initialize in your project |
40 | | -cas init |
41 | | - |
42 | | -# Store a learning |
43 | | -cas add "Always use async/await over callbacks" --tags patterns |
44 | | - |
45 | | -# Create a task |
46 | | -cas task create "Fix login bug" --priority 1 --start |
47 | | - |
48 | | -# Search context |
49 | | -cas search "authentication flow" |
50 | | - |
51 | | -# Start MCP server |
52 | | -cas serve |
| 8 | +curl -fsSL https://cas.dev/install.sh | sh |
53 | 9 | ``` |
54 | 10 |
|
55 | | -### Claude Code Integration |
56 | | - |
57 | | -Add to your MCP settings (`~/Library/Application Support/Claude/claude_desktop_config.json`): |
58 | | - |
59 | | -```json |
60 | | -{ |
61 | | - "mcpServers": { |
62 | | - "cas": { |
63 | | - "command": "cas", |
64 | | - "args": ["serve"] |
65 | | - } |
66 | | - } |
67 | | -} |
68 | | -``` |
69 | | - |
70 | | -## Factory Mode |
71 | | - |
72 | | -Scale beyond single-agent. Factory mode coordinates multiple Claude instances working in parallel. |
| 11 | +Then in your project: |
73 | 12 |
|
74 | 13 | ```bash |
75 | | -# Start supervisor (coordinates work) |
76 | | -cas factory --supervisor |
77 | | - |
78 | | -# Spawn workers (in TUI or via MCP) |
79 | | -mcp__cas__factory action=spawn_workers count=3 |
| 14 | +cas init # Initialize CAS |
| 15 | +cas factory # Launch Factory Mode |
80 | 16 | ``` |
81 | 17 |
|
82 | | -**How it works:** |
83 | | -- **Supervisor** breaks EPICs into tasks, assigns work, reviews PRs |
84 | | -- **Workers** claim tasks, execute in isolated git worktrees, report progress |
85 | | -- **Shared state** via CAS database — all agents see the same memories, tasks, rules |
| 18 | +## The Factory Pattern |
86 | 19 |
|
87 | | -**When to use:** |
88 | | -- Large features requiring parallel implementation |
89 | | -- Site-wide refactors across many files |
90 | | -- Multi-stage workflows with dependencies |
| 20 | +| Step | Role | What It Does | |
| 21 | +|------|------|--------------| |
| 22 | +| 01 | **Supervisor** | Breaks down requests into EPICs with discrete tasks and dependencies | |
| 23 | +| 02 | **Workers** | Claim tasks and work simultaneously in isolated git worktrees | |
| 24 | +| 03 | **You** | Review PRs and merge when ready | |
91 | 25 |
|
92 | 26 | ## Features |
93 | 27 |
|
94 | | -### Memory System |
95 | | - |
96 | | -Memories persist across sessions with intelligent retrieval: |
97 | | - |
98 | | -```bash |
99 | | -cas add "PostgreSQL with JSONB columns" --tags db,architecture |
100 | | -cas add "Prefer explicit error handling" --type preference |
101 | | -cas search "database patterns" --boost-feedback |
102 | | -``` |
103 | | - |
104 | | -**Memory Tiers:** |
105 | | -- **In-Context** — Pinned, always injected |
106 | | -- **Working** — Active and searchable (default) |
107 | | -- **Cold** — Less accessed, may be compressed |
108 | | -- **Archive** — Historical reference |
109 | | - |
110 | | -### Task System |
111 | | - |
112 | | -Dependencies, priorities, structured progress tracking: |
113 | | - |
114 | | -```bash |
115 | | -cas task create "Deploy to prod" --blocked-by cas-a1b2 |
116 | | -cas task start cas-c3d4 |
117 | | -cas task notes cas-c3d4 "Found root cause" --type discovery |
118 | | -cas task close cas-c3d4 --reason "Fixed in abc123" |
119 | | -cas task ready # Show unblocked tasks |
120 | | -``` |
121 | | - |
122 | | -### Rules System |
123 | | - |
124 | | -Coding conventions that earn trust through use: |
125 | | - |
126 | | -``` |
127 | | -Draft → Proven → Retired |
128 | | - ↑ |
129 | | - (cas rules helpful) |
130 | | -``` |
131 | | - |
132 | | -Proven rules sync to `.claude/rules/` and load into Claude Code automatically. |
133 | | - |
134 | | -```bash |
135 | | -cas rules add "Always validate input before DB queries" --paths "**/*.ts" |
136 | | -cas rules helpful rule-001 # Promotes to Proven |
137 | | -``` |
138 | | - |
139 | | -### Skills System |
140 | | - |
141 | | -Reusable capabilities your agent can invoke: |
142 | | - |
143 | | -```bash |
144 | | -cas skill create "Format Code" \ |
145 | | - --description "Run prettier on project" \ |
146 | | - --invocation "npx prettier --write ." \ |
147 | | - --type command |
148 | | - |
149 | | -cas skill enable skill-001 # Sync to Claude Code |
150 | | -``` |
151 | | - |
152 | | -### Search |
153 | | - |
154 | | -Hybrid retrieval combining keyword matching and semantic understanding: |
155 | | - |
156 | | -```bash |
157 | | -cas search "error handling" # Hybrid search |
158 | | -cas search "testing" --no-semantic # Fast BM25 only |
159 | | -cas search "patterns" --boost-feedback # Rank by helpfulness |
160 | | -``` |
161 | | - |
162 | | -## Architecture |
163 | | - |
164 | | -``` |
165 | | -.cas/ |
166 | | -├── cas.db # SQLite — memories, tasks, rules, skills |
167 | | -├── config.yaml # Project configuration |
168 | | -├── vectors.hnsw # Semantic search index (HNSW) |
169 | | -└── indexes/ |
170 | | - └── tantivy/ # Full-text search index (BM25) |
171 | | -``` |
172 | | - |
173 | | -**Two-tier storage:** |
174 | | -- **Global** (`~/.config/cas/`) — User preferences, cross-project learnings |
175 | | -- **Project** (`.cas/`) — Project-specific context |
176 | | - |
177 | | -**Built with:** |
178 | | -- Rust for performance |
179 | | -- candle for GPU-accelerated embeddings |
180 | | -- tantivy for full-text search |
181 | | -- usearch for vector indexing |
182 | | -- rmcp for MCP protocol |
183 | | - |
184 | | -## Documentation |
185 | | - |
186 | | -- [Getting Started Guide](docs/GETTING_STARTED.md) |
187 | | -- [Factory Mode Guide](docs/FACTORY_MODE.md) |
188 | | -- [MCP Tools Reference](docs/MCP_TOOLS.md) |
189 | | -- [Configuration Reference](docs/CONFIGURATION.md) |
190 | | - |
191 | | -## Self-Update |
192 | | - |
193 | | -```bash |
194 | | -cas update |
195 | | -``` |
196 | | - |
197 | | -## Privacy |
198 | | - |
199 | | -CAS collects anonymous usage data to improve the product. No code or personal information is collected. |
| 28 | +| Feature | Description | |
| 29 | +|---------|-------------| |
| 30 | +| **Persistent Memory** | What one agent learns, all agents remember. Context that compounds across sessions. | |
| 31 | +| **Task Orchestration** | Structured task management with dependencies, priorities, and automatic assignment. | |
| 32 | +| **Self-Improving Rules** | Patterns that work get promoted. Mistakes become guardrails automatically. | |
| 33 | +| **Reusable Skills** | Teach once, every worker knows it. Custom tools, workflows, domain knowledge. | |
| 34 | +| **Git Worktrees** | Each worker operates in isolation. Clean parallel development, no merge conflicts. | |
| 35 | +| **Team Sync** | Share learnings across your organization. Team-wide memory that benefits everyone. | |
200 | 36 |
|
201 | | -Opt out: `cas config telemetry.enabled false` |
| 37 | +## Links |
202 | 38 |
|
203 | | -See [Privacy Policy](docs/PRIVACY.md) for details. |
| 39 | +- [Documentation](https://cas.dev/docs) |
| 40 | +- [How It Works](https://cas.dev/how-it-works) |
| 41 | +- [Blog](https://cas.dev/blog) |
204 | 42 |
|
205 | | -## License |
| 43 | +--- |
206 | 44 |
|
207 | | -Proprietary — All rights reserved. |
| 45 | +Built with Rust. Runs locally. Your code stays private. |
0 commit comments