Truss Terminal UI
The terminal UI is a full-screen local workspace client. It uses the same configuration profiles, provider adapters, workspace memory, and tool policies as the CLI.
Install
npm install -g @truss-harness/tuiStart it
truss-tui
If a profile or local server can supply a model, the workspace starts with it. Otherwise, open the configuration view and select a detected server and model.
The model configuration view includes Internet research. Select that field with Tab and press Space to toggle bounded public web search and page fetching.
Workspace panes
| Pane | Purpose |
|---|---|
| Files | Browse a collapsible directory-first tree or fuzzy-search paths. |
| Editor | Read a syntax-highlighted file and toggle its Git diff. |
| Agent | Stream chat and approve or deny tool calls. |
| Terminal | View tool activity and run workspace shell commands. |
Keyboard controls
| Key | Action |
|---|---|
Tab / Shift+Tab | Move focus forward or backward between panes |
Ctrl+Left / Ctrl+Right | Move directly to the adjacent pane |
/ | Open fuzzy file search from the Files pane |
m | Open local model configuration outside chat input |
Enter | Send chat input or open the selected file |
Left / Right | Collapse or expand a selected directory |
d | Toggle Git diff in the editor pane |
| Type directly | Enter a command while the terminal pane has focus |
? | Open local workspace-command help |
Esc | Stop active generation |
Ctrl+C | Stop generation, or exit when idle |
Tool approvals use Y or Enter to allow and N or Escape to deny. The terminal pane accepts commands directly, runs them from the workspace root, and displays their output. It is a command runner rather than a fully emulated interactive PTY.
Workspace commands
Enter /init, /update [note], /status, /clear-memory, or /help in the Agent pane. They run locally rather than through the model. This is useful for creating AGENTS.md context and recording a handoff before a new conversation.
MCP servers
The TUI uses the CLI’s shared mcpServers configuration. Connection results appear in the Terminal pane when the runtime starts. Plan mode connects only to servers marked readOnly; Agent mode connects to every enabled server. See MCP Servers.