Trace

Production-ready multi-agent version control. Built for AI agents that collaborate on files without stepping on each other. Zero runtime dependencies.

What It Does

• Version control — commit, log, diff, checkout, branch, merge, stash, rebase, cherry-pick, tags
• File locking — agents lock files before editing, preventing collisions (5-min auto-expiry)
• Conflict resolution — 3-way merge with detection, visualization, and resolution strategies
• Workspace isolation — security rules block accidental credential/secret commits
• Task coordination — register tasks, detect dependencies, queue execution across agents
• Distributed sync — push/pull to remote repositories via git interop
• Terminal colors — colored CLI output, respects NO_COLOR / FORCE_COLOR

Install

npm install @zoebuildsai/trace

Quick Start

import { TraceCommands } from '@zoebuildsai/trace';

const trace = new TraceCommands('/path/to/storage');

// Commit
const hash = trace.commit('add user auth', 'agent-1');

// Log
const history = trace.log(10);

// Status
const status = trace.status();

CLI

trace init
trace commit -m "initial setup"
trace log
trace status
trace diff
trace branch feature/auth
trace checkout main
trace merge feature/auth
trace stash "WIP: auth flow"
trace stash pop
trace rebase main
trace tag create v1.0.0
trace audit
trace push origin
trace pull origin

Multi-Agent Coordination

import { AgentCoordination } from '@zoebuildsai/trace';

const coord = new AgentCoordination();

// Register tasks
const task = coord.registerTask('agent-1', ['src/api.ts'], 10);

if (task.canStart) {
  // Do work...
  coord.completeTask(task.taskId);
}

Workspace Security

import { WorkspaceIsolation } from '@zoebuildsai/trace';

const isolation = new WorkspaceIsolation('/project', true);
const check = isolation.isSafeToCommit('.env');
// { safe: false, violations: [{ reason: 'Matches blocked pattern', severity: 'critical' }] }

API

Full API covers: TraceCommands, TraceCLI, TraceSync, AgentCoordination, WorkspaceIsolation, LockManager, MergeEngine, Stash, Rebase, CherryPick, StageArea, TagManager, SemanticGrouping, DiffFormatter, CompressionEngine, PerformanceMonitoring, AutoCommitter, and more.

Tests

npm test           # Run all 1067 tests
npm run build      # TypeScript build

License

Proprietary. © Zoë (zoebuildsai.com)