Documentation · 63 pages
Everything the terminal can do.
TRMNLY is Ghostty with an agent, projects, worktrees, connections and a browser built in. These are the same pages as the app's Help tab (⌘?), and they describe the macOS app unless a page says otherwise.
Start here
- PlatformsWhat runs on macOS, Linux, Windows, the daemon, and the cloud
- Getting startedFirst launch, picking a provider, the tour
- OrientationThe full map: every sidebar tab, setting pane, and hotkey
- ProjectsFolder shortcuts with their own env, theme, and startup
- WorktreesPer-project git worktrees for parallel branch and PR work, locally or on a saved SSH host
- KeybindsThe shortcuts that move you faster than the mouse
- Custom shortcutsBind a chord to run a prompt or runbook, send text, grab a screenshot, or pop the prompt menu
AI features
- AgentThe AI panel: tools, scopes, sessions, pinning, memory
- Agent safetyPosture, approval rules, audit log, branch guard
- Agent lockPhysical input lockout + overlay during agent runs
- Account & GitHubWhich GitHub account is linked, and whether the app can reach your repos
- Reporting bugs and requesting featuresSend the TRMNLY team a report from the app, an agent, the CLI or the web
- Cred walletTRMNLY's hosted billing for agent turns
- Local LLMRun models locally via Ollama; the local-model picker
- trmnly-code CLIThe native terminal coding agent
- Pane manifests & trmnly CLIPanes that name themselves, attention flags, the event log
- DictationSpeak into the terminal or the agent composer
- Hands-FreeFull voice conversation loop with the agent
- TelegramDrive the agent from a Telegram chat
- Terminal intelCommand provenance, error digests, shell-state tools
- Scheduled runsPrompts and commands on a cron, an interval, or once
- Background jobsLong-running commands via launchd
- PluginsJavaScript plugin API for tools, status pills, sidebar views
- MCP serverExpose TRMNLY's agent tools to outside Claude Code sessions (and other MCP clients)
- Cloud workspaceThe per-account Linux sandbox at trmnly.dev: its tabs, its agent, and what it costs
- trmnly.dev dashboardCredits, licence seats, paired devices, the conversation archive and account settings at trmnly.dev/app
- Terminal historyKeep every pane's output as text, labelled with its project, tab and pane, on this Mac or on trmnly.dev
- Conversation archiveKeep every Claude Code, Codex, Gemini CLI and Agent conversation on this Mac, or on trmnly.dev
Right-sidebar surfaces
- PromptsSaved prompts with agent / queue / paste-and-run targets
- QueuePer-split command queue with auto-run and attachments
- Claude Code sessionsA restored pane comes back in the conversation it was in
- FilesThe project file tree: preview, inline edit, pin to agent, browse a folder on another machine
- NotesPer-project markdown scratchpad, fed into agent context
- ChatThe per-project message room where you and the agents talk to each other
- KanbanThe per-project Tasks board, #N card refs, claims, GitHub/Linear/Kavanah issue import
- ReviewNotes on the working diff, sent to the agent as one message
- FleetAgents that work the board on their own: dependencies, claims, land policy, doctrine; races of several agents on one prompt
- Access keysThe Keys vault: spend credentials without exposing them
- BrowserThe in-sidebar web tab (WebKit or Chrome), the element picker, and the agent's browser tool surface
- ConnectionsSSH/Mosh hosts, SFTP, port-forwards, containers
- DockerContainers, images, compose, and the built-in microVM engine
- PortsWho holds which port, conflict rules, reservations, free-port search
- WorkflowsRunbooks, browser actions, and tab-monitor rules in one tab
- Activity MonitorRunning processes by CPU and memory, with recorded history
- DevicesIOS simulators: boot, shut down, erase, copy UDIDs
Other surfaces
Background features
Configuration
Help
More
For the terminal underneath — themes, fonts, escape sequences and the configuration reference — see Ghostty's documentation. Everything here is TRMNLY's own surface.