Skip to main content
ironbee tui opens a full-screen interactive terminal UI, a single place to browse your projects, toggle platforms, edit config, and inspect sessions without remembering individual commands. It mirrors the CLI: anything you do in the TUI runs the same underlying logic as the matching command.
IronBee TUI home menu showing the Configuration, Platforms, Projects, Sessions, Queue, and Import areas with a help bar at the bottom

​
Launch

ironbee tui
This opens the home menu. You can also jump straight into a specific area: 
ironbee tui platforms
ironbee tui projects -p /path/to/project
Argument / flagDescription
[area]Open directly into an area: config, platforms, projects, sessions, queue, or import
-p <dir>Start with a specific project as the active one (default: current directory)
The TUI needs an interactive terminal. In a non-interactive context (CI, piped output) it exits with a hint to use the equivalent ironbee config commands instead.

​
Areas

AreaWhat you can do
ConfigurationBrowse and edit config keys across the global, project, and local layers; see the effective merged value and where it comes from
PlatformsToggle the browser, Node, Python, backend, Android, and terminal cycles per layer — or press s to have a detected client suggest the set and apply it
ProjectsInstall, uninstall, register, or unregister for the current directory or any project in your inventory; switch which project is active
SessionsBrowse sessions with their phase, verdict, and retry counts; run a read-only verdict check
ScenariosBrowse saved verification scenarios with their freshness (fresh / stale / unknown vs the current code). Read-only — repair is the agent’s /ironbee-sync-scenario
QueueInspect and drain the background job queue; manage dead-letter entries
ImportBackfill historical sessions with a live dry-run estimate before you commit
Installing from the Projects area runs the same flow as the CLI: a client picker when more than one is detected, then a mode single-select (enforce / assist / monitor — the equivalent of ironbee install --mode) and, unless you pick monitor, a platform multi-select (pre-checked from the project’s current config — the equivalent of ironbee install --platforms) to choose which cycles to enable, including the same s suggest key.
KeyAction
↑ / ↓ (or j / k)Move within a list
EnterSelect / open
EscBack to the home menu
q / Ctrl-CQuit
The breadcrumb at the top always shows the active project. In the Projects area you can switch which project is active, and every project-scoped area (Configuration, Platforms, Sessions, Queue) retargets to it, so you can launch in one repo and inspect or edit another without changing directories.

​
What’s next?

Configuration

The keys behind the Config area, in full.

Verification

The commands behind the Sessions area.