# Terminal Interface (TUI)

The TUI is Morphy's main interactive interface — a full chat experience in your terminal.
Launch it by running `morphy` with no task:

```bash
morphy
```

For running tasks non‑interactively from the shell (one‑shot, options, flags), see
[Using the CLI](cli.md).

## Layout

The screen has these areas:

- **Header** — active provider/model, tool count, MCP count
- **Message pane** — your messages, the assistant's replies, tool calls, results, and previews
- **Input bar** — a multiline prompt editor with slash‑command autocomplete
- **Status bar** — model, reasoning mode, permission/sandbox mode, budget/cost, context usage
- **Panels** — swarm/subagent activity, notifications, and dialogs appear as needed

Type a request and press `Enter`. Morphy plans the work and shows each tool call as it runs.
File edits are tracked — review them with `/diff` and revert with `/undo`.

## Sessions

- A session is created as soon as you enter the interface with an active provider.
- Conversations **autosave** to `~/.morphy/sessions` and survive restarts.
- Use `/new` to start fresh and `/load` to return to earlier work.

| What | Location |
| --- | --- |
| Sessions | `~/.morphy/sessions` |
| Settings | `~/.morphy/config/global.json` |
| Encrypted vault | `~/.morphy/secrets/vault.v1` |
| Model cache | `~/.morphy/cache/models` |

## Keyboard & mouse

### Editing

| Key | Action |
| --- | --- |
| `Enter` | Submit prompt |
| `Shift+Enter` / `Alt+Enter` / `Ctrl+J` | Insert a new line |
| `Left` / `Right` (or `Ctrl+B` / `Ctrl+F`) | Move the cursor |
| `Alt+Left` / `Alt+Right` | Move by word |
| `Ctrl+A` / `Ctrl+E` | Start / end of input |
| `Up` / `Down` | Input history (single‑line input) |
| `Tab` / `Shift+Tab` | Slash‑command autocomplete (forward / back) |

### Running & navigating

| Key | Action |
| --- | --- |
| `Ctrl+C` | Abort the current run (or quit if idle) |
| `Esc` `Esc` | Abort the current run |
| `PageUp` / `PageDown` / `Home` / `End` | Scroll the transcript |
| mouse wheel | Scroll the transcript and dialog lists |
| `Ctrl+N` | Open notifications |
| `Ctrl+T` | Toggle the sandbox |

## Slash commands

Type `/` in the input bar to see and autocomplete commands.

### Session & general

| Command | Purpose |
| --- | --- |
| `/help` | Show built‑in command help |
| `/new` | Start a fresh session |
| `/load [name]` | Load a saved session (or open the picker) |
| `/session list` · `/session rename <old> <new>` · `/session delete <name>` | Manage sessions |
| `/clear` | Clear the transcript and counters |
| `/context` | Summary of the current project context |
| `/cost` | Token / cost usage |
| `/compact` | Compact the conversation history |
| `/diff` · `/undo` | Show / revert tracked file changes |
| `/skills` | List installed skills |
| `/jobs` | Open the scheduler / jobs dialog |
| `/swarm [task]` | Start swarm mode |
| `/exit`, `/quit` | Leave |

### Provider & model

| Command | Purpose |
| --- | --- |
| `/providers` | Open the provider / account manager |
| `/provider list` | Show the active provider, account, model, endpoint |
| `/provider use <provider> [account]` | Switch active provider / account |
| `/model` | Open the searchable model picker |
| `/model <name>` | Set the model directly |

Full key/login workflow: [LLM Providers](providers.md).

### Reasoning, permissions, sandbox

| Command | Purpose |
| --- | --- |
| `/thinking off` · `/thinking on [budget]` · `/thinking adaptive [budget]` | Control reasoning |
| `/effort low\|medium\|high\|xhigh\|max\|minimal` | Set reasoning effort |
| `/mode safe\|normal\|auto\|yolo` | Set the [permission mode](cli.md#permission-modes) |
| `/sandbox [on\|off\|status]` | Inspect or toggle the sandbox |

### Tools, secrets, channels, appearance

| Command | Purpose |
| --- | --- |
| `/tools` | Open the tools / settings view |
| `/secrets unlock <passphrase>` · `/secrets lock` · `/secrets status` | Manage the encrypted vault |
| `/mcp list` · `/mcp add <name> <command> [args…]` | Manage external (MCP) tools |
| `/channels list` · `/channels add <name> <command>` | Manage messaging channels |
| `/settings` · `/theme` | Settings and appearance |

## The model picker

Open it with `/model`. It is search‑first:

- type to search across provider and model names (and aliases)
- capability hints show which models support `text`, `vision`, or `video`
- press `Enter` to stage a result, then **Use selected** to apply it
- choosing a model from another configured provider switches to that provider too

## Themes

Switch the look with `/theme` (or `/theme list` to browse). Several dark/light themes are
built in. `/theme mode <dark|light>` toggles the mode.

## Tips

- Use `/provider list` to see exactly which account, model, and endpoint Morphy is using.
- Use `/session list` + `/load` to jump back to earlier work.
- Use `/cost` to keep an eye on token usage during long sessions.