📋 Tab Reference¶

The RLM Code TUI has 5 tabs, each accessible via keyboard shortcuts or the focus bar. This page documents the first four standard tabs. For the Research tab, see 🔬 Research Tab.

🔁 RLM Tab¶

The central hub for interacting with LLMs and running slash commands.

What's Inside¶

• Conversation log: RichLog widget showing the conversation
• RLM input: Text input at the bottom for messages and commands
• Status strip: Compact one-line status bar above the conversation

Message Rendering¶

Slash Commands¶

Type any /command in the RLM input. All 50+ slash commands work here. Unknown commands are delegated to the full SlashCommandHandler.

📁 Files Tab¶

Project file browser with syntax-highlighted code preview.

What's Inside¶

• Directory tree: Textual DirectoryTree rooted at the working directory
• Code preview: Syntax-highlighted file viewer with Monokai theme
• Draggable split: In one-screen Files view, drag the vertical splitter between tree and preview to resize both areas

Supported Languages¶

Click a file in the tree to preview it. Line numbers and indent guides are enabled.

Resizing the Files Layout¶

• Switch to Files (Ctrl+2) in one-screen mode.
• Drag the vertical divider between the left file tree and right preview panel.
• The sidebar width updates live; preview width adjusts automatically.

📋 Details Tab¶

Status panel and diff viewer.

What's Inside¶

• Status panel: Rich table with workspace, model, provider, ACP, mode, layout info
• Diff viewer: Unified diff between a snapshot and the current file state

Snapshot / Diff Workflow¶

/snapshot          # Take a baseline snapshot
# ... make edits ...
/diff              # View what changed

The diff uses the diff syntax highlighter with Monokai theme.

⚡ Shell Tab¶

Terminal-first shell workspace for running commands.

What's Inside¶

• PTY terminal: Interactive terminal pane with keyboard input, history, and tab completion behavior from your shell
• Prompt line: Minimal > typing line shown in the terminal status area

🔧 Persistent State¶

Powered by PersistentShell, a long-running shell process that preserves:

• ✅ Environment variables set by previous commands
• ✅ Working directory changes (cd)
• ✅ Shell aliases and functions (within the session)
• ✅ Exit codes for inline shell shortcuts (!cmd, >cmd) and shell command runner

Shell Detection¶

Inline shell execution uses a marker-compatible shell backend (zsh, bash, or sh) for reliable completion detection. PTY shell view uses your configured/default shell in interactive mode.

This keeps shell output predictable while preserving interactive behavior.

When a shell command modifies selected files, preview/diff panes are refreshed automatically.

🔍 Command Palette¶

Open with Ctrl+K.

A fuzzy-search modal that lists all available slash commands. Type to filter, arrow keys to navigate, Enter to select.

Available Palette Commands¶

/help  /workflow  /connect  /models  /status  /sandbox  /rlm  /rml  /harness
/clear  /snapshot  /diff  /view  /layout  /pane
/copy  /focus  /exit

Features:

• 🔎 Fuzzy text matching
• ⬆️⬇️ Arrow-key navigation
• ⏎ Enter to select, Esc to close
• Up to 16 results displayed

🔗 Connect Wizard¶

Launched with /connect (no arguments).

A multi-step keyboard-driven picker that guides you through:

1. 🔌 Connection mode: Local models, BYOK cloud providers, or ACP profiles
2. 🏢 Provider selection: Available providers with live/preset status
3. 🤖 Model selection: Provider-specific model list

Connection Modes¶

Direct Connection¶

/connect <provider> <model> [api-key] [base-url]

Examples:

/connect ollama llama3.2:3b
/connect openai gpt-4o sk-...
/connect anthropic claude-sonnet-4-5-20250929

👋 Greeting Detection¶

The TUI detects simple greetings (hi, hello, hey, yo, sup) and responds instantly without an LLM call:

Hey. I am here and ready. Tell me what you want to build.

This avoids unnecessary API calls for trivial interactions.

📋 Slash Command Reference¶

⚙️ Environment Variables¶

📋 Copy to Clipboard¶

Copy the last assistant response with F7, Ctrl+Y, /copy, or the Copy button.