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.

  • 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); ⇧⌘T reopens 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, n new, e archive, / filter, ⌘Z undo.
  • 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 sftp client.
  • 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 — ⇧⌘S is 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.