Skip to content

Dashboard

The interactive dashboard is the central hub for managing workstreams.

bash
ws switch

Layout

The dashboard displays workstreams as compact cards:

  ✓ add-tests
    Add unit tests for all API routes
    +142 −3  ·  3 files  ·  2 min ago: test: add route coverage

  ⠋ dark-mode
    Implement dark mode toggle
    running...

  ○ fix-types
    Fix all TypeScript type errors
    ready

Each card shows:

  • Line 1: Status icon + workstream name
  • Line 2: Prompt (dimmed)
  • Line 3: Diff stats, commit info, comments count, resume status

Status Icons

IconStatusMeaning
successAgent completed
failedAgent errored
runningAgent working (animated)
queuedScheduled to run
readyHas prompt, not run yet
workspaceManual workspace, no prompt
KeyAction
j / Select next workstream
k / Select previous workstream
gJump to first
GJump to last
EnterOpen action picker
/Search workstreams
?Toggle help overlay
q / EscQuit

Action Picker

Press Enter on a workstream to see context-sensitive actions:

Before first run:

  • Open in editor
  • Set/Edit prompt
  • Run agent

After successful run:

  • Open in editor
  • Open session (interactive terminal)
  • Set continuation prompt
  • View diff & review
  • View logs

If changes exist:

Press / to enter search mode. Type to filter workstreams — matching uses multi-term AND logic:

  • auth pass — finds workstreams matching both "auth" AND "pass"
  • Search checks names, prompts, and status

Press Enter to confirm the filter, Esc to clear.

Direct Editor Access

Skip the dashboard and jump straight to a workstream in your editor:

bash
ws switch auth-feature              # Open in default editor
ws switch auth -e cursor            # Open in Cursor
ws switch auth --no-editor          # Just print the worktree path

Supported editors: VS Code (code), Cursor, Zed, Windsurf, WebStorm. Your choice is remembered for future sessions.

Built with VitePress