All pages

Docs · More

UI reference — window, left sidebar, palettes and other windows

Availability: macOS.

Everything in a terminal window that isn't the right sidebar, plus the standalone windows and sheets. Labels are copied from the source. Menu bar: UI reference — menus. Right sidebar: UI reference — right sidebar.

Toggle with ⌘\ (View → Hide Tab Sidebar / Show Tab Sidebar). Two columns: the project rail (narrow, left) and the tab list. The collapse button at the foot of the rail ("Hide tab list" / "Show tab list") narrows it to the rail.

Project rail

  • Project tiles — icon or first letter; a badge counts open tabs. Click to switch project. Drop an image on a tile to set its icon; drop a Finder folder on the rail to create a project (Projects).
  • More projects — when tiles overflow: a "Projects" popover with Order…, "Search projects", and an eye per row ("Show on sidebar rail" / "Hide from sidebar rail").
  • Foot buttons, top to bottom:
    • Find in Project (magnifying glass) — a "Find in Project" window: "Search in project", Search, Scope (Current Tab / This Project / All Tabs), "Search Claude Code sessions"; results grouped Notes / Files / Open Tabs / Claude Code Sessions.
    • Lock Desktop (padlock) — "block physical input while the agent runs"; click again to unlock with Touch ID or password (Agent lock). Needs Accessibility and Input Monitoring.
    • + — "Add tab, window, or project": New Tab, New Window, New Project (sheet: Folder, Display name, Default URL → Create), From GitHub… ("Link GitHub Repository" → Clone & Add), Project Order…, Project Settings…, Find in Project…, Recent Folders, Save Workspace…, Open Workspace, Delete Workspace (saved window sessions).
    • Collapse toggle.

Project right-click menu

On a rail tile or an overflow row: Open in New Tab, Project Settings…, Run ▸ (the project's run actions), Worktrees ▸ (New Worktree…, Manage Worktrees…), Rename…, Choose Icon…, Remove Icon, Hide from Sidebar / Show on Sidebar, Delete.

Project Settings sheet

Right-click project → Project Settings… (or the + menu). Sections:

  • Identity — Name, Folder (Choose…), Icon, "Color (#RRGGBB)", position in the sidebar.
  • Terminal — Shell, Startup command, ".env / .envrc".
  • Appearance — Theme name, "Font size (pt)".
  • Browser — Default URL, Additional URLs.
  • Xcode (Xcode projects only) — Destination, Scheme, Configuration.
  • Issue tracker — Tracker (GitHub / Linear / Kavanah), API key, scope, "Close the issue when its card is done", Test connection, Import issues (onto the Tasks board), Finish done cards, Disconnect (Kanban).
  • Cancel / Save.

Tab list

Top to bottom:

  • Worktree selector pill — active worktree name and branch (* = uncommitted changes). Menu: each worktree, View PR #N / Open PR…, New Worktree…, Manage Worktrees… (Worktrees).
  • Close Tabs menu — Close Inactive (n), Close All Tabs (n), Choose & Close….
  • Filter Project | All — this project's tabs, or every tab in the window.
  • Broadcast bar — "Broadcast input off" / "Broadcasting to splits".
  • Pinned section (⌘1–⌘9 hints, Unpin), the project's tabs, and Archived (click to restore; right-click Restore, Delete).
  • Tab row indicators: new output, needs attention (last command failed), running time, exit code, agent dots (waiting / error / working), and the pane's own manifest (title, status pill, progress, flag — Pane manifests).
  • Tab row right-click: Pin Tab / Unpin Tab, Restart With Last Command, Rename…, Show Process Tree…, Move to Project ▸, Archive, Close Tab.

Manage Worktrees sheet

Worktree → Manage Worktrees… (or the project menu / pill). Header New Worktree; per row branch, ahead/behind, merged badge, PR chip, Reveal in Finder, remove. Row menu: Rename…, Commit & Push…, Open PR… / Merge PR & Clean Up… / Refresh PR Status / Forget PR, Push Branch. Settings: "Worktrees folder", "Copied env files". The New Worktree sheet asks for Branch name, "Base ref (optional)", Folder, and "Publish branch to remote".

Terminal window chrome

Titlebar (right side)

  • Reset Zoom — while a split is zoomed.
  • Update badge — when an update is available.
  • Theme (sun/moon, "Choose Theme") — Light / Dark / Imported themes, Import theme…, Use System Default.
  • Settings gear — opens Settings.

Native tab right-click

Adds Close Tabs to the Right, Rename Tab..., Rename with AI, Move to Project ▸, and a tab colour palette.

Folder strip (above each tab's terminal)

  • Path label — right-click Reveal in Finder, Open in Finder, Copy Path.
  • Copy / clear what's typed at the prompt.
  • Paperclip — "Attach a file — types its path into this pane".
  • + — "Split this terminal, or open a new tab or window": Split Right, Split Down, Split Other Way ▸ (Split Left, Split Up), New Tab, New Window, Choose Layout…, Move to Cloud… (Cloud workspace), and with several panes Zoom Pane, Equalize Panes, Type Into Every Pane; Close Pane, Close Tab.

Terminal pane right-click

  • With a selection: Copy, Send to agent, Ask agent about this, Explain this error.
  • Paste; Attach File(s) for Agent… (when an agent CLI is running) or Insert File Path(s)…; Screenshot for Agent… (agent CLI only).
  • Copy Smart Token, Open in Editor, Search All Tabs…, Export Scrollback….
  • Split Right / Left / Down / Up, Reset Terminal, Toggle Terminal Inspector, Terminal Read-only, Change Tab Title..., Change Terminal Title....

Pane overlays

  • Queue chip (bottom-left) — "N · first command"; menu Run next now, Clear queue (Queue).
  • Auto-answer chip — after View → Auto-Answer Prompts in This Pane: menu "Safety mode", "Model", "On by default for new panes", "Disable for this pane".
  • "Broadcasting input" banner on every receiving pane.
  • Pane number badge (top-right) when a tab has more than one pane.

Command Palette, Quick Switcher, Layouts

  • Command Palette — ⇧⌘P (View → Command Palette). "Execute a command…". Searches every menu-bar item ("Menu: Item"), tabs ("Focus: …"), run actions, "Ask the agent: …" built from what you typed, and argument commands such as "Set Theme" and "Set Tab Title". Opened from the Agent tab it lists "Agent: …" commands (New Session, Stop Generating, Retry Last Message, Panic…).
  • Quick Switcher — ⌘K (View → Quick Switcher). In a focused terminal ⌘K clears the screen instead, so use the View menu there. One fuzzy list with badges Tab, Project, Folder / File (choosing one cds there), Recent (tracked commands), History (shell history). ⌥↩ opens in a new split. No prefix operators.
  • Layouts… — ⇧⌘L. "Grids" (Two Columns, Two Rows, Three Columns, Grid 2×2, Grid 3×2, Main + Stack), "Saved Layouts", Save Current… (Splits).

Standalone windows and sheets

  • Settings — ⌘,. See UI reference — Settings.
  • First-run tour ("Welcome to TRMNLY") — 12 steps, Back / Next / Done, × to skip; some steps have buttons ("Open API Keys settings", "Open Security settings", "Open container settings", "Open plugins folder", "Open Settings…"). Replay: Help → Show First-Run Tour, or Help tab → Replay tour.
  • What's New in TRMNLY — Help → What's New in TRMNLY…; "Search release notes", tag pills, entries per version.
  • Access window ("TRMNLY") — on release builds without an approved account: Sign in with trmnly.dev, Continue with GitHub, Check Now, Use a Different Account, Renew…, Try Again, Quit (Account & GitHub).
  • Pair this Mac (Settings → Account → Pair…) — "Connect this Mac", Sign in with GitHub, "Use a pairing code instead". Buy Credits opens the purchase sheet (Cred wallet).
  • Report a Bug or Request a Feature — Help → Report a Bug or Request a Feature…: Bug report / Feature request, Title, Details, "Include diagnostics", "Include the current agent conversation", Copy Report, Send (needs a trmnly.dev sign-in) (Feedback).
  • About TRMNLY — Version, Build, Commit, Expires / Licensed to; Docs, GitHub.
  • Lock overlay — full-screen on every display while the desktop lock is armed: "TRMNLY agent is running", Unlock, "Type your password instead… (Esc)".
  • Quick Terminal — drop-down terminal (View → Quick Terminal); no tabs.
  • Share session (Agent gear → Share session…) — redaction summary, "Include tool results", Format Markdown / JSON, Save….
  • Others: "Search All Tabs" (pane right-click), "Compare Panes — A ↔ B" (View → Compare Pane With…), "Approval requests" (MCP client approvals), "Warning: Potentially Unsafe Paste", "Settings Sync Conflicts", "Annotate screenshot".