Skip to content
agents-in-a-box

TUI screen tour

ainb is a terminal UI and CLI for managing AI coding sessions in isolated git worktrees and tmux sessions.

Launch the TUI with no arguments:

Terminal window
ainb            # launch the TUI (default when no command is given)
ainb init       # first-time setup and prerequisite check
ainb auth       # set up provider authentication

First launch runs an onboarding check for prerequisites (git, tmux, provider CLIs). Use ainb init --check to verify your environment headlessly.

Screen tour

From the home screen, single keys jump to each screen:

ScreenKeyDescription
SessionssList, attach, restart, and delete agent sessions
AgentsaSelect a provider or agent before spawning a session
RecoveryRFind and resume orphaned sessions or interrupted worktrees
StatsiUsage analytics: Daily, Weekly, Project, Burndown, Savings ([ / ] switch tabs)
DaemonsdRead-only Daemons overlay: shared MCP pool and Headroom proxy
SkillskBrowse and manage available skills
InboxICentral notification inbox for agent events
ConfigCView configuration options

Session controls

  • Code Review diff (g): Open the Warp-style Code Review diff for the selected session. Displays file tree, collapsible blocks, syntax highlighting, and word-level emphasis. Also available standalone as ainb diff-review.
  • Full-screen attach (a): Attach directly to the session tmux instance. Detach with Ctrl-b d to return to the TUI.
  • In-pane attach (A): Embed a live tmux client in-place inside the preview pane. Press Ctrl+Q to release keyboard focus back to the TUI.

Next steps