Gemini CLI Trajectories
Monitor intent and visualize workstreams from your Gemini CLI sessions.
Overview
Gemini CLI provides a high-velocity interface for Google's most advanced models. While it's great for individual tasks, the context often stays trapped in the terminal buffer. TraceFlow connects to your Gemini CLI history to map your actual coding trajectory against project goals.
How it Works
The TraceFlow Agent monitors the Gemini CLI history files (typically located in ~/.gemini/history/). Every interaction is parsed and streamed to your Hub for:
- Intent Extraction: We analyze the prompts to understand the "Why" behind the commands.
- Project Correlation: Automatically matching sessions to the correct project based on your current working directory.
- Convergence Mapping: Seeing how your Gemini work aligns with teammates using Claude or Codex.
Setup Instructions
1. Connect Your Machine
Ensure the TraceFlow Agent is installed and authorized.
2. Verify History Path
TraceFlow defaults to ~/.gemini/history/. If you use a custom path, you can configure it in your ~/.config/traceflow/config.yaml.
3. Watch the Timeline
Open your TraceFlow dashboard and navigate to the **Timeline** view. Your Gemini sessions will appear in orange, showing the exact moments of peak AI velocity.
Strategic Insights
By tracking Gemini CLI sessions, engineering leaders can see the "Delta" between a request and the result. This data is used to generate **Next-Action Intelligence**, predicting what your team should build next based on the lingering threads in your Gemini chats.