All pages

Docs · More

UI reference — Settings window

Availability: macOS.

Open with TRMNLY → Settings… (⌘,). Labels below are copied from the source; quote them as written. For the override-config model behind these controls see Settings; for the top-level map see Orientation.

Window layout

  • A Search settings field across the top. It matches a setting's label, pane, current or default value, and keywords. Each result shows "Pane · current value" and a Changed badge when overridden; clicking it switches to that pane and highlights the row. No hits: "No matching settings."
  • A toolbar of 17 panes, in this order: General, Account, Appearance, Font, Keybindings, Shortcuts, Integrations, API Keys, AI Agent, Notifications, Updates, Profiles, Security, Permissions, Containers, VibeHub, TestFlight.
  • Several panes carry a What changed button (recent changes to that pane) and per-row reset buttons ("Reset to default (…)"; shows Default when nothing is overridden).

General

  • Sleep: "Keep Mac awake while tasks are running"; "Keep Mac awake while a prompt queue is draining"; "Idle mode — never sleep while TRMNLY is open"; "Keep browser tabs awake while TRMNLY is open" (off by default).
  • Quitting: picker "When something is still running" — "Ask each time" / "Stop background work on quit" / "Leave everything running". Covers background jobs, port forwards, MCP server, sleep claims, agent runs, Telegram bridge.
  • Terminal Links: "Open http(s) links in the in-app browser" (sends clicked links to the Web tab instead of the system browser).
  • Configuration File: Open Config File…, Reload Now, and the path (~/.config/ghostty/config).

Account

Contents depend on whether this Mac is paired to trmnly.dev (Cred wallet, Account & GitHub).

  • Account: signed out shows "Pair this Mac to see your account." and Pair…; signed in shows the email, "Signed in to trmnly.dev" and Forget (stops showing the balance — unpairing lives in Settings → AI Agent → Remote Control).
  • GitHub (hidden when GitHub isn't signed in): refresh button ("Check GitHub again"); GitHub sign-in row (profile link, or Link on trmnly.dev…); Repository access row (Install GitHub App… when not installed, Manage… per installation); Retry on failure.
  • Balance (signed in): "n CRD", "Credits remaining", Buy Credits, refresh ("Refresh balance").
  • Pricing: "Approximate cost per turn".

Appearance

  • Theme list with a Search… field, a Themes list (click = live preview), Import…, Use System Default.
  • Preview side: Keep (lock in), Revert (during a preview), status "Applied" or "Live preview — pick another or Keep to lock in." Leaving without Keep rolls the theme back.
  • App appearance: Auto / Light / Dark (sidebars, settings, transcript — independent of the terminal theme).
  • Density: Comfortable / Compact / Dense (sidebar row height).
  • "Disable font ligatures" (same setting as the Font pane).
  • Cursor: Style (Inherit / Block / Bar / Underline), Blink, Color (hex, empty = theme), Trail length (0–20), Trail color.

Font

  • Ligatures: "Disable font ligatures".
  • Default font size: field ("e.g. 13"), Apply, Use Config Default.
  • Per-project font size: read-only list; edit sizes in each project's settings dialog (left sidebar → right-click project → Project Settings…).

Keybindings

Rebinds built-in terminal actions (Keybinds).

  • Table with Action and Shortcut columns (about 45 actions: New Window, New Tab, Close…, Split Right/Left/Down/Up, Copy, Paste, Find, Zoom Split, tab navigation, Command Palette, Quick Terminal, Toggle Fullscreen, Toggle Inspector, scrolling, Jump to Prompt, Clear Screen, Reset Terminal, font size, Reload Config, Open Config, Quit).
  • Per row: Record (becomes Cancel; "Press a shortcut…"), Reset when overridden. A clash asks "Conflict with existing shortcut" → Override.
  • Advanced — bind any action: bind any Ghostty action by name (field "action (e.g. text:hello)", Record, Add).

Shortcuts

Custom chords that trigger TRMNLY actions (Custom shortcuts).

  • Add Shortcut button; table columns Name, Shortcut, Action, Scope (Global / App), On, then Edit and a trash button.
  • Warning when a global shortcut lacks Accessibility permission, with Open System Settings.
  • Editor sheet ("New Shortcut" / "Edit Shortcut"): Name, Shortcut (Record), Action picker — "Send Text" (with "Press Return after (run the command)"), "Run Saved Prompt", "Run Runbook", "Screenshot to Chat", "Screenshot to Terminal", "Show Prompt Menu", "Attach File to Terminal", "Toggle Floating Pane"; toggle "Fire even when TRMNLY isn't focused (global)"; Cancel / Save.

Integrations

Every service TRMNLY holds a credential for, with its status.

  • Verify all; summary ("n configured · m rejected").
  • Groups Agent providers (Anthropic, OpenAI, Google Gemini, OpenRouter), Voice (Whisper transcription, ElevenLabs), Services (VibeHub). Each row: status pill (Not set / Stored / Verified / Rejected / Unreachable), Verify, and Configure / Set up (jumps to the pane holding the field).
  • Also connected: "MCP server bridge" (Running/Off, Configure → AI Agent) and "Keys vault" (points at right sidebar → Keys).

API Keys

Model-provider keys, stored in the Keychain. Not the same as the Keys tab in the right sidebar, which holds keys for integrations the agent uses (Access keys).

  • Each row: title (+ Saved badge), "?" link to the provider dashboard, masked field, show/hide eye, paste button, Save, Clear, Verify; Use it here when the Keys vault already holds a matching key.
  • Agent Providers: Anthropic, OpenAI, Google Gemini, OpenRouter.
  • Web Search: Brave Search, Tavily, Exa, Serper (Google), Perplexity (optional; without one the agent falls back to DuckDuckGo).
  • Voice Transcription: Whisper key, Endpoint (any OpenAI-compatible or local whisper.cpp server), Save, Reset, Check.

AI Agent

One long form; sections top to bottom:

  • Default model: "New conversations start on" (model picker).
  • Behavior: "Auto-approve all tool calls" (default for new agent windows); "Vim mode for prompt input".
  • Project context (TRMNLY.md): "Auto-add TRMNLY.md when opening a project"; Add TRMNLY.md to current project (Replace existing if one is there).
  • trmnly-code CLI: status, Install, Uninstall, Smoke test, Refresh; Homebrew/npm commands to copy (trmnly-code). TRMNLY → Install trmnly-code CLI… opens this section.
  • Pane manifests: "Show pane status in the sidebar"; "N pane(s) waiting on you" + Go to oldest; "Write the event log"; Reveal Logs; Install trmnly CLI (Pane manifests).
  • Claude Code sessions: picker "After a restart" — "Don't remember sessions" / "Type the resume command" / "Type it — but run it after a crash" / "Always run it"; hook status + Install hook (Claude Code sessions).
  • Conversation archive: "Keep conversations" — Off / On this Mac / On this Mac and on trmnly.dev; "Stop Claude Code deleting its transcripts after 30 days"; Sweep now; Show in Finder (Conversation archive).
  • Terminal history: "Keep terminal history" (same three options); "Delete history on this Mac after" — 30 days / 90 days / 1 year / Never; Show in Finder (Terminal history).
  • External MCP clients: "Expose TRMNLY's tools to other apps" (the MCP server bridge); Approvals — No approval / Approval for writes / Approval for dangerous / Approval for everything. While exposed: APPS rows (Claude Code, Claude Desktop, Cursor, VS Code, Codex CLI) with Connect / Fix / Update / Remove; CLIENT ACCESS per client (Trusted checkbox, project picker "Follow client folder", menu "Edit tool access…" / "Unpin project" / "Forget this client", Revoke, Revoke all grants); ANY OTHER CLIENT (Copy stdio config, Copy HTTP config, Reveal bridge script); "Also listen on localhost HTTP / SSE" (MCP server).
  • Remote Control (trmnly.dev): Enabled toggle. Unpaired: "Device name", Start pairing, Sign in with GitHub, QR code. Paired: Device ID / Token / Tunnel rows; "Connected now" with Disconnect; Kill all remote access…; Transport (Quick tunnel / Named Cloudflare tunnel / Tailscale); "Direct LAN connection"; "Advertise with Bonjour"; "Push sidebar approvals to the phone" (When away / Always / Never); Open dashboard; Unpair… (Remote control).
  • Web search: "Enable web search in new chats"; "App search provider" (Auto, Brave Search, Tavily, Exa, Serper (Google), Perplexity, DuckDuckGo); "Claude models" (Claude built-in search / App search); "Max Claude searches per request".
  • Network allowlist: Mode — Open (any host) / Allowlist only; host field + Add.
  • Filesystem sandbox: Add folder… (extra read/write roots for agent tools); remove per root.
  • Voice & speech: "Speak assistant replies"; "TTS backend" (System voice (offline) / ElevenLabs, with Voice ID / Model ID); "Wake word listening"; "Transcription backend" (Apple (on-device) / Whisper (OpenAI-compatible)); "Hands-free target" (TRMNLY agent / Terminal pane) (Dictation, Hands-Free).
  • Telemetry (local only): "Record tool-call outcomes"; Open telemetry…; Clear.
  • Shortcuts: buttons that open sheets in the front window's Agent tab — Project agent settings, Memory, Scratchpad, Pinned files, Providers, routing & spend, Scheduled jobs, Watch tasks, Turn traces.

Notifications

  • Quiet hours: "Hold notifications during quiet hours", From / To; Send queued (N) / Discard queued when some are held.
  • Long-running command toasts: "Notify after N seconds".
  • Tab monitor rules: rule list, + ("Add rule"), per-rule toggle. Editor: "Rule name", "Pattern", Match (Contains / Regex), "aA" (case-sensitive), Action (Notify / Bell / Send to agent sidebar / Mark tab for attention), Project, Trigger (Line match (default) / Cron interval / File change / Tab idle / Git commit), "Live preview", Save / Delete (Tab Monitor).

Updates

  • Update channel: Stable / Beta (tip).
  • Automatic updates: Off / Check and notify / Download and install.
  • Check for Updates Now + "Current version: …"; the answer appears here ("You're up to date…", Install Update, Restart Now, or the error). Test builds say updates are disabled (Updates).

Profiles

Saved sets of theme, font, keybindings, update channel and agent preferences.

  • Save current: "Profile name (e.g. Work)" + Save as Profile.
  • Saved profiles: Apply; menu Update from current settings / Rename… / Delete; the active one has an Active badge.

Security

  • Scripting consent: rows for AppleScript, Shortcuts, Telegram, Plugin, MCP Server — each Enabled, Confirm every command, Limit: N/min (Scripting).
  • Agent network egress: Open (any host) / Allowlist only (same setting as AI Agent → Network allowlist).
  • Audit log: "Append every tool call to …/audit.log".
  • Diagnostics: "Keep MetricKit crash & hang diagnostics on disk".
  • Plugin permissions: per-plugin grant with Revoke.
  • Update channel: read-only feed URL and public key.

Permissions

macOS privacy grants, read-only status plus links. Rows: Accessibility, Automation (Apple Events), Microphone, Notifications, Screen Recording, Full Disk Access. Each shows Granted / Denied / Not requested / Unknown, a Request button (Microphone, Notifications, Screen Recording only, while "Not requested"), and Open in System Settings…. Refresh status at the bottom.

Containers

Header "Container runtimes" (Docker).

  • Preferred runtime: Auto-pick / Docker / OrbStack / Colima / TRMNLY (built-in).
  • Built-in engine: status ("Ready · no Docker required" / "Needs one-time setup" / "Unavailable on this Mac"), Set Up…, Remove Runtime, "CPUs per container", "Memory per container".
  • Detected runtimes: Refresh; per runtime Start or Install.
  • Compose projects: tracked projects with a Reveal in Finder button.

VibeHub

"Enable VibeHub sync"; Connection (API URL, API Token with Save / Clear / Verify); What to sync ("Agent conversations", "Terminal sessions"); Status (synced sessions, last sync, "Open VibeHub dashboard") (VibeHub).

TestFlight

Header "App Store Connect". Credentials: Issuer UUID, Key ID, Private key (.p8) + Choose…, Reset. How to use explains the "Upload to TestFlight" run action and its ${ASC_KEY_ID} / ${ASC_ISSUER_ID} / ${ASC_P8_PATH} variables.