All pages

Docs · Start here

Orientation — the full map

Availability: macOS. The GTK app on Linux and Windows has a four-pane subset of this sidebar — see Platforms.

TRMNLY is a fork of Ghostty that adds an AI agent, projects, git worktrees, saved connections, an in-app browser, plugins, and a set of native macOS surfaces on top of Ghostty's terminal. Everything Ghostty does — themes, fonts, splits, config files, escape sequences — still works the same; this page maps the TRMNLY layer on top.

Label-exact detail — every button, menu item and setting by its on-screen name — is in the UI reference pages:

Page Covers
UI reference — menus Every menu-bar menu and item, with shortcuts
UI reference — window Left sidebar, project menu, Project Settings, tab list, titlebar, pane right-click, palette, switcher, layouts, standalone windows
UI reference — right sidebar Every right-sidebar tab except Agent
UI reference — Agent tab The agent chat: model picker, gear menu, posture, approvals, composer, sheets
UI reference — Settings All 17 Settings panes

The window at a glance

Surface How to reach it What's there
Terminal — A Ghostty surface: tabs, splits, config
Left sidebar ⌘\ (View → Hide/Show Tab Sidebar) Project rail, worktree selector, tab list, Find in Project, Lock Desktop, + menu
Right sidebar ⇧⌘\ (View → Hide/Show Right Sidebar) 19 tabs (below); one sidebar per terminal tab
Folder strip Above each tab's terminal Path, attach file, + menu (splits, tabs, layouts, Move to Cloud…)
Command Palette ⇧⌘P Every menu item, tabs, run actions, "Ask the agent: …"
Quick Switcher ⌘K Tabs, projects, files, recent commands, shell history
Layouts ⇧⌘L Grid layouts and saved split presets
Quick Terminal View → Quick Terminal (unbound — bind toggle_quick_terminal) Drop-down terminal over any space
Settings ⌘, 17 panes (below)
Help ⌘? (Help → TRMNLY Help) These docs, in the right sidebar's Help tab

TRMNLY · File · Edit · View · Worktree · Window · Help. TRMNLY-specific items: settings export/import, .cast export and Share Session (TRMNLY menu); Save Session… and Reopen Session (File); sidebar toggles, Right Sidebar ▸ (every tab by name), dictation, hands-free, Attach File to Terminal…, layouts, Broadcast Input to All Panes, Auto-Answer Prompts in This Pane (View); New / Switch to / Manage Worktrees (Worktree); First-Run Tour, What's New, Reveal Logs, Report a Bug or Request a Feature… (Help). Full list: UI reference — menus.

Five tabs sit in the strip; the rest are under More ▾. All 19 are also under View → Right Sidebar. The selected tab survives relaunch.

Tab Where What it does Read more
Agent strip The AI chat: model picker, approvals, chat tabs, scheduled runs Agent tab, Agent, Agent safety
Prompts strip Saved prompts with {{variables}}, tags, packs Prompts
Queue strip Command queue that fires on command-finished Queue
Files strip Project file tree: preview, edit, pin to agent, remote folders Files
Web strip In-app browser (WebKit or Chrome), DevTools, element picker Browser
Chat More Per-project message threads shared with the agents Chat
Tasks More Per-project Kanban board(s) Kanban
Review More Notes on the working diff, sent to the agent as one message Review
Notes More Per-project markdown notes the agent sees Notes
Jobs More launchd background jobs, the Awake monitor, the agent lock monitor Background jobs
Conn More Hosts, SFTP, Tunnels, Containers, tmux Connections
Keys More Access-key vault for integration credentials Access keys
Docker More Containers / Images / Compose / Ports Docker
Devices More iOS simulators: boot, shutdown, erase Devices
Flows More Runbooks, browser actions, tab-monitor rules Workflows
Local LLM More Ollama models: pull, run, inline chat Local LLM
Activity More Processes by CPU/memory, recorded history Activity Monitor
Plugins More Installed JavaScript plugins Plugins
Help More These docs (⌘?) —

The left sidebar

The project rail switches projects — folder shortcuts with their own env file, shell, startup command, theme, browser URLs and run actions (Projects). Right-click a project for Project Settings…, Run ▸, Worktrees ▸, Rename…, Choose Icon…, Hide from Sidebar, Delete. Its foot holds Find in Project, Lock Desktop (blocks physical input while the agent runs — Agent lock), the + menu (New Tab, New Window, New Project, From GitHub…, saved workspaces) and the collapse toggle.

The tab list starts with the worktree selector pill (Worktrees), then Close Tabs, the Project | All filter, the broadcast bar, and the Pinned, project and Archived tab sections. Each tab row can carry a manifest the pane wrote about itself — title, role, status pill, progress, and a flag when it is waiting on you (Pane manifests).

What the agent can do

The agent in the Agent tab drives the app through 400+ native tools: terminal (read panes, run commands, splits/tabs/tmux, queue, watch output), files and code (read/write/edit, search, git and gh, LSP, tests), the in-app browser, connections (SSH, SFTP, port forwards, containers, Docker), automation (prompts, schedules, runbooks, tab-monitor rules, notifications, keep-awake, write snapshots), projects (Kanban, issues, notes, worktrees), secrets (the Keys vault via env vars and {{key:NAME}}), macOS (screenshots, clipboard, app control, accessibility), and orchestration (sub-agents, plans, dry runs, fleets, races).

It runs behind the approval posture — Approve / Auto-accept / Observe, cycled by clicking the chip under the chat tabs or Shift-Tab in the composer — and the rails in Agent safety. The same tools are exported to external MCP clients, so Claude Code or Codex in a pane can drive TRMNLY too (MCP server, Remote control).

Settings map

Seventeen panes, in toolbar order. Search any row with the field at the top.

Pane What lives there
General Sleep, quit behaviour, terminal links, config file
Account trmnly.dev pairing, GitHub link, credit balance (Cred wallet)
Appearance Theme, app appearance, density, ligatures, cursor
Font Ligatures, default and per-project size
Keybindings Rebind built-in actions (Keybinds)
Shortcuts Custom chords → prompt/runbook/text/screenshot (Custom shortcuts)
Integrations Status of every stored credential, Verify all
API Keys Model-provider, web-search and Whisper keys — distinct from the Keys tab
AI Agent Default model, TRMNLY.md, trmnly-code CLI, pane manifests, Claude Code sessions, conversation archive, terminal history, External MCP clients, Remote Control, web search, network allowlist, filesystem sandbox, voice
Notifications Quiet hours, long-command toasts, tab-monitor rules
Updates Channel, automatic updates, Check for Updates Now (Updates)
Profiles Save/apply whole settings profiles
Security Scripting consent, egress mode, audit log, diagnostics, plugin permissions
Permissions macOS privacy grants with Request / Open in System Settings…
Containers Preferred runtime, built-in engine, detected runtimes
VibeHub Sync conversations + terminal sessions (VibeHub)
TestFlight App Store Connect credentials

Keyboard shortcuts worth knowing

⇧⌘P palette · ⌘K switcher · ⌘\ / ⇧⌘\ sidebars · ⌘? help · ⇧⌘L layouts · ⇧⌘I broadcast input · ⇧⌘A auto-answer prompts · ⌘I dictate into terminal · ⌃⌘I hands-free · ⌃⌘A attach file to terminal · ⌃⌘N new worktree · ⇧⌘S save session · ⌥⌘= / ⌥⌘- window zoom · ⌃⌘S screenshot to agent chat · ⌃⇧⌘S screenshot to terminal. In the Agent tab: ⌘. stop, ⇧⌘N new chat, ⇧⌘F search chats. Full list: UI reference — menus, Keybinds.

Where do I…?

  • …add an AI provider key? Settings → API Keys → Agent Providers, or the Agent tab's gear → Set API key…. Without a key, pick TRMNLY credits under "Pay with" in the model picker, or a CLI subscription (Claude Code, Codex, Gemini CLI). Local models: the Local LLM tab.
  • …store a service credential the agent can use? The Keys tab (Access keys) — not Settings → API Keys.
  • …undo a file change the agent made? The Snapshots row above the composer (revert per file), or gear → Undo last write.
  • …stop the agent? The red stop button in the Agent header, ⌘.. Lock everything down: ⇧⌘. or the shield → Panic — lock down.
  • …set up an SSH host / port forward? Conn tab → Hosts / Tunnels.
  • …make something happen when a build fails? A tab-monitor rule (Settings → Notifications → Tab monitor rules, or Flows tab → Tab-monitor rules — Tab Monitor).
  • …schedule a prompt or a command? Agent tab gear → Scheduled jobs… (the sheet is titled "Scheduled runs" — Scheduled runs).
  • …pull GitHub, Linear or Kavanah issues onto the board? Right-click the project → Project Settings… → Issue tracker → Import issues (Kanban).
  • …browse a folder on another machine? The host button in the Files header (Files).
  • …work in the cloud? Cloud workspace; a tab moves there via the folder strip's + → Move to Cloud….
  • …save a multi-step workflow? Flows tab → Save current session, or Agent gear → Save as Runbook… (Workflows).
  • …keep the Mac awake during a long job? Settings → General → Sleep, or the Awake monitor in the Jobs tab (Awake).
  • …let Claude Code drive TRMNLY? Settings → AI Agent → External MCP clients → "Expose TRMNLY's tools to other apps", then Connect next to Claude Code (MCP server). Phone pairing is Remote Control, just below.
  • …export or share a session? TRMNLY menu → Export Tab Transcript as .cast… / Share Session…; for an agent chat, gear → Share session… (Sharing & export).
  • …report a bug? Help → Report a Bug or Request a Feature… (Feedback).
  • …replay the first-run tour? Help → Show First-Run Tour, or the Help tab's Replay tour.
  • …find out whether a feature exists on Linux, Windows, or the cloud? Platforms.
  • …find out why updates never arrive, or why the app says it expired? Updates.