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.
Left 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–⌘9hints, 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⌘Kclears the screen instead, so use the View menu there. One fuzzy list with badges Tab, Project, Folder / File (choosing onecds 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".