← Back to Documentation

Claude Code Integration

Capture every Claude session and turn ephemeral terminal chats into institutional intelligence.

Overview

Claude Code is a powerful CLI for AI-assisted engineering. However, by default, its session history is siloed on your local machine. TraceFlow integrates with Claude Code to provide a unified timeline of your team's intent, stopping tangents before they scale.

How it Works

TraceFlow automatically watches the Claude Code session directory. Every time you start a new chat or run a command, TraceFlow:

  • Extracts Intent: Reconstructs the conversation thread from JSONL logs.
  • Maps Trajectories: Correlates your Claude session with active project goals.
  • Alerts on Tangents: Nudges you if the AI starts refactoring code outside your current focus.

Setup Instructions

1. Install the TraceFlow Agent

Run the one-liner from your dashboard to connect your machine.

curl -sSL https://traceflow.sh/install.sh | sh

2. Register Your Project

In your project root, initialize TraceFlow to track local AI sessions.

traceflow init --name "My Awesome Project"

3. Start Coding

Just use Claude Code as normal. TraceFlow will detect the new session files in ~/.claude/projects/ automatically.

The Result: Strategic Alignment

Once connected, your Claude sessions appear in the **TraceFlow Timeline**. You can see exactly which engineer is using Claude for what purpose, and our **Collision Engine** will warn you if Alice is refactoring the same middleware you're currently asking Claude to optimize.

Ready to stop flying blind?

Start Free Claude Alignment Trial