braid

AI-aware version control. Wraps Git, doesn't replace it.

Built for the era when agents commit 200 times an afternoon and git log --oneline | head -200 stops being a useful answer.

What braid gives you that git can't

• Session timelines — every agent edit is a persistent checkpoint, scrub backward across sessions
• Intent-level undo — braid undo --intent="add caching" reverses one conceptual change while keeping unrelated edits
• Semantic squash — N agent commits collapse into K logical commits at push time
• Behavior diff — what changed in observable behavior, not what changed in lines

Underneath, braid uses Git as storage and pushes ordinary Git commits. Your GitHub, your CI, your PR review flow — all unchanged.

Status

v0.0.1 — scaffolding only. Roadmap below.

Install

npm install -g braid

Quick start

cd your-repo
braid init
braid watch       # in another shell, while your agent runs
braid timeline    # see what the agent did
braid undo --intent="add rate limiting"
braid push        # squashes session into clean git commits

Roadmap

v0.1 — git wrapper layer

• [x] braid init
• [ ] braid watch
• [ ] braid timeline
• [ ] braid undo --intent
• [ ] braid push

v0.2 — semantic layer

• [ ] braid adiff — behavior-level diff
• [ ] gh pr integration

v0.3 — multi-agent

• [ ] edit locks
• [ ] LLM merge arbitration

License

MIT