Set up Trilbio and get the most out of it.

From installing to answering your first prompt from the menu bar, plus what every part of the panel means.

Requirements

  • A Mac with macOS 26 (Tahoe) or later
  • Claude Code installed and used at least once, so the Claude folder exists
  • For limits: a recent Claude Code version that passes usage limits to the status line

Set up in two minutes

  1. Install Trilbio

    Download Trilbio from the Mac App Store and open it. It has no Dock icon: it lives in your menu bar as a small agent with a hat.

  2. Choose your AI

    Onboarding asks which AI you work with. Pick Claude Code. Codex, Gemini CLI and Cursor are shown as coming soon.

Trilbio onboarding, step 1 of 4: Which AI do you work with? Claude Code is available; OpenAI Codex, Gemini CLI and Cursor agents are marked Soon.
Choose your AI.
  1. Give access to your Claude folder

    macOS asks you to pick your Claude folder, usually ~/.claude in your home folder. This is the only folder Trilbio can read.

  2. Connect Claude Code

    Click Connect. Trilbio adds its plugin to Claude Code's settings so sessions report to Trilbio. Tick the box for limits if you want your 5-hour and weekly usage in the panel. Claude Code picks the plugin up by itself; new sessions report right away.

Trilbio onboarding, step 3: Connect Claude Code for the Personal profile. It explains the Trilbio plugin, has a ticked Show my usage limits checkbox, mentions a backup of your settings, and a Connect Claude button.
Connect Claude Code, with or without limits.
  1. Find Trilbio in the menu bar

    Trilbio shows you where its icon lives and asks whether it may open when you log in. Click the icon, or set a keyboard shortcut in Settings, to open the panel.

Trilbio onboarding, last step: You're all set. A drawing of the menu bar with an arrow to Trilbio's agent icon showing 2 active agents, an Open Trilbio when I log in switch turned on, and a Start using Trilbio button.
Done: Trilbio shows where it lives in your menu bar.

The panel

Click the menu bar icon to open the panel. From top to bottom:

  • Header: buttons for Activity, Keep awake and Settings.
  • Per profile: your plan with limit tiles, or a spend line.
  • Keep-awake banner: whether your Mac is being kept awake, and why.
  • Needs you (amber), Working (green) and Idle (grey ring) sessions, each with project, branch and duration.
  • Collapsed lines for sessions idle for a long time and sessions that ended, which open in place.
  • The week strip ("See activity").

The menu bar icon carries a dot: amber when something needs you, green while agents work, none when it's quiet, plus the number of active agents. Click a session for its detail page, with a button to show it in the terminal or continue it.

Answering prompts

When Claude asks for permission or asks a question, Trilbio shows a notification (for Allow / Deny) or its own card (for questions with options). In Settings you choose when Trilbio takes over prompts: always, when I'm not in that terminal (default) or never. If you don't answer in Trilbio, the normal prompt in the terminal still works. See needs-you alerts.

Limits

If you ticked limits while connecting, Trilbio wraps your status line: it reads the usage numbers Claude Code passes to it and then runs your own status line as before. Set the alert threshold in Settings. See usage limits.

Trilbio's menu bar panel in the Night Glass theme. Personal profile: session limit 62% (resets 2:00 PM) and weekly limit 38% (resets Friday 5:12 PM). Work profile: $8.88 today, $41.30 this week. A green banner says the Mac stays awake, with a Screen off button. Needs you: Add Apple Pay to checkout (wants approval) and Fix flaky invoice tests (asks a question). Working: three sessions in ios-companion, billing-api and docs-site. Idle: Update pricing page copy. A week strip shows 54.8 hours of agent time.

Keep awake

Open Keep awake from the panel header. Choose Off, While agents run or Always, then set the guards: on battery, heat, grace period and maximum duration. Screen off darkens the display while your agents keep working; your Mac locks as set in Lock Screen settings. If that doesn't work on your Mac, press Control Shift + power button, or lock with Control Command Q. See keep your Mac awake.

Activity

Open Activity from the panel header or the week strip. "This week" shows a day-by-hour heatmap; "Last 4 weeks" a block per day and time per project. See activity.

Trilbio keep-awake settings set to While agents run, awake while 5 agents work. Lid open: keep the display on (off) and a Screen off button, with shortcuts Control Shift plus power button and Control Command Q. Lid closed: coming soon. On battery: also keep awake, stop below 20%. Safety: pause when the Mac runs hot, allow sleep 5 minutes after agents finish, never stay awake longer than 4 hours.

Several Claude profiles

If you run Claude Code with more than one configuration folder (for example personal and work via CLAUDE_CONFIG_DIR), add each folder in Settings, Profiles. Every profile gets a colour that shows on its sessions, limits and activity, and you can filter by profile or project. Free includes two accounts; Pro has no limit. Cowork tasks from the Claude app can be shown read-only and don't count as an account.

Trilbio settings, Profiles: Add a Claude profile, with OpenAI Codex, Gemini CLI and Cursor agents marked coming soon. Free includes 2 accounts. Colours: Personal is teal and Work is violet, chosen from seven colours.

Terminals

"Show in terminal" brings a running session forward; "Continue in terminal" runs claude --resume in the right folder and profile. Choose your terminal in Settings: Terminal, iTerm, Ghostty or Warp. You can always copy the resume command instead.

Disconnect

In Settings, Profiles, choose Disconnect. Trilbio removes its plugin from Claude Code's settings and restores your original status line. Deleting the app after that leaves nothing behind in your Claude setup.

Troubleshooting

A session doesn't show up

Sessions report to Trilbio from the moment they start after connecting. Sessions that were already running show up from their transcript, with less detail, until you restart them.

No needs-you alerts

Check that notifications for Trilbio are allowed in System Settings, Notifications, and that "take over prompts" isn't set to never. If you're in the terminal where the agent runs, Trilbio stays quiet on purpose.

Limits are empty

Limits appear after Claude Code's next status line update, so send a message in a session. Make sure limits were ticked when connecting, and that your Claude Code version is recent.

Still stuck? Email support@trilbio.com.

Let your agents work. Trilbio keeps watch.

Free to download, every Pro feature free for the first 7 days, then a one-time €12.99 if you want to keep them. Nothing is charged automatically.

Coming soon to the Mac App StoreRead the setup guide

Requires macOS 26 or later. Works with Claude Code today; Codex, Gemini CLI and Cursor are coming.