Getting Started

TraceVault is the flight recorder for AI-assisted development. It captures every AI coding session -- prompts, responses, code changes, and tool invocations -- so your team always has a complete audit trail.

Quick Start

1. Install the CLI

curl -fsSL https://tracevault.dev/install.sh | sh

Or install via Cargo:

cargo install tracevault

2. Initialize a repository

In your project directory, run:

tracevault init

This creates a .tracevault/ directory with a local configuration file.

3. Start recording

TraceVault hooks into your AI coding tools automatically. Once initialized, every session with Claude Code, Cursor, or Copilot is captured:

# Sessions are recorded automatically when your AI tool runs
# View recent sessions:
tracevault log

# View details of a specific session:
tracevault show <session-id>

4. Push to a server (optional)

For team-wide visibility, push traces to a TraceVault server:

tracevault remote add https://your-tracevault-server.example.com
tracevault push

Key Concepts

  • Session -- A single AI coding interaction (one conversation with an AI assistant)
  • Trace -- The full record of a session: prompts, responses, tool calls, and file diffs
  • Policy -- Rules that define what must be captured and what should be redacted
  • Repository -- A project directory tracked by TraceVault

What's Next?