Summary

Agent Flow visualizes Claude Code agent orchestration in real-time, making agent thinking, branching, and coordination visible. It aids developers in debugging, performance analysis, and understanding AI agent behavior for better prompt engineering.

How It Works

Agent Flow renders agent execution as an interactive node graph, achieving zero-latency streaming via lightweight HTTP hooks from Claude Code sessions. This makes the internal decision-making, tool usage, and coordination flows visible, transforming opaque execution into an understandable journey crucial for identifying bottlenecks.

Quick Start & Requirements

Agent Flow is a VS Code extension. Install via Command Palette: Agent Flow: Open Agent Flow. For live visualization, an active Claude Code session is required; Agent Flow auto-detects and connects, configuring hooks. Alternatively, use the agentVisualizer.eventLogPath setting to visualize JSONL event logs. Requires VS Code 1.85+ and Claude Code CLI for auto-detection.

Highlighted Details

• Live agent visualization: Interactive node graph with real-time tool calls, branching, and return flows.
• Automatic session detection: Seamlessly discovers active Claude Code sessions in VS Code.
• Zero-latency streaming: Lightweight HTTP hooks for immediate event forwarding.
• Multi-session management: Tracks concurrent agent sessions via tabs.
• Interactive canvas: Pan, zoom, click to inspect agents and tool calls.
• Execution analysis: Timeline, transcript panels, file attention heatmap.
• JSONL log replay: Load and visualize agent activity from .jsonl files.

Maintenance & Community

Created by Simon Patole for CraftMyGame. No specific community channels or roadmap links are detailed.

Licensing & Compatibility

Licensed under Apache 2.0, generally permitting commercial use. Project name and logos are trademarks of Simon Patole, with usage guidelines in TRADEMARK.md.

Limitations & Caveats

Primarily a VS Code extension, relying on the Claude Code CLI for live session visualization. Standalone usage or compatibility with other IDEs is not indicated.