Skip to content

Releases

v5.2.0 — Superpowers + PACEflow Integration

Choose a tag to compare

@Vdc-K Vdc-K released this 13 Mar 12:48

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 hooks
  • macs install-hooks --mode pace for 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

Choose a tag to compare

@Vdc-K Vdc-K released this 13 Mar 08:00

v5.1.0 — Easy Mode

New

  • macs add <title> — alias for macs create
  • macs start (no args) — auto-claims the first available task
  • macs help shows a 5-command quickstart by default
  • macs help --pro shows all 27 commands

v5.0.0 — Distributed Ready

Choose a tag to compare

@Vdc-K Vdc-K released this 12 Mar 19:55

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: true splits writes to protocol/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_version on every event — readers handle unknown versions gracefully
  • instance_id / session_id on 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

Choose a tag to compare

@Vdc-K Vdc-K released this 05 Mar 04:29

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

Choose a tag to compare

@Vdc-K Vdc-K released this 02 Mar 14:11

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 = 工作层,互补不竞争。