trace-claude-code
Automatically trace Claude Code conversations to Braintrust for observability.Captures sessions, conversation turns, and tool calls as hierarchical traces.
Security Assessment
Detected risks:
About trace-claude-code
The 'trace-claude-code' skill is designed to automate the tracing of Claude Code conversations to Braintrust, enhancing observability and visibility of AI coding sessions. By capturing session details, conversation turns, and tool calls, this skill provides a comprehensive and hierarchical trace of user interactions with the AI. It enables developers to monitor their workflow in real-time, ensuring better tracking and understanding of each session, including the inputs, outputs, and tool usage within the code generation process.
FAQ
How do I enable tracing for Claude Code?
You can enable tracing by running the setup script in your project directory, which will prompt you for your Braintrust API key and project name. This will configure all necessary hooks automatically.
What tools are required for setup?
You will need the Claude Code CLI, a Braintrust API key, and the 'jq' command-line tool installed on your machine.
Can I view the traces once enabled?
Yes, after running Claude Code with tracing enabled, you can view traces by logging into Braintrust, navigating to your project, and selecting the 'Logs' section to see all traced sessions.
What environment variables need to be set?
You must set the 'TRACE_TO_BRAINTRUST' variable to 'true', and provide your 'BRAINTRUST_API_KEY' and optionally the 'BRAINTRUST_CC_PROJECT'. Additionally, you can enable verbose logging with the 'BRAINTRUST_CC_DEBUG' variable.
Install trace-claude-code
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
parcadei/Continuous-Claude-v2