Skip to content
v1.5.4Now live:20+ CLI commands · Ed25519 signing · atomic file locking · selective rollback · stash · rebase · tags
Release notes →
Built for agents
Included with Pro

Version control
for multi-agent teams.

File locking, agent identity per commit, cliff detection, rollback by agent. Zero dependencies, sub-100ms on every op.

trace — bash
Get started

Up in three steps.

Install the CLI, drop in your SKILL.md, and start committing.

$ npm install -g @zoebuildsai/trace
01
Install
npm install -g @zoebuildsai/trace

Install the Trace CLI globally via npm.

02
Place SKILL.md
~/skills/trace/SKILL.md

Pro subscribers get the SKILL.md operational guide. Place it in your agent's skills directory.

03
Start committing
trace init && trace commit "first snapshot"

Initialize a repo and make your first commit. Done.

I built Trace because git breaks when dozens of agents try to commit simultaneously. Merge conflicts become merge chaos. Trace handles collision detection, tracks exactly which agent changed what, and lets you roll back everything a specific agent did with one command.

Why not Git?

Git was built for humans.

Git is great for humans. For agents, it becomes a liability. Here's what changes with Trace.

Feature
Git
Trace
Designed for agents
❌ Human-first
✅ Agent-first
File locking
❌ No native locking
✅ Built-in lock/unlock
Agent identity in commits
❌ Author = human
✅ Agent name in every commit
Concurrent agent commits
❌ Merge conflict chaos
✅ Collision detection built-in
Rollback by specific agent
❌ Manual cherry-pick nightmare
✅ trace rollback --agent name
Cliff detection
❌ None
✅ Warns on dangerous bulk changes
Semantic grouping
❌ Manual tagging
✅ Auto-categorize by commit type
Zero config init
✅ git init
✅ trace init
Remote sync
✅ Full git protocol
✅ Via git under the hood
Learning curve
❌ 20+ years of baggage
✅ Git-like syntax, zero config
Simple commands

Five letters. Full control.

No git baggage. No learning curve. Commands that make sense for agents and humans alike.

$ trace commit "updated knowledge graph"
$ trace log 5
$ trace status
$ trace checkout abc1234
$ trace branch feature/new-work
$ trace stash "work in progress"
$ trace lock config.json
$ trace rollback --agent agent-42
$ trace cliff
$ trace push origin
Built for agents

What makes Trace different.

Agent signing

Ed25519 cryptographic signatures on every save. Unbreakable audit trail of which agent changed what.

File locking

Multiple agents, zero conflicts. Lock before edit, auto-release on save. No merge chaos.

Rollback by agent

Undo everything a specific agent did across the entire repo. One command. Instant.

Sub-100ms everything

Zero dependencies. Save, log, diff, restore — all under 100 milliseconds.

Semantic grouping

Auto-categorize saves by type: feature, fix, refactor, docs. See patterns across your team.

Async operations

Batch saves without blocking your agent. Webhook callbacks when operations complete.

Multi-agent coordination

1000+ agents working in parallel. Distributed locking, heartbeat detection, workflow orchestration.

Cliff detection

Catch dangerous changes before they happen. Large deletions, unauthorized file access, anomaly alerts.

Built-in sync

Push and pull to any git remote. Uses git under the hood for transport. Your .trace/ history travels with your repo.

1067+
Tests passing
<100ms
All operations
41
Source modules
0
Dependencies
FAQ

Common questions.

Pricing

Included with your subscription.

The npm package is free. Pro ($29.99/mo) unlocks the SKILL.md operational guide, email support, and every product we build — Orbit included.

View plans & pricing

Ready to get started?

Read the full documentation to see every command, every module, every pattern. Then grab Trace and start building.