# dashboard

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

```bash
workmux dashboard
```

## 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

```bash
# 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](/guide/dashboard/) for keybindings and detailed documentation.