TUI terminal interface

TUI is Cocode's terminal client for keyboard-driven work, SSH, remote servers, and machines without a full desktop environment. It requires a real TTY.

Start TUI

Install Node.js 22.19.x or newer, then:

npm install --global @cocode-agency/tui
cocode doctor
cd your-project
cocode tui

The terminal flow

1. Enter a task goal.
2. Review the plan and current state.
3. Move between task, output, and approval areas with the keyboard.
4. Approve or reject file, command, and network actions.
5. Review diffs, tests, and the final result.

Common commands include /login, /logout, /use byok, /use cocode, /status, /resume, /rewind, /review, /export, /focus, and /help. /review is read-only Git review; it does not modify, stage, or commit files.

Shift+Tab changes permission mode, Ctrl+M changes input/multiline mode, and Ctrl+O controls output folding. In an approval panel: Enter or a allows once, t allows for the turn, and d or n denies. See the CLI and shortcuts reference; runtime capabilities remain authoritative.

Login and model channels

TUI supports device-code login to Cocode and BYOK through /use byok. Use /status to confirm the current channel, model, and runtime state. Credentials must not be written to public docs or session logs.

GUI differences

Tasks, sessions, models, and permission rules are shared conceptually with GUI, but the presentation and controls differ. GUI is panel-oriented; TUI is terminal- and keyboard-oriented. Sharing local sessions still requires the same DSH_HOME, profile, and Host scope.