hive tui
The interactive dashboard. It’s a two-pane terminal UI over hive status: a
left pane of your registered projects and a right pane of their tasks, each
showing an icon, id, name, stage, status, and age. It refreshes once a second
and lets you drive any workflow verb with a single keystroke. This is the
recommended way to watch and steer Hive day to day.
Usage
hive tui
The TUI is human-only — it needs a real terminal and does not accept --json.
For machine-readable output, use
hive status --json instead.
Layout
- Left pane: registered projects, with a
★ All projectsentry on top. - Right pane: tasks for the selected scope, grouped by status, with a status icon and humanized age.
On terminals narrower than 70 columns the project pane is hidden and tasks take the full width.
Key bindings
| Key | Action |
|---|---|
Tab / Shift+Tab |
Toggle focus between the two panes. |
j / k (or arrows) |
Move the cursor within the focused pane. |
1–9 |
Scope the right pane to the Nth project; 0 returns to all projects. |
Enter |
Contextual action on the selected task (edit waiting input, tail a running agent’s log, open a red-status detail, or run the suggested command). |
b p d r P F a |
Run brainstorm / plan / develop / review / open-pr / finalize / archive on the selected task. |
n |
Capture a new idea (with an image-paste composer). |
i |
Open a read-only info panel for the selected task. |
o |
Open the task’s folder in your editor for read-only browsing. |
s |
Manually steer a task — open it in the dev agent inside its worktree. |
z |
Open the archive pane (all done tasks, no age cutoff). |
X |
Drop the selected task (kills its agent, removes folders, worktree, branch — no undo). |
/ |
Filter tasks by id, slug, or name. |
? |
Help overlay. |
q / Esc |
Quit, or back out of a sub-mode. |
How it behaves
- Workflow verbs run in the background, so multiple agents across multiple projects run concurrently while the dashboard keeps painting.
- Pressing a verb key on a task whose agent is still running flashes a hint instead of dispatching, so you don’t collide with a live run.
- Red (error / recovery) rows open a detail view that explains what went wrong and offers Hive’s automatic recovery before you have to intervene.
- Done tasks older than three days are hidden from the grid; press
zto see the full archive.
Examples
# Open the dashboard
hive tui