TUI Dashboard
Keyboard-driven terminal interface for managing agents.
Layout
The TUI has 6 tabs accessible via number keys 1–6:
- Sessions — manage agent sessions
- Agents — create, edit, copy, delete agent definitions
- Tools — browse and manage tools available to agents
- Flows — view flow definitions
- History — browse and import Claude Code sessions
- Compute — manage compute resources
Each tab has a split pane: left (list) and right (detail). Press Tab to switch focus between panes.
Global Shortcuts
These shortcuts work from any tab.
| Key | Action |
|---|---|
| 1–6 | Switch to tab |
| Tab | Toggle pane focus (list / detail) |
| Esc | Back to list pane |
| e | Toggle event log |
| q | Quit |
| p | Screenshot / copy |
| Ctrl+B d | Detach from tmux session (local and remote) |
Navigation
These keys work in all list panes.
| Key | Action |
|---|---|
| j / k | Move down / up |
| f / b | Page down / page up |
| g | Jump to top |
| G | Jump to bottom |
Sessions Tab (1)
This is the main tab. The left pane shows sessions grouped by group name. The right pane shows session details, token usage, channel status, conversation history, live agent output, and events.
Session Actions
Available actions depend on the current session status.
| Key | Action | Status |
|---|---|---|
| n | New session | Any |
| T | Threads (multi-session chat view) | Any |
| o | Groups | Any |
| c | Fork session (shallow copy, same config, fresh start) | Any |
| C | Clone session (deep copy with conversation resume) | Any |
| m | Move to group | Any |
| x | Delete session | Any |
| Enter | Dispatch session | Ready / Blocked |
| a | Attach to tmux | Running |
| t | Talk (1:1 chat with selected session) | Running |
| s | Stop session | Running |
| d | Mark done (press twice) | Running |
| Enter | Restart session | Stopped / Failed / Completed |
| S | Stop group | Group |
| R | Resume group | Group |
| X | Delete group | Group |
Detail Pane
The detail pane shows session metadata, token usage, channel status, and a live view of agent output. Press / to search within the conversation history. Use the scroll box to navigate long content.
Agents Tab (2)
Manage agent definitions across all three tiers (builtin, project, global).
| Key | Action |
|---|---|
| n | New agent |
| e | Edit agent |
| c | Copy agent |
| x | Delete agent |
Tools Tab (3)
Browse all tools available to agents in the current project. Tools are organized into 6 categories:
- MCP Servers — from
.mcp.json - Commands — from
.claude/commands/ - Claude Skills — from
.claude/skills/ - Ark Skills — from
skills/(builtin, global, project) - Recipes — from
recipes/(builtin, global, project) - Context — from
CLAUDE.md
| Key | Action |
|---|---|
| j / k | Navigate tools |
| Enter | View details / use recipe |
| x | Delete tool (with confirmation) |
History Tab (5)
Shows both Ark sessions and native Claude Code sessions from ~/.claude/projects/.
| Key | Action |
|---|---|
| Enter | Import a Claude session into Ark |
| s | Search across all transcripts |
| R | Full rebuild of session cache and search index |
Compute Tab (6)
Manage local, Docker, and EC2 compute resources.
| Key | Action |
|---|---|
| Enter | Provision a compute resource |
| n | Create new compute |
| s | Start / stop |
| a | SSH into running compute |
| x | Delete (with confirmation) |
Status Bar
The status bar at the bottom is the single source of truth for available actions. It shows context-sensitive shortcuts that update based on the active tab, pane, and overlay state. Shortcuts are organized with | separators: navigation | session actions | quit. When a form or overlay is open, the status bar switches to show form controls (Enter confirm, Esc cancel) instead of tab shortcuts.
Focus
When a form or overlay is open (new session, talk, move-to-group, etc.), it takes ownership of all keyboard input. App-level shortcuts like tab switching and navigation are blocked until the overlay is dismissed. The status bar updates to show only the controls relevant to the active overlay.
Tips
All I/O operations are async — the UI never freezes. A spinner in the status bar indicates background activity.
Sessions display live tmux output in the detail pane. Press a to attach directly to the tmux session for full terminal access.
Unread message counts appear as badges next to session names in the list pane. Press T to open threads and reply.
In chat (t) or threads (T), press Tab to switch focus between the message scroll area (j/k to navigate) and the text input.
Bare flow sessions use a manual gate — the agent can complete tasks but the session stays running until you press d (done) twice to mark it complete.
The detail pane uses a scroll box for long content. Switch focus with Tab, then use j/k to scroll.