# Traces Documentation Share, discover, and collaborate on AI coding agent traces. URL: https://traces.com/docs See full content at: https://traces.com/docs.mdx --- # Traces MCP Connect your AI coding agent to Traces to search sessions and manage surfaces. URL: https://traces.com/docs/mcp See full content at: https://traces.com/docs/mcp.mdx --- # Overview Publish and read Traces data with a namespace-scoped API key. URL: https://traces.com/docs/api-reference See full content at: https://traces.com/docs/api-reference.mdx --- # CLI Discovery Browse traces from your repo's git history without manual imports. URL: https://traces.com/docs/cli/cli-discovery See full content at: https://traces.com/docs/cli/cli-discovery.mdx --- # Commands Complete reference for every user-facing Traces CLI command. URL: https://traces.com/docs/cli/commands See full content at: https://traces.com/docs/cli/commands.mdx --- # Search Traces Find local traces and inspect matching events from the CLI. URL: https://traces.com/docs/cli/search See full content at: https://traces.com/docs/cli/search.mdx --- # Supported Agents Agent compatibility matrix for the Traces CLI adapters. URL: https://traces.com/docs/cli/supported-agents See full content at: https://traces.com/docs/cli/supported-agents.mdx --- # Troubleshooting Diagnose and fix common issues with the Traces CLI. URL: https://traces.com/docs/cli/troubleshooting See full content at: https://traces.com/docs/cli/troubleshooting.mdx --- # Authentication Log in to Traces via GitHub OAuth or API keys for programmatic access. URL: https://traces.com/docs/getting-started/authentication See full content at: https://traces.com/docs/getting-started/authentication.mdx --- # Getting Started Get up and running with Traces in under 2 minutes. URL: https://traces.com/docs/getting-started See full content at: https://traces.com/docs/getting-started.mdx --- # Installation Install the Traces CLI on macOS, Linux, or via npm. URL: https://traces.com/docs/getting-started/installation See full content at: https://traces.com/docs/getting-started/installation.mdx --- # Agents Attribute automated traces to non-human identities. URL: https://traces.com/docs/organizations/agents See full content at: https://traces.com/docs/organizations/agents.mdx --- # API Keys Use org API keys for automation, CI/CD, and scoped access. URL: https://traces.com/docs/organizations/api See full content at: https://traces.com/docs/organizations/api.mdx --- # Creating a Team Get started with Traces for teams. URL: https://traces.com/docs/organizations/creating-a-team See full content at: https://traces.com/docs/organizations/creating-a-team.mdx --- # Domain Auto-Join Let anyone with a verified email on your company domain join automatically. URL: https://traces.com/docs/organizations/domain-auto-join See full content at: https://traces.com/docs/organizations/domain-auto-join.mdx --- # Using Traces in Teams Manage team namespaces for shared traces, members, agents, and API keys. URL: https://traces.com/docs/organizations See full content at: https://traces.com/docs/organizations.mdx --- # Members Invite teammates, auto-approve a company email domain, manage roles, and remove access when needed. URL: https://traces.com/docs/organizations/members See full content at: https://traces.com/docs/organizations/members.mdx --- # Privacy Settings Restrict which trace visibility levels are allowed for your organization. URL: https://traces.com/docs/organizations/privacy See full content at: https://traces.com/docs/organizations/privacy.mdx --- # Sharing via Agent Hooks Automatically share agent sessions as an agent works. URL: https://traces.com/docs/sharing/agent-hooks See full content at: https://traces.com/docs/sharing/agent-hooks.mdx --- # Sharing via Agent Skills Set up agent sharing once, then share traces directly from your agent conversation. URL: https://traces.com/docs/sharing/agent-skills See full content at: https://traces.com/docs/sharing/agent-skills.mdx --- # Sharing via API Key Share traces from GitHub Actions, Docker, CI/CD pipelines, and other headless environments. URL: https://traces.com/docs/sharing/api-key See full content at: https://traces.com/docs/sharing/api-key.mdx --- # Sharing via CLI Use traces share to upload sessions with control over visibility, agent filtering, and output format. URL: https://traces.com/docs/sharing/cli See full content at: https://traces.com/docs/sharing/cli.mdx --- # Sharing via Git Hooks Attach traces to Git commits automatically. URL: https://traces.com/docs/sharing/git-hooks See full content at: https://traces.com/docs/sharing/git-hooks.mdx --- # Sharing Traces Share traces manually or automatically from the CLI, agent skills, git hooks, and API keys. URL: https://traces.com/docs/sharing See full content at: https://traces.com/docs/sharing.mdx --- # Adding Surfaces Browse the surfaces marketplace, preview a surface, and keep it open on every trace. URL: https://traces.com/docs/surfaces/adding-surfaces See full content at: https://traces.com/docs/surfaces/adding-surfaces.mdx --- # Creating Surfaces Build a surface with your coding agent, or upload an HTML file from the web app. URL: https://traces.com/docs/surfaces/creating-surfaces See full content at: https://traces.com/docs/surfaces/creating-surfaces.mdx --- # Surfaces Custom views of a trace that open as tabs next to Highlights and Full Trace. URL: https://traces.com/docs/surfaces See full content at: https://traces.com/docs/surfaces.mdx --- # Managing Surfaces Edit a surface, upload new versions, change the current version, and choose who can use it. URL: https://traces.com/docs/surfaces/managing-surfaces See full content at: https://traces.com/docs/surfaces/managing-surfaces.mdx --- # Surfaces with MCP Create, update, preview, and release surfaces from your coding agent through Traces MCP. URL: https://traces.com/docs/surfaces/mcp See full content at: https://traces.com/docs/surfaces/mcp.mdx --- # Account and Profile Manage your personal account, profile settings, and identity details. URL: https://traces.com/docs/traces-web/account-profile See full content at: https://traces.com/docs/traces-web/account-profile.mdx --- # Billing Billing documentation for Traces Web. URL: https://traces.com/docs/traces-web/billing See full content at: https://traces.com/docs/traces-web/billing.mdx --- # Data Export Export all traces in a namespace as a ZIP of JSONL files, and optionally push to HuggingFace. URL: https://traces.com/docs/traces-web/exports See full content at: https://traces.com/docs/traces-web/exports.mdx --- # OpenRouter Capture OpenRouter conversations in your Traces organization. URL: https://traces.com/docs/traces-web/openrouter See full content at: https://traces.com/docs/traces-web/openrouter.mdx --- # Organizations Create and manage organizations in Traces Web. URL: https://traces.com/docs/traces-web/organizations See full content at: https://traces.com/docs/traces-web/organizations.mdx --- # Namespaces Read the namespace bound to an API key and its members. URL: https://traces.com/docs/api-reference/namespaces See full content at: https://traces.com/docs/api-reference/namespaces.mdx --- # Traces List, read, create, or synchronize trace metadata. URL: https://traces.com/docs/api-reference/traces See full content at: https://traces.com/docs/api-reference/traces.mdx --- # Messages Read or upload individual messages and message batches. URL: https://traces.com/docs/api-reference/messages See full content at: https://traces.com/docs/api-reference/messages.mdx