Claude Code · dynamic workflows

claude-workflow-viz

A zero-dependency CLI that brings a finished (or running) Claude Code dynamic workflow back to life — a fan-out → barrier → reduce DAG, a gantt timeline, live concurrency, and a self-contained interactive HTML report.

▶  Open the live demo View on GitHub →
no install required to try the demo · the report is one offline HTML file
$ npx github:democra-ai/claude-workflow-viz show latest

  research-claude-dynamic-workflows
  ✔ completed  ·  wf_c7a66bf4-7c6  ·  opus-4-8

  6 agents   85 tool calls   308,221 tokens   6.0 min   peak ×5/16

  ▸ Fanning out 5 web-research agents…
  ▸ Collected 67 sourced findings across 5/5 angles.

  Phase 1 · Search              ██████████████████████████████······· 4.7 min  ⑃ 5-wide
     search:official-docs      ██████████████████████████████·······  4.7 min
     search:release-notes      ████████·······················   76.9 s
     search:how-it-works       ████████████████████·············  3.1 min
     search:community-examples ████████████████████·············  3.2 min
     search:comparison         ███████████████··················  2.4 min
                                ║ barrier — next phase waits for all ║

  Phase 2 · Synthesize          ·························████████ 76.7 s
     synthesize                ·························████████   76.7 s

  timeline                      0:00 ├───────────────────────────────┤ 6:01

   returns { synthesis, angleSummaries, totalFindings }
🧬

The DAG, recovered

Fan-out, barriers, and the reduce step — inferred from real agent timings, not guessed.

📊

Gantt + concurrency

Every agent placed by its real start/end, with a live concurrency curve against the 16-agent cap.

Replay any run

Scrub the run from 0 to done; agents light up exactly when they ran. Deterministic, like the run's own journal.

📄

One offline file

Export a self-contained HTML report — no servers, no CDNs. Safe to email, commit, or open from disk.

🛰

Live watch

Follow a workflow in your terminal as it runs; it redraws until the run finishes.

🔌

Zero runtime deps

Pure Node + TypeScript. Reads local files only — nothing leaves your machine.

Get started

# best: install the plugin — a live view opens automatically when a workflow starts /plugin marketplace add democra-ai/claude-workflow-viz /plugin install claude-workflow-viz@democra-ai # or drive it from the CLI # list your recent workflow runs npx github:democra-ai/claude-workflow-viz list # render the latest run, or export an interactive report npx github:democra-ai/claude-workflow-viz show latest npx github:democra-ai/claude-workflow-viz export latest -o run.html --open
  1. Run a dynamic workflow in Claude Code (the workflow keyword, or /effort ultracode).
  2. Point wfviz at it — show in the terminal, or export a report like the one above.
  3. Requires Node ≥ 18. Reads ~/.claude/projects (override with CLAUDE_CONFIG_DIR).

Dynamic workflows are a Claude Code research preview; the on-disk format may change and this reads it best-effort. Independent community project — not affiliated with or endorsed by Anthropic.