Workflow Visualizer

The workflow visualizer is an interactive view for project progress, execution history, dependencies, metrics, health, agent activity, changes, knowledge, memories, captures, and exports.

Opening the Visualizer

/gsd visualize

Or configure automatic display after milestone completion:

auto_visualize: true

Tabs

Switch tabs with Tab, Shift+Tab, or 1-9 and 0.

1. Progress

A tree view of milestones, slices, and tasks with completion status:

M001: User Management                        3/6 tasks ⏳
  ✅ S01: Auth module                         3/3 tasks
    ✅ T01: Core types
    ✅ T02: JWT middleware
    ✅ T03: Login flow
  ⏳ S02: User dashboard                      1/2 tasks
    ✅ T01: Layout component
    ⬜ T02: Profile page
  ⬜ S03: Admin panel                         0/1 tasks

Shows checkmarks for completed items, spinners for in-progress, and empty boxes for pending. Task counts and completion percentages are displayed at each level.

Discussion status is also shown when milestones have been through a discussion phase — indicates whether requirements were captured and what state the discussion left off in.

2. Timeline

Chronological execution history showing:

• Unit type and ID
• Start/end timestamps
• Duration
• Model used
• Token counts

3. Dependencies

An ASCII dependency graph showing slice relationships:

S01 ──→ S02 ──→ S04
  └───→ S03 ──↗

Visualizes the depends: field from the roadmap, making it easy to see which slices are blocked and which can proceed. Slice verification artifacts also surface data flow between completed slices.

4. Metrics

Bar charts showing cost and token usage breakdowns:

• By phase — research, planning, execution, completion, reassessment
• By slice — cost per slice with running totals
• By model — which models consumed the most budget
• By routing tier — light, standard, heavy, and downgraded unit counts

Uses data from .gsd/metrics.json.

5. Health

Budget pressure, token pressure, environment issues, provider checks, skill-health summary, progress score, and persisted doctor history.

6. Agent

Current agent activity, completion rate, session cost/tokens, pressure signals, pending captures, and recent completed units.

7. Changes

Completed slice summaries, modified files, verification decisions, and established patterns.

8. Knowledge

Persistent project rules, patterns, and lessons from .gsd/KNOWLEDGE.md, plus active memory-store entries ranked by confidence and usage. Memory rows show their ID, category, scope, confidence, hit count, tags, and truncated content.

9. Captures

Captured notes grouped by pending, triaged, and resolved state.

0. Export

Download Markdown, JSON, or a current-view snapshot from the visualizer data. Markdown and JSON exports include the same bounded active-memory feed that appears in the Knowledge tab.

Controls

Key	Action
Tab	Next tab
Shift+Tab	Previous tab
1-9, 0	Jump to tab
↑/↓	Scroll within tab
/	Search/filter
?	Show keyboard help
Escape / q	Close visualizer

Auto-Refresh

The visualizer refreshes data from disk every 2 seconds, so it stays current if opened alongside a running auto-mode session.

HTML Reports

For shareable reports outside the terminal, use /gsd report. This generates HTML reports for all milestones, opens the reports index in a browser, and uses the same data as the TUI visualizer — progress tree, dependency graph (SVG DAG), cost/token bar charts, execution timeline, changelog, knowledge base, and active memories. All CSS and JS are inlined — no external dependencies. Printable to PDF from any browser.

An auto-generated index.html shows all reports with progression metrics across milestones.

auto_report: true    # auto-generate after milestone completion (default)

Configuration

auto_visualize: true    # show visualizer after milestone completion