Docs navigation

TracesHub documentation

Everything about using the TracesHub application — the hosted home for agent-trace, where your repo's AI authorship becomes browsable and shareable.

TracesHub is the hosted application for agent-trace: think “GitHub for agent-trace”. The open-source CLI records — locally, on your machine — which model and coding tool wrote every AI-written line of your repos, plus the prompt and session transcript behind it. TracesHub is where that record gets a hosted home: push your traces and get repo-wide analytics, per-line file blame, and the conversation behind every AI-written line — for you, your team, and your coding agents.

This documentation covers the application: signing in, connecting GitHub, projects, tokens, pushing, browsing, sharing, and administering your data. The CLI has its own complete manual — the agent-trace CLI documentation — covering every command, flag, and configuration path. These pages link into it wherever the CLI side of a workflow comes up.

The division of labor

PieceWhat it doesWhere it’s documented
agent-trace CLIRecords traces locally as you code with Cursor, Claude Code, or Codex CLI; builds the deterministic per-line attribution ledger at commit time; pushes to a remote when you say so.CLI documentation
TracesHub (this application)The hosted remote plus the collaboration layer: GitHub sign-in, projects, access control, tokens, analytics, per-line file blame, conversations, sharing, export.These pages

Where to go

  • New here? Follow the quick start — from installing the CLI to browsing your first push, in about five minutes.
  • Want the mental model? How TracesHub works explains orgs, projects, the trace store, and what actually moves over the wire.
  • Setting up a repo? Connecting GitHubProjectsPushing traces.
  • Bringing your team? Teams & access covers roles, collaborators, and invitations.
  • Running it responsibly? Data & privacy covers what’s stored, what you control, export, and deletion.

Open source at the core

The two components under the hosted product are standalone open source, and you can self-host them:

  • agent-trace-cli — the tracer: hooks, the attribution ledger, blame, git notes, and the local file viewer.
  • agent-trace-service — the remote: a pure HTTP datastore for push / pull / sync.

The hosted application at app.traceshub.com adds the things a team wants on top: GitHub-linked identity and orgs, scoped tokens, a browsable web view, sharing, and administration.