All pages
Docs · More
UI reference — right sidebar tabs
Availability: macOS.
The right sidebar sits on the right edge of every terminal window. Show or hide
it with ⇧⌘\ (View → Show Right Sidebar / Hide Right Sidebar) or its own
hide button ("Hide right sidebar"). Each terminal tab has its own right
sidebar, so switching tabs can show different state. The selected tab is
remembered across relaunches. The Agent tab has its own page:
UI reference — Agent tab. Labels below are copied from the
source.
Sidebar chrome
- Strip — five segments: Agent, Prompts, Queue, Files, Web. Hover tooltips give the long names (Command queue, File browser, Browser).
- More ▾ menu (shows the active tab's name when one of its tabs is open) — Chat, Tasks, Review, Notes, Jobs, Conn, Keys, Docker, Devices, Flows, Local LLM, Activity, Plugins, Help. Badges: "Tasks — N late", "Chat — N new".
- Mic button — "Dictate into terminal — tap to toggle (⌘I), or hold to talk".
- Every tab is also in the menu bar under View → Right Sidebar, by its long
name: Agent, Prompts, Background jobs, Command queue, Connections, File
browser, Plugins, Browser, Project notes, "Chat: the project's message
threads, shared with its agents", "Tasks: the project's Kanban board",
"Review: notes on the working diff, sent to the agent as one message",
"Workflows: runbooks, browser actions, tab-monitor rules", "Local LLM:
installed models, pulls, running models, inline chat", "Activity Monitor:
running processes by CPU and memory", Help, "iOS simulators: boot,
shutdown, erase", "Docker: running containers, images, compose, ports",
"Access keys: API keys for integrations, stored in the Keychain". So the
command palette (
⇧⌘P) finds each one too.
Name mismatches worth knowing: the Conn tab's help topic is
"Connections", Keys is "Access keys", Flows is "Workflows", Tasks
is "Kanban", Web is "Browser", Devices is the simulators topic.
Prompts
Saved prompts (Prompts).
- Header: gear "Prompts settings" (Packs: Browse packs…, Import pack…, Export pack…; Watched folder: Choose folder… / Reload / Change… / Stop watching), + "New prompt".
- Sub-tabs Prompts | Packs.
- Prompts: "Filter prompts (press /)", tag chips, sections Pinned / Most used / Recent today / Prompts. Click a row to paste, double-click to edit. Hover: queue and run buttons. Right-click: Run in Terminal (Return), Queue for Terminal, Paste into Terminal, Send to Agent, Run with Variables…, Stick to top, Pin as preset, Assign Shortcut…, Rename…, Edit…, Delete.
- Run-with-variables sheet: Auto-fill, Preview, targets Paste into
Terminal
⌘T, Run in Terminal⌘R, Queue for Terminal⌘Q, Send to Agent⌘A, Insert into Agent Draft⌘D. - Packs: toggle per pack to add it as a folder; Browse details… opens "Prompt Packs" (Add to sidebar, Uninstall, Install from file…).
Queue
Title "Command Queue" (Queue).
- Scope Tab | Project | All Windows.
- Field "Command to queue (⌘↩ to add)", paperclip (attach files), +.
- Toggles Press Return, Stop on error, Auto-run; attachment mode "@path" | "drop".
- Footer Run next now, Clear; disclosure "How draining works".
- Row right-click: Copy Command, Edit Command, Move to pane, Remove from Queue.
Files
Project file tree (Files).
- Header buttons: show/hide dotfiles, Refresh, "Jump to focused pane's working directory", "Browse a folder on a saved host" (menu of Conn hosts; Back to this machine).
- Row right-click: Reveal in Finder, Edit in TRMNLY, Pin to agent / Unpin from agent, Open With, (folders) cd here in focused terminal.
- Actions bar: cd here, pin, Edit file, Reveal in Finder, "Open in
external editor"; while editing Cancel / Save (
⌘S). - Preview: Markdown Rendered / Source toggle.
Web
In-app browser (Browser).
- Tab strip: scope picker Project / This Tab / All Tabs; + "New tab" (dropdown New Tab, New Incognito Tab); tab right-click Pin Tab, Duplicate Tab, Hibernate Tab / Wake Tab, Close Tab.
- Address bar: Back / Forward (right-click for history), Reload (right-click Reload Ignoring Cache, Restart Browser), session chip ("Browser session" popover, Manage sessions…), engine chip (WebKit, Chrome — TRMNLY profile, Chrome — copy of your profile), URL field, zoom badge, site info, reader mode, "Saved accounts for this site", agent-drive toggle ("Allow agent on host", "Show agent cursor in page"), design mode ("click an element to hand it to the agent" — the element picker), DevTools toggle, "Saved URL shortcuts".
- More menu: Open in Safari, Open in Chrome, Copy URL, Send
Page Text to Terminal, Zoom In, Zoom Out, Actual Size, Clear
Browsing Data…, Import from Browser…, Restart Browser, Restart
All Tabs, Search Engine, Inspect Element (
⌥⌘I). - Find bar
⌘F(case / whole word / regex,⌘G/⇧⌘G);⇧⌘Treopens a closed tab. - DevTools panes: Console, Network, Elements, Storage, Performance, Egress. Network filters XHR / JS / CSS / Img / Font / Media / Doc / Other; row menu Copy as fetch, Copy as cURL, Copy URL; Export network log as HAR….
Chat
Per-project message threads shared with the project's agents (Chat).
- Header: New conversation, "Chat options" (Mark all read, Show archived, Share this project's chat… / Members of the shared room…, New shared room…, Open shared rooms on the web, Set your display name…).
- "Search conversations"; thread right-click Share…, Archive, Copy transcript, Delete….
- In a thread: back ("All conversations"), share button, composer
"Message … @mention to address someone", Send
⌘⏎. - Sharing needs a trmnly.dev sign-in (Settings → Account).
Tasks
The project's Kanban board (Kanban).
- Header "N open" / "N late"; board picker "Switch board" (New Board…).
- "Manage the board" menu: Undo, Redo, Add Column…, per column (Rename…, WIP Limit…, Sort By, Mark as Done Column, Clear N Cards, Delete Column), Boards (New Board…, Rename Board…, Delete Board), Archive Finished Work, Archive… (N), All Projects…, Reset Board.
- Filter bar: "Filter tasks…", bolt (only startable tasks), eye (hide done columns), label chips.
- Default columns To Do, In Progress, Done; + per column adds a task.
- Card right-click: Show Details, Edit…, Move Forward, Move Back, Move To, Priority (Low / Normal / High / Urgent), Archive, Delete. Editor: Title, Priority, Due Date, Labels, Notes, Checklist, Blocked By, Links, Activity.
- Keys:
↑/↓select,→/←move,↩edit, Space details,nnew,earchive,/filter,⌘Zundo. - Issue import (GitHub / Linear / Kavanah) is configured per project, not in this tab — see Kanban.
Review
Notes on the working diff, sent to the agent as one message (Review).
- Scope Unstaged | Staged | Branch; "Re-read the diff"; menu Show sent notes, Clear sent notes.
- Click a line to comment ("Note on line N…" → Add); file header right-click Comment on the whole file….
- Footer Send to agent.
Notes
Per-project markdown scratchpad the agent sees (Notes).
- New note, Rename this note, Delete this note, "Switch notes"
menu, "Search notes" (
⌘F). - Footer Edit / Preview, byte count, Clear.
Jobs
launchd background jobs (Background jobs).
- Header "Background jobs · N", refresh.
- Composer: Command, "Name (optional)", Keep alive, "Schedule (5m, 1h, @daily 09:00 — optional)", Submit.
- Row: View log, Reveal, Stop / Remove.
- Awake monitor — "Keeping Mac awake" / "Idle sleep allowed", Stop all (Awake).
- Agent lock monitor — Arm lock; when armed "Input blocked · …" and Unlock… (Agent lock).
Conn
Saved connections (Connections). Icon sub-tabs: Hosts, SFTP, Tunnels, Containers, tmux.
- Hosts: "Saved hosts", "Import hosts from ~/.ssh/config", "Add a host". Row: status pill, Edit, SSH / Mosh; expand for "Port forwards", "SFTP…", "tmux sessions" (Attach). Host editor: Name, User, Hostname, Port, Identity file, Use mosh, Connect on launch, "Extra ssh args", "Jump host chain", Notes.
- SFTP: "Pick a host…", remote path, Open / Download / Upload…,
terminal icon opens the real
sftpclient. - Tunnels: "Port-forward presets", New preset (Name, Host, Project, Rules).
- Containers: the same panel as the Docker tab.
- tmux: "tmux / screen", "New session name" + Start, per session Attach or attach in a new split.
Keys
Access-key vault for integration credentials, in the Keychain (Access keys). Not Settings → API Keys (model providers).
- Toolbar "Access Keys": import from a .env file, "Push keys to your cloud workspace", "Add an access key", filter All Keys / Grouped by Project / Current Project.
- Row right-click: Copy Value, Edit…, Open Settings → API Keys…, Allow Agent Access / Hide from Agents, Allow Agents For…, Let MCP Client Fetch Keys…, Push to Cloud Workspace…, Delete….
- Editor: Name, Value, Env var, Service, Notes; "Agent access" (Agents may fetch this key, Grant lasts, Clients, Projects); "Lifecycle" (expiry, rotation).
Docker
Containers across runtimes (Docker). Runtime menu: Auto-pick / Docker / OrbStack / Colima / TRMNLY (built-in). Without a runtime it offers "Run containers without Docker" → Set Up…. Icon sub-tabs:
- Containers — per row Show logs, "Open shell in focused terminal", Restart, Stop / Start, Remove.
- Images — "Pull image" + Pull; per image run (sheet: name, ports, environment, "Remove on exit (--rm)") or remove.
- Compose — "Add a compose project"; Up / Down, Restart.
- Ports — "Master ports view": Rescan, reserve a port, TCP / UDP filters, kill the listener (Ports).
Devices
iOS simulators (Devices). Header "Simulators" with "Open Simulator.app" and refresh; row "…" menu Boot / Shutdown, Erase…, Copy UDID.
Flows
Workflows (Workflows).
- Top: "Save current session" (distils the active agent session into a
runbook; no shortcut —
⇧⌘Sis File → Save Session…, which saves the window layout, not a runbook), From Template, "…" (Import workflow…, Reveal storage folder); search "Search runbooks, actions, rules". - Sections Runbooks (play opens a new agent session; menu Edit…, Edit tags…, Export…, Delete…), Browser actions (play replays without the model; Ask agent to replay…, Convert to runbook), Tab-monitor rules (Open editor…, Test fire).
Local LLM
Ollama models (Local LLM). Sections: Ollama endpoint (field +
Apply, Install Ollama / Start Ollama), Installed (menu Set
as agent default, Chat with this model, Delete weights…), Pull a
model (e.g. qwen3-coder:30b + Pull), Loaded in memory
(Unload), Try a model (inline chat).
Activity
Process monitor (Activity Monitor). Panes Processes | History.
- Processes: off until Start monitoring; filter by name or PID; sort CPU | Memory; row hover quit ("hold ⌥ to force quit"); right-click Copy PID, Quit, Force Quit.
- History: span 15m / 1h / 6h / 24h / 7d / All; record button; settings menu (sample interval, retention, Record top processes, Open in Window, Erase Recorded History); drag across a chart to Save a period.
Plugins
JavaScript plugins (Plugins). Install…, Reload all; row Reload, permissions Review… / Edit… / Revoke; "Open plugins folder". The permissions sheet: Deny, Allow requested, Save custom.
Help
These docs, rendered in-app (⌘? via Help → TRMNLY Help). "Search help…",
topic list, footer Replay tour (first-run tour) and Ghostty docs.