Skip to content

Commit 3772752

Browse files
committed
Update URLs to cas.dev and refresh README copy
- Change install script URL to cas.dev - Rewrite README with new homepage messaging - Update all documentation links to cas.dev
1 parent 21e0d34 commit 3772752

File tree

2 files changed

+27
-189
lines changed

2 files changed

+27
-189
lines changed

README.md

Lines changed: 26 additions & 188 deletions
Original file line numberDiff line numberDiff line change
@@ -1,207 +1,45 @@
1-
# CAS — Persistent Context for AI Agents
1+
# CAS — Run a Team of Claude Code Agents
22

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.
64

75
## Install
86

97
```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
539
```
5410

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:
7312

7413
```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
8016
```
8117

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
8619

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 |
9125

9226
## Features
9327

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. |
20036

201-
Opt out: `cas config telemetry.enabled false`
37+
## Links
20238

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)
20442

205-
## License
43+
---
20644

207-
Proprietary — All rights reserved.
45+
Built with Rust. Runs locally. Your code stays private.

install.sh

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
#!/usr/bin/env bash
22
# CAS Installation Script
3-
# Usage: curl -fsSL https://raw.githubusercontent.com/codingagentsystem/cas/master/install.sh | bash
3+
# Usage: curl -fsSL https://cas.dev/install.sh | bash
44
#
55
# Environment variables:
66
# CAS_VERSION - Specific version to install (default: latest)

0 commit comments

Comments
 (0)