Skip to content

Terminal UI ​

The Logician TUI is designed for real terminal environments — SSH sessions, tmux, and local terminals. Its layout adapts to narrow terminals while keeping the transcript, composer, and current execution state visible.

Layout ​

text
◆ LOGICIAN

  RESPONSE
  I found the failing boundary and updated the parser.

  COMMAND  bun test packages/log-core
  OUTPUT   42 pass, 0 fail

  COMPOSER             / Enter commands · @ files · Enter send · Ctrl+E steer
  › Ask Logician…
  ──────────────────────────────────────────────────────────────────────────────
  ● READY │ model │ cwd │ branch │ thinking mode

The main transcript is scrollable. Tool activity is rendered as compact cards that can be focused and expanded, while longer-lived workflows can open a work surface or fullscreen overlay without replacing the conversation. An empty session shows project-aware starting actions; typing / opens the searchable command palette, @ starts file mention completion, and internal resource URLs (skill://, memory://, local://, log://, ssh://) get inline completion as you type the token before the cursor.

Keybindings ​

KeyAction
EnterSubmit instruction
Ctrl+EImmediately steer the active turn with the composer text
Esc, EscClear the composer, then safely interrupt the active turn and restore its prompt
Ctrl+CImmediately request interruption
Ctrl+OExpand or collapse all tool results
Alt+J / Alt+KFocus the next or previous tool result
Alt+EnterExpand or collapse the focused tool result
Ctrl+LOpen the model selector
Ctrl+SOpen the session manager
Ctrl+KCycle sandbox mode
Ctrl+PToggle plan/act permission mode
Ctrl+IToggle autonomous/minimal execution policy (enhanced keyboard protocol)
Ctrl+M / Alt+MOpen the inference-mode selector
Ctrl+GJump to a file in the current working set
Ctrl+Shift+TCycle the thinking display mode
Ctrl+AOpen the autoresearch dashboard
/Open command palette
/helpShow the live command reference

Terminal compatibility ​

Works with any VT100-compatible terminal:

  • xterm, gnome-terminal, konsole, alacritty, kitty
  • SSH sessions (local or remote)
  • tmux and screen
  • Windows Terminal

Input modes ​

  • Normal — type instructions naturally
  • Steering — press Ctrl+E during a turn to interrupt and steer now
  • Paste — pasted text is processed as a single instruction
  • Bash ($ prefix) — input bar highlights in bash mode color
  • Python ($ with Python prompt) — input bar highlights in Python mode color

The input bar uses theme-aware color caching: mode colors, placeholder text, and clipping indicators are re-rendered only when the theme or width changes, reducing flicker during rapid typing.

Streaming output ​

Provider output and tool progress stream in real time:

  • Thinking content appears when the provider exposes it and thinking is enabled
  • Tool calls show before execution
  • Results display immediately after completion
  • Tool cards remain compact by default and can be focused or expanded with the keybindings above

MIT License