All pages
Lesson 7.4 · Beyond the Mac · 8 min
Your account, credits and keys
GitHub access, the credit wallet, and what it meters.
After this lesson, you can tell which GitHub account you're connected as and whether TRMNLY can reach your repositories. You'll also know what credits pay for, how to buy them, and what never costs credits.
Time: 8 minutes · Works on: all
One account, three things
Your trmnly.dev account holds three things: your sign-in, your credit balance, and the devices you've paired, such as your Mac and your iPhone. On the Mac, all of it shows in Settings → Account. Press ⌘, and choose the Account tab.
If the tab says Pair this Mac to see your account., press Pair… and confirm the code on trmnly.dev.
Check your GitHub connection
GitHub plays two separate roles, and doing the first does not do the second.
- GitHub sign-in proves who you are. It's what "Continue with GitHub" does on trmnly.dev.
- Repository access lets TRMNLY read and push to your repositories. It comes from installing the TRMNLY GitHub App on the account or organization that owns them.
Signing in with GitHub and never installing the app is common. It looks fine until something needs a repository, such as a clone into the cloud workspace, and then fails.
- In Settings → Account, find the GitHub section. It has two rows, GitHub sign-in and Repository access.
- Read GitHub sign-in. A
@namemeans that account is linked. If it reads Not linked, press Link on trmnly.dev…. - Read Repository access:
- @name · All repositories reaches everything on that account.
- @name · 3 selected repositories reaches only those three. Manage… changes the selection on GitHub.
- No repositories selected means the app is installed but reaches nothing. Fix it with Manage…, not by reinstalling.
- If it isn't installed, Install GitHub App… opens GitHub.
- If you see Couldn't load GitHub status, press Retry. That message means the check failed. It doesn't mean nothing is linked.
The section checks again whenever you switch back to TRMNLY. So after installing the app in your browser, return to TRMNLY and the row updates.
The same two rows appear in the iPhone app's Account screen and on your trmnly.dev dashboard. From any terminal, trmnly account prints them.
What credits pay for
Credits pay for the cloud workspace. One credit is one minute of cloud workspace, counted only while a terminal is attached. Partial minutes round down. Credits don't expire. New accounts start with 100 credits, about an hour and a half.
On the Mac, the agent runs on the API keys you supply. Each request goes straight from your Mac to the model provider, and those turns don't spend credits. If your balance hits zero, the agent keeps running on your own keys.
Buy credits
Packs lower the hourly rate:
| Pack | Credits | Cloud hours | Per hour |
|---|---|---|---|
| $5 | 600 | 10 | $0.50 |
| $20 | 2,700 | 45 | $0.44 |
| $50 | 7,500 | 125 | $0.40 |
- Sign in at trmnly.dev. Your dashboard shows your balance and the packs.
- Press Buy on a pack. Checkout is a hosted Stripe page in your browser, not an App Store purchase.
- On the Mac, Settings → Account shows your balance under Credits remaining. Buy Credits there opens the same purchase.
Tip: The pricing page also lists a $99/month always-on workspace. It isn't available to buy yet.
Where your keys live
Model API keys, such as your Anthropic or OpenAI key, go in Settings → API Keys. They're stored in the macOS Keychain. They're never written to your config file and never included when you export settings.
The device token that pairs your Mac to trmnly.dev is also kept in the Keychain. Forget in Settings → Account stops showing your balance on this Mac. It doesn't unpair the Mac. Unpairing lives in Settings → AI Agent, under Remote Control (trmnly.dev), and it signs TRMNLY out.
Keys the agent or your scripts need, such as a deploy token, belong in the Keys vault, covered in Access keys. The vault lets the agent use a credential without ever seeing its value.
Check yourself
- Settings → Account shows your
@nameunder GitHub sign-in. - Repository access names the account that owns the repository you work on most.
- You can say what your current balance would buy in cloud workspace hours.
- Running
trmnly accountin a pane prints the same GitHub rows as Settings.
Go further
- Account & GitHub: every status the two rows can show, and signing in from Linux or Windows.
- The cloud workspace: what you spend credits on.
- Connect a model: adding the API keys the agent runs on.