Skip to content
Back to search

claude-status-bar

SkillWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/m1ckc3s--claude-status-bar/badge.svg)](/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

i

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)

  1. {
  2. "name": "claude-status-bar",
  3. "owner": { "name": "Mick Cesanek" },
  4. "description": "Menu bar status indicator for Claude Code.",
  5. "plugins": [
  6. {
  7. "name": "claude-status-bar",
  8. "displayName": "Claude Status Bar",
  9. "source": "./",
  10. "description": "Menu bar indicator for Claude Code: animated spark, elapsed timer, and open/close lifecycle.",
  11. "version": "0.4.5",
  12. "homepage": "https://github.com/m1ckc3s/claude-status-bar",
  13. "license": "MIT"
  14. }
  15. ]
  16. }
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)

  1. 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.
  2. 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.
  3. <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" />
  4. ## Install
  5. ### Homebrew (recommended)
  6. ```bash
  7. brew install --cask claude-status-bar && open -a "Claude Status Bar"
  8. ```
  9. The one launch at the end matters: it wires up the Claude Code hooks automatically. After that it starts itself whenever Claude Code runs.
  10. **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)**.
  11. > [!IMPORTANT]
  12. > **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.
  13. ### DMG
  14. *Signed and notarized by Apple*
  15. 1. Download the latest `ClaudeStatusBar.dmg` from [Releases](../../releases).
  16. 2. Open it and drag **Claude Status Bar** into Applications.
  17. 3. Launch it once. On first launch it wires up the Claude Code hooks for you automatically.
  18. 4. Start a new Claude Code session, the icon appears whenever Claude Code is running.
  19. ## Updating
  20. 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.
  21. 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)).
  22. ## What it shows
  23. - **Thinking / working** — the icon animates, with a live `1m 1s` timer.
  24. - **Running a tool** — a short label (`Editing`, `Reading`, `Running command`, `Using tool`, …).
  25. - **Awaiting permission** — a paused yellow dot, in both the CLI and the Desktop app.
  26. - **Idle / done** — rests on the Claude logo.
  27. Everything is controlled from the menu:
  28. - **Show timer:** toggle the elapsed `1m 1s` clock.
  29. - **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).
  30. - **Animation style:**
  31. - **Spark**, the web/chat "morph" spark
  32. - **Unicode**, the terminal glyph spinner
  33. - **Clawd™**, a pixel-art Clawd crab that scuttles while Claude works
  34. - **Orbit**, three dots that orbit, merge and breathe
  35. - **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.
  36. - **Version and update:** the menu shows your current version and tells you when an update is ready (see [Updating](#updating)).
  37. ### Where it works
  38. | Surface | Tracked? |
  39. |---|---|
  40. | Claude Code CLI (terminal) | ✅ |
  41. | Claude Code Desktop — **Code** tab | ✅ |
  42. | Cursor (Claude Code extension) | ✅ |
  43. | Claude Desktop — **Chat/Cowork** tab | ❌ |
  44. **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)**.
  45. ## How it works
  46. > [!NOTE]
  47. > 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.
  48. 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.
  49. 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)).
  50. ## Requirements
  51. - macOS 12+, [Claude Code](https://claude.com/claude-code) (CLI or the Desktop app), Node.js
  52. ## Troubleshooting
  53. See [Troubleshooting](TROUBLESHOOTING.md)
  54. ## Uninstall
  55. ```bash
  56. node "/Applications/Claude Status Bar.app/Contents/Resources/uninstall.js" # removes only our hooks
  57. brew uninstall --zap claude-status-bar # removes the app + every file it created
  58. ```
  59. Installed manually instead of via brew? Skip the second line and drag the app to the Trash.
  60. ## Acknowledgements
  61. 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.
  62. **[See the contributors →](ACKNOWLEDGEMENTS.md)**
  63. ## Trademark / Not Affiliated
  64. 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.
  65. If I'm violating or impeding your trademark, Contact me on X ([@mickces](https://x.com/mickces))
  66. This is a free side project; I'm not monetizing it.
  67. ## License
  68. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.