Skip to main content

bloom view

Visual DAG inspector for your task graph. Opens a browser-based interface to explore tasks, dependencies, and agent prompts without running agents.

Usage​

bloom view [options]

Options​

OptionDescription
--port <number>Port to run the server on (default: 3000)
--openOpen browser automatically (default: true)
--no-openDon't auto-open browser window
-f, --file <path>Use custom tasks file

Examples​

# Open on default port (3000)
bloom view

# Use custom port
bloom view --port 8080

# Don't auto-open browser
bloom view --no-open

# Use custom tasks file
bloom view -f project.yaml

When to Use​

Use bloom view after generating tasks and before running agents:

bloom generate    # Create tasks.yaml
bloom view        # Inspect the DAG visually
bloom run         # Execute with agents

This helps you:

  • Verify task structure — See the complete DAG layout before execution
  • Check dependencies — Ensure tasks are properly connected
  • Review phases — Confirm task grouping and ordering
  • Preview prompts — See exactly what agents will receive

Features​

Task Graph Visualization​

The view displays your tasks as a horizontal DAG (directed acyclic graph):

  • Nodes represent individual tasks
  • Edges show dependencies between tasks
  • Colors indicate task status:
    • Gray — todo
    • Blue — ready_for_agent
    • Purple — assigned
    • Amber — in_progress
    • Light Green — done_pending_merge
    • Bright Green — done
    • Red — blocked

Task Details Panel​

Click on any task to view:

  • Task ID and title
  • Current status and phase
  • Repository and branch information
  • Dependencies (upstream and downstream)
  • Full instructions and acceptance criteria

Prompt Preview​

Expand the "Prompts" section in the details panel to see:

  • System prompt — The context and guidelines agents receive
  • User prompt — The specific task instructions

This shows exactly what an agent will see when picking up the task, helping you verify instructions are clear and complete.

Live Updates​

The view automatically updates when tasks.yaml changes:

  • File watching enabled by default
  • Changes reflected in real-time via Server-Sent Events (SSE)
  • Connection status shown in the UI

Workflow Integration​

Before Running Agents​

# Generate tasks from plan
bloom generate

# Validate task configuration
bloom validate

# Visual inspection
bloom view

# Start execution
bloom run

During Development​

Keep the view open while editing tasks.yaml:

# Terminal 1: Open view
bloom view

# Terminal 2: Edit and save tasks.yaml
# Changes appear automatically in the browser

Debugging Task Issues​

When tasks aren't executing as expected:

  1. Open bloom view
  2. Check dependency chains — are tasks connected correctly?
  3. Look for blocked tasks (red nodes)
  4. Review prompts — are instructions clear?

Keyboard Shortcuts​

KeyAction
Click taskSelect and show details
ScrollPan the graph
ZoomMouse wheel or pinch