Agent Flow banner
patoles patoles

Agent Flow

Git community

Description

Real-time visualization of Claude Code agent orchestration — see your agents think, branch, and coordinate as they work.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Agent Flow

Real-time visualization of Claude Code agent orchestration. Watch your agents think, branch, and coordinate as they work. [Demo video here](https://www.youtube.com/watch?v=Ud6eDrFN-TA).

![Agent Flow visualization](https://res.cloudinary.com/dxlvclh9c/image/upload/v1773924941/screenshot_e7yox3.png)

Why Agent Flow?

I built Agent Flow while developing [CraftMyGame](https://craftmygame.com), a game creation platform driven by AI agents. Debugging agent behavior was painful, so we made it visual. Now we're sharing it.

Claude Code is powerful, but its execution is a black box — you see the final result, not the journey. Agent Flow makes the invisible visible:

  • Understand agent behavior — See how Claude breaks down problems, which tools it reaches for, and how subagents coordinate
  • Debug tool call chains — When something goes wrong, trace the exact sequence of decisions and tool calls that led there
  • See where time is spent — Identify slow tool calls, unnecessary branching, or redundant work at a glance
  • Learn by watching — Build intuition for how to write better prompts by observing how Claude interprets and executes them

Features

  • Live agent visualization: Watch agent execution as an interactive node graph with real-time tool calls, branching, and return flows
  • Auto-detect Claude Code sessions: Automatically discovers active Claude Code sessions in your workspace and streams events
  • Claude Code hooks: Lightweight HTTP hook server receives events directly from Claude Code for zero-latency streaming
  • Multi-session support: Track multiple concurrent agent sessions with tabs
  • Interactive canvas: Pan, zoom, click agents and tool calls to inspect details
  • Timeline & transcript panels: Review the full execution timeline, file attention heatmap, and message transcript
  • JSONL log file support: Point at any JSONL event log to replay or watch agent activity

Getting Started

Quick Start (no VS