Visdom Trace CLI

The public CLI for Visdom Trace — AI code tracing and attribution. Installs the tracevault binary.

Crates

• tracevault-cli — the tracevault command-line tool (hooks, session capture, verification).
• visdom-ai-tracing-protocol — the wire-protocol types (stream + hook events) shared between the CLI and the Visdom Trace server. Published so both sides depend on one source of truth.

Install

brew install VirtusLab/visdom-ai-tracing/tracevault

or from crates.io:

cargo install tracevault-cli

GitHub Action

This repo ships a composite action that verifies commits in a PR or push have corresponding traces sealed on the server. It installs the CLI, detects the commit range from the event, runs tracevault verify --range, and writes a pass/fail summary to the Actions step summary.

- uses: actions/checkout@v4
  with:
    fetch-depth: 0   # the action verifies a commit range, so it needs full history
- uses: VirtusLab/visdom-ai-tracing-cli/action@main
  with:
    server-url: https://your-tracevault-server.example.com
    api-key: ${{ secrets.TRACEVAULT_API_KEY }}
    # version: v0.20.1   # optional; defaults to the latest release

License

Apache-2.0.