Repository navigation
Releases
v5.2.0 — Superpowers + PACEflow Integration
v5.2.0 — Superpowers + PACEflow Integration
Upstream: Superpowers → MACS
macs import-plan <file>parses Superpowers plan files and batch-creates tasks- Auto-infers priority, tags, and chains sequential dependencies
Downstream: MACS → PACEflow
adapters/paceflow/with 3 Claude Code hooksmacs install-hooks --mode pacefor one-command setup- Blocks writes without plan.md, blocks session end without checkpoint
Full stack
Superpowers (plan) → macs import-plan → MACS (coordinate) → PACEflow hooks (quality)
v5.1.0 — Easy Mode
v5.1.0 — Easy Mode
New
macs add <title>— alias formacs createmacs start(no args) — auto-claims the first available taskmacs helpshows a 5-command quickstart by defaultmacs help --proshows all 27 commands
v5.0.0 — Distributed Ready
What's New in v5.0.0
Distributed Ready
- HTTP Transport API — REST + SSE server (port 7474) so cloud agents, CI runners, and containers can participate without filesystem access
- Per-agent event sharding —
events_sharding: truesplits writes toprotocol/events/{agent-id}.jsonl, eliminating the single-file bottleneck for 50+ concurrent agents - StorageBackend abstraction — swap the default filesystem for Redis, HTTP, or custom storage
Protocol Formalization (Spec v5.0)
- Formal spec in
MACS-SPEC.md: event schema, state rebuild algorithm, agent lifecycle, conformance requirements spec_versionon every event — readers handle unknown versions gracefullyinstance_id/session_idon agents — stable logical identity separate from per-launch ID
New CLI Commands
macs review, macs escalate, macs reap, macs smart-drift, macs workload, macs decompose, macs checkpoint
Adapters
Cursor, Aider, OpenClaw, Ollama, MCP bridge (14 tools), plugin system, GitHub Actions templates
Install
```bash
npm install -g macs-protocol
```
Quick Start
```bash
macs init "My Project"
macs swarm --agents "lead:architect|eng1:backend|eng2:frontend|qa:testing" --simulate
```
See README and MACS-SPEC.md for full documentation.
MACS Protocol v3.1 — Capability Routing, Review Chain, Escalation, Dead Agent Reaping
What's New in v3.1
3.1 Capability Routing
Tasks can now declare requires_capabilities. Only agents with matching capabilities can claim them. Auto-claim and swarm simulation are both capability-aware.
```bash
macs create "Train embedding model" --requires ml,gpu
macs boot --agent ml-agent --capabilities ml,gpu
```
3.10 Review Chain
Agents can request peer review before marking a task done.
```bash
macs review T-009 --agent lead-opus --result approved
macs review T-009 --agent lead-opus --result rejected --note "Missing error handling"
```
3.11 Escalation Protocol
When a task hits a human decision bottleneck, escalate it. Optionally auto-resume after a timeout.
```bash
macs escalate T-012 --reason "GDPR compliance sign-off" --to cto --timeout 60
```
3.12 Dead Agent Reaping
Agents that miss heartbeats are automatically marked dead and their tasks reassigned to pending.
```bash
macs reap --threshold 45 # agents silent > 45 min → dead, tasks → pending
```
Also Included
- OpenClaw adapter (
adapters/openclaw/) - 12-task SaaS demo (
demo/setup.sh+demo/run.sh) - 111 integration tests (0 failed)
- Forced handoff, task decomposition, drift detection, swarm orchestration
Install
```bash
npm install -g macs-protocol
macs init "My Project"
macs swarm --agents "lead:architect|eng1:backend|eng2:frontend|qa:testing" --simulate
```
MACS Protocol v3.0.0-alpha.1 — Git for AI Agents
MACS Protocol v3.0.0-alpha.1
Git for AI Agents — 多 Agent 工作协调层
核心架构:JSONL Event Sourcing
.macs/
├── protocol/
│ ├── tasks.jsonl # 任务生命周期(append-only,天然无冲突)
│ ├── events.jsonl # 全局事件流
│ └── state.json # 当前状态快照(自动重建)
└── sync/inbox/ # Agent 间收件箱
新特性
macs boot --agent <id>— 单命令会话启动,catch-up + 推荐下一步- Event Sourcing 核心 — 47 项集成测试全部通过
- 完整 CLI — init / boot / create / claim / start / done / block / impact / inbox
- TypeScript SDK + Python SDK — LangChain / CrewAI 集成
- Adapters — Aider / Ollama / Cursor / Python
快速开始
npx macs-protocol init
macs boot --agent my-agent --capabilities backend,testing定位
工作协调层(不做通信层)。A2A/MCP/AgentCP = 通信层,MACS = 工作层,互补不竞争。