claude-status-bar
Menu bar status indicator for Claude Code
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/m1ckc3s--claude-status-bar)HTML
<a href="/listings/m1ckc3s--claude-status-bar"><img src="/api/listings/m1ckc3s--claude-status-bar/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Homebrew (recommended)
brew install --cask claude-status-bar && open -a "Claude Status Bar"
The one launch at the end matters: it wires up the Claude Code hooks automatically. After that it starts itself whenever Claude Code runs.
**Already using the app from the DMG?** The same command switches you to Homebrew. Your settings and hooks carry over, and the old copy cleans itself up on first launch. Full details, edge cases, and the tested upgrade matrix: **[HOMEBREW.md](HOMEBREW.md)**.
> [!IMPORTANT] > **Updated (or installed) mid-session?** Sessions already open appear the next time they do something (a prompt or a tool call). Starting a new `claude` session also works.
DMG
*Signed and notarized by Apple*
1. Download the latest `ClaudeStatusBar.dmg` from [Releases](../../releases). 2. Open it and drag **Claude Status Bar** into Applications. 3. Launch it once. On first launch it wires up the Claude Code hooks for you automatically. 4. Start a new Claude Code session, the icon appears whenever Claude Code is running.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 16 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "claude-status-bar",
- "owner": { "name": "Mick Cesanek" },
- "description": "Menu bar status indicator for Claude Code.",
- "plugins": [
- {
- "name": "claude-status-bar",
- "displayName": "Claude Status Bar",
- "source": "./",
- "description": "Menu bar indicator for Claude Code: animated spark, elapsed timer, and open/close lifecycle.",
- "version": "0.4.5",
- "homepage": "https://github.com/m1ckc3s/claude-status-bar",
- "license": "MIT"
- }
- ]
- }
README.md · README · 110 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- A tiny macOS menu bar app that shows **Claude Code's live status**: an animated Claude icon while it's thinking or running a tool, a yellow dot when it's awaiting your permission, and the elapsed time of the current turn. Lightweight, no window, no dock icon, no usage dashboards.
- Built so you can tab away during a long "thinking" stretch and still see, at a glance, whether Claude is working, waiting on you, or done.
- <img width="480" height="383" alt="Screen Recording 2026-07-10 at 12 32 23 AM" src="https://github.com/user-attachments/assets/f5d77b7c-f41d-4276-b28f-e1cf655fd323" />
- ## Install
- ### Homebrew (recommended)
- ```bash
- brew install --cask claude-status-bar && open -a "Claude Status Bar"
- ```
- The one launch at the end matters: it wires up the Claude Code hooks automatically. After that it starts itself whenever Claude Code runs.
- **Already using the app from the DMG?** The same command switches you to Homebrew. Your settings and hooks carry over, and the old copy cleans itself up on first launch. Full details, edge cases, and the tested upgrade matrix: **[HOMEBREW.md](HOMEBREW.md)**.
- > [!IMPORTANT]
- > **Updated (or installed) mid-session?** Sessions already open appear the next time they do something (a prompt or a tool call). Starting a new `claude` session also works.
- ### DMG
- *Signed and notarized by Apple*
- 1. Download the latest `ClaudeStatusBar.dmg` from [Releases](../../releases).
- 2. Open it and drag **Claude Status Bar** into Applications.
- 3. Launch it once. On first launch it wires up the Claude Code hooks for you automatically.
- 4. Start a new Claude Code session, the icon appears whenever Claude Code is running.
- ## Updating
- The menu tells you when an update is ready. Installed via brew, it shows **Update via brew** with a copy button (paste the command in your terminal); it appears once Homebrew can actually deliver the new version, which can lag a release by up to a day. Installed via DMG, **Update available** opens the releases page, plus a one-click **Switch to Homebrew** option.
- Or just run `brew upgrade --cask claude-status-bar` (brew), or download the latest DMG and drag it into Applications (manual). Hooks refresh themselves on the next launch; nothing to run by hand. **Upgrading from 0.3.x via DMG? Launch the app once after dragging**, that's what retires the old-named copy ([details](HOMEBREW.md#faq--troubleshooting)).
- ## What it shows
- - **Thinking / working** — the icon animates, with a live `1m 1s` timer.
- - **Running a tool** — a short label (`Editing`, `Reading`, `Running command`, `Using tool`, …).
- - **Awaiting permission** — a paused yellow dot, in both the CLI and the Desktop app.
- - **Idle / done** — rests on the Claude logo.
- Everything is controlled from the menu:
- - **Show timer:** toggle the elapsed `1m 1s` clock.
- - **Show text:** show the status label next to the icon (`Manifesting…`, `Percolating…`, `Editing`, `Running command`), or turn it off for an icon-only menu bar (on by default).
- - **Animation style:**
- - **Spark**, the web/chat "morph" spark
- - **Unicode**, the terminal glyph spinner
- - **Clawd™**, a pixel-art Clawd crab that scuttles while Claude works
- - **Orbit**, three dots that orbit, merge and breathe
- - **Icon color:** **Orange** or **System** (adaptive black/white). All four styles follow this setting: in System mode Clawd™ renders as a shaded monochrome silhouette that matches the menu bar.
- - **Version and update:** the menu shows your current version and tells you when an update is ready (see [Updating](#updating)).
- ### Where it works
- | Surface | Tracked? |
- |---|---|
- | Claude Code CLI (terminal) | ✅ |
- | Claude Code Desktop — **Code** tab | ✅ |
- | Cursor (Claude Code extension) | ✅ |
- | Claude Desktop — **Chat/Cowork** tab | ❌ |
- **Multi-session support.** When several Claude Code sessions run at once (multiple terminals, or a terminal plus the desktop app), the menu bar surfaces the highest-priority one: a session awaiting your permission is never hidden behind one that's thinking. The dropdown lists every live session. Precise per-tab focus is in progress: **[issue #19 →](https://github.com/m1ckc3s/claude-status-bar/issues/19)**.
- ## How it works
- > [!NOTE]
- > You don't open this app; it opens itself when a Claude Code session starts, and quits when none is running. The only manual launch is the very first one after install, to set up the hooks. Opened by hand with no session active, it quits again after a few seconds. That's normal.
- The app is stateless. Claude Code fires hooks as it works; the app polls those updates and aggregates them across every live session into a single icon, a permission dot if one needs you, animating if any session is working, resting when all are idle. It launches itself when Claude Code opens and quits when nothing's running, so there's nothing to manage.
- The installer merges its hooks into `~/.claude/settings.json` (backing it up first), and the app's only network activity is a once-a-day update check against GitHub's and Homebrew's public APIs ([details](PRIVACY.md)).
- ## Requirements
- - macOS 12+, [Claude Code](https://claude.com/claude-code) (CLI or the Desktop app), Node.js
- ## Troubleshooting
- See [Troubleshooting](TROUBLESHOOTING.md)
- ## Uninstall
- ```bash
- node "/Applications/Claude Status Bar.app/Contents/Resources/uninstall.js" # removes only our hooks
- brew uninstall --zap claude-status-bar # removes the app + every file it created
- ```
- Installed manually instead of via brew? Skip the second line and drag the app to the Trash.
- ## Acknowledgements
- I built this for myself, then open-sourced it because other people might find it handy too, and I'm genuinely thrilled that so many of you do. An extra thank-you to everyone who went the extra mile and contributed code, fixes, and ideas.
- **[See the contributors →](ACKNOWLEDGEMENTS.md)**
- ## Trademark / Not Affiliated
- This is an unofficial, open-source side project. **It is not affiliated with, endorsed by, or sponsored by Anthropic.** "Claude" and the Claude spark logo are trademarks of Anthropic, used here nominatively. This project is MIT licensed, but that covers the source code only and conveys no rights to Anthropic's trademarks or brand.
- If I'm violating or impeding your trademark, Contact me on X ([@mickces](https://x.com/mickces))
- This is a free side project; I'm not monetizing it.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.