All pages

Lesson 1.1 · Get set up · 8 min

Install and sign in

Download TRMNLY, get your account approved, and grant the permissions it asks for.

Listen

By the end of this lesson TRMNLY is installed on your Mac, signed in to an approved trmnly.dev account, and holding the macOS permissions its features need.

Time: 8 minutes · Works on: macOS app

Check your Mac

TRMNLY runs on macOS 15 or later. Linux and Windows have a separate GTK build with a smaller feature set; this course follows the macOS app.

Download and install

  1. Open trmnly.dev/download in your browser. It always serves the newest stable build as a disk image (.dmg).
  2. Open the downloaded disk image.
  3. Drag TRMNLY into Applications.
  4. Open TRMNLY from Applications or Spotlight.

Tip: Install and update TRMNLY only from the disk image or the in-app updater. A copy made some other way can lose the signature macOS uses to remember your permission grants, and you would have to grant them again.

Sign in

TRMNLY is in private testing. Accounts are invite-only: request access at trmnly.dev/request-access and wait for the email saying your address is approved before you sign up. A release build then opens only for a trmnly.dev account that has been approved, so the first window you see is Sign in to use TRMNLY, before any terminal.

  1. Choose one of the two buttons:
    • Continue with GitHub copies a one-time code to your clipboard and opens GitHub's device page. Paste the code there and authorize.
    • Sign in with trmnly.dev opens a pairing page in your browser. Create an account or log in, then confirm the code the window shows.
  2. Go back to TRMNLY. If your account is new, the window now reads Waiting for approval and shows the address you signed in with.
  3. Leave the window open. It checks every 30 seconds and unlocks on its own once your account is approved. Check Now checks immediately, and Use a Different Account starts over.

Once you're in, TRMNLY renews your access in the background. It needs to reach trmnly.dev at least once every 7 days. If it can't, the window reads TRMNLY can't confirm your access with a Try Again button.

Take the first-run tour

The first time the terminal opens, a short tour walks through the main surfaces: tabs and splits, the agent, the posture chip, prompts, connections, plugins, the command palette and the Help tab.

  1. Step through the tour, or close it.
  2. To see it again later, choose Help → Show First-Run Tour.

Grant permissions

Several features need macOS privacy permissions: driving other apps, screenshots, dictation, notifications. TRMNLY shows their state in one place.

  1. Open Settings with ⌘,.
  2. Choose the Permissions pane.
  3. Read the status pill on each row: Accessibility, Automation (Apple Events), Microphone, Notifications, Screen Recording and Full Disk Access. Each reads Granted, Denied, Not requested or Unknown.
  4. For a row you need, press Request where it's offered, or Open in System Settings… to go straight to the right pane in Privacy & Security.
  5. Press Refresh status to re-read the grants. The pane also refreshes when TRMNLY comes back to the front.

You don't need every grant on day one. Grant Accessibility and Screen Recording when you start using the agent on other apps or screenshots.

Tip: macOS applies Screen Recording only to a newly launched process. After you allow it, quit and reopen TRMNLY.

Stay up to date

TRMNLY updates itself in the background. To check now, choose TRMNLY → Check for Updates.... The Updates pane in Settings picks the channel.

Check yourself

  • TRMNLY opens to a terminal instead of the sign-in window.
  • Help → Show First-Run Tour replays the tour.
  • Settings → Permissions shows a status for each of the six permissions.

Go further