Install
cargo install tracevault-cli
Login
Authenticate to your TraceVault server:
tracevault login --server-url https://tracevault.example.com
This opens a device authorization flow — approve the request in your browser and the CLI stores the token locally.
Initialize in a Repository
cd /path/to/your/repo
tracevault init --server-url https://tracevault.example.com
This sets up everything automatically:
- Creates
.tracevault/ directory with local config - Installs Claude Code hooks (PreToolUse / PostToolUse) into
.claude/settings.json - Installs a git pre-push hook that runs
sync, check, and push - Registers the repository on the server
From this point on, every AI interaction is captured transparently. When you git push, traces are checked against policies and uploaded to the server — no manual steps required.