Interactive terminal¶
Launching¶
Starts a local server and per-project database. Connect to an existing server:
See TUI options.
The layout¶
| Area | Contents |
|---|---|
| Transcript | Messages, tools and execution progress |
| Input | Next request, autocomplete and reasoning level |
| Status | Model, profile, endpoint and activity |
Talking to the agent¶
| Input | Action |
|---|---|
Enter |
Submit; queue if the current turn is running |
Shift+Enter |
Insert a newline on supported terminals |
Up / Down |
Navigate queued messages and input history |
Referencing files¶
Type @, filter the file list and press Tab to accept a path.
Running a shell command yourself¶
The ! prefix dispatches a command directly without a model call.
Slash commands¶
| Group | Commands |
|---|---|
| Sessions | /new, /sessions, /clear, /fork, /delete |
| Context and export | /compact, /share, /dump |
| Model and behavior | /model, /profile, /reasoning |
| Interface | /config, /theme, /vim, /help |
| Distributed work | /swarm |
Type / to browse the complete command menu.
/model opens a provider/model picker; /reasoning opens the effort picker.
Approving actions¶
| Key | Action |
|---|---|
a |
Allow once |
r |
Toggle remembering |
d / Esc |
Deny |
An approval prompt takes keyboard focus. See Permissions.
Answering the agent's questions¶
Tab switches questions, arrows select options, and Enter selects or submits.
Use the Other field for a custom answer.
Background jobs¶
| Key | Action |
|---|---|
Ctrl+B |
Background the current supported tool; Bash supports mid-run detachment |
Ctrl+J |
Open Bash jobs; inspect or stop a selected command |
Ctrl+W |
Open agents picker; press Enter to inspect a worker |
Alt+Left |
Return one drill-in level without cancelling the worker |
Alt+S |
Open the global sessions list |
The agents picker opens even for one worker. Jobs and agents use separate pickers. Live Bash output shows a bounded preview; the final result retains full output.
Forking a conversation¶
/fork opens a message cursor. Select a message and press Enter to create
a branch containing history through that point.
Reviewing the raw log¶
Ctrl+O toggles the full-log overlay.
Editing like vim¶
/vim toggles modal input editing. Esc returns to Normal mode; :w
submits the input. See Keyboard shortcuts.
Themes and notifications¶
Use /theme dark or /theme light. /config edits theme, providers and
notification preferences. Ctrl+S saves configuration changes.
Exiting¶
Press Ctrl+C twice within two seconds. The first press clears non-empty
input before arming exit confirmation.