Meet your pixel cat companion: it lives in your menu bar, keeps tabs on your coding agents, alerts you when they're waiting on you, and tracks your usage limits.Supports
Claude Codeand
Codex
$ curl -fsSL https://raw.githubusercontent.com/kushalBanda/OpusBar/main/scripts/install.sh | bashFree and open source · macOS 14 or later · Apple silicon and Intel
Prefer a disk image? Download the DMG
1 needs you · 4 active
Attention 1
payments-api
Needs you · Allow Bash?
Active 4
design-system
Done Plan
web-app
Working · Edit Accept edits
infra
Working · shell
ml-pipeline
Thinking
Sample sessions
AI coding agents are great at parallel work. You might have one refactoring code in one terminal, another fixing tests, and a third migrating your codebase. The challenge is knowing when one of them needs your attention.
OpusBar solves that with a tiny pixel cat in your menu bar. It keeps an eye on your agents, surfaces the one that needs you most, and lets you know when it’s time to step in.
More agents working. One place to know when they need you.
Working
The agent is busy: editing files, running tests, using the shell. The cat runs while it works.
The agent is planning its next move. Nothing for you to do yet, so the cat cleans its paws.
The agent stopped to ask permission or answer a question, and it will not continue until you reply. The cat sits up, a badge counts the waiting sessions, and a notification names which one.
The agent finished and is waiting for your next instruction. The cat naps. A notification for finished sessions is optional and off by default.
The agent hit an error and stopped. You get a notification, and the badge stays until you look.
No agent session is running. The cat sits and waits, and stops animating so it uses no CPU.
Narrated, so turn the sound on.
Claude and Codex cap how much you can use in a 5-hour window and a weekly one. OpusBar shows what is left for every account, read from your agents' own logs. Your history is there on first launch.
Work and personal profiles each get their own bars. Claude and Codex figures refresh after every reply. If your pace would use up a limit before it renews, the card says when it runs out.
Claude Codework
Claude Codepersonal
Codex
Sample data
You get a notification at 80% and 95% of a window used, and another when the window resets.
OpusBarnow
Claude Code limit 80% used
5-hour window · resets in 1h 12m
OpusBar2h ago
Your Claude Code window renewed
5-hour window · 100% left
Tokens over the last 24 hours, 7, 30 or 90 days, by agent, account, model and project. The API value shows what they would cost at list prices: the value your plan covers.
API value Claude Code Codex
$2,815 8.9B tokens
Sample data
Twenty-one cats, from the original 1989 oneko to Catppuccin and Vaporwave. Click one and every cat on this page changes. In the app you can also choose the pose for each state and the cat's size.
No account, no telemetry, no analytics. Your code and prompts never leave your machine. Here is exactly what OpusBar touches.
.git/HEAD, for the folder and the branch name.~/Library/Application Support/OpusBar.The hook has a 200 ms deadline and exits quietly when OpusBar is not running, so your agents never wait on it.
Paste this into Terminal. It downloads the latest release, verifies its SHA-256 checksum, installs OpusBar in Applications and opens it. Read the script first if you like.
$ curl -fsSL https://raw.githubusercontent.com/kushalBanda/OpusBar/main/scripts/install.sh | bash/hooks once and approve OpusBar's hooks.Download the DMG Star on GitHub
The DMG is not notarized by Apple yet. Open the app once, then go to System Settings › Privacy & Security and click Open Anyway. The Terminal install skips this step.
Yes. OpusBar is free and open source under the Apache 2.0 license. There is no account and no paid tier.
Claude Code and Codex, in any terminal, tmux pane or editor. Running agents show up within 30 seconds, even before you connect anything. Connect them in Settings and the cat also knows what each session is doing. Codex needs version 0.155 or later for hooks.
No. Everything stays on your Mac. The hook drops your prompts, code and replies before they reach OpusBar. The only network request is a daily update check to GitHub that carries OpusBar's version, and you can turn it off in Settings › About.
Yes. It shows your 5-hour and weekly windows for every Claude Code and Codex account, with the time each one resets, and warns at 80% and 95%. Claude limits appear after the first reply in a connected session.
No. The menu bar cat never draws more than 4 frames a second, stops 30 seconds after the last change, and holds still when Reduce Motion is on. Once still, it uses no CPU.
On a MacBook with a notch, a crowded menu bar hides items behind it. Hold ⌘ and drag other icons out of the menu bar to make room.
In Settings › Agents, click Disconnect for each agent first. This removes the hooks and puts your own status line back. Then quit OpusBar and drag it to the Trash. Optionally, delete ~/Library/Application Support/OpusBar.