Skip to content
workmux branch logoworkmux branch logoworkmux

dashboard

Copy page

Opens a TUI dashboard showing all active AI agents across all tmux sessions.

Terminal window
workmux dashboard

Options

Section titled “Options”
  • -d, --diff: Open the diff view directly for the current worktree’s agent.
  • -P, --preview-size <10-90>: Set preview pane size as percentage (larger = more preview, less table). Default: 60.
  • -s, --session: Filter to only show agents in the current session.
  • -t, --tab <agents|worktrees>: Open directly on the specified tab.

Examples

Section titled “Examples”
Terminal window
# Open dashboard with default layout
workmux dashboard


# Open with smaller preview pane (40% of height)
workmux dashboard --preview-size 40


# Open diff view directly for current worktree
workmux dashboard --diff


# Show only agents in the current tmux session
workmux dashboard --session


# Open directly on the Worktrees tab
workmux dashboard --tab worktrees

See the Dashboard guide for keybindings and detailed documentation.