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 |
Menu bar
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.
Right sidebar — every tab
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.