macOS
Homebrew Caskverified · 100%
brew install --cask claude-status-barlocal Homebrew cask metadata
cask
Install claude-status-bar with Homebrew Cask
Menu bar status indicator for Claude Code. Version 0.4.5 via Homebrew Cask; verified from local package data.
install
Additional install commands
overview
Package summary
Menu bar status indicator for Claude Code
Project links
Commands and aliases
No executable aliases were found in the local package database.
history
Project history and usage
Claude Status Bar is an unofficial open-source macOS menu-bar companion for Claude Code. It displays current activity, elapsed time, tool activity, and permission-waiting state without opening a separate window.
Project history
Claude Status Bar was created by Mick C as a small native macOS utility for seeing whether Claude Code is working, waiting for permission, or idle while another application has focus.
The project was subsequently open-sourced under the MIT license and developed support for multiple simultaneous Claude Code sessions, selectable animation styles, timers, update checks, and automatic hook management.
Adoption history
The author initially built the utility for personal use and later released it as an open-source side project. Homebrew is the recommended installation method, while a signed and notarized DMG is also available.
The application supports Claude Code running in terminals, the Claude Code Desktop code surface, and Cursor's Claude Code extension, giving it relevance across several common macOS development workflows.
How it is used
After installation, users launch the application once so it can merge its hooks into Claude Code's settings. It subsequently launches when Claude Code runs and exits when no sessions remain.
The menu-bar item can show an activity animation, elapsed timer, current tool category, and a yellow permission indicator; menu controls select animation and icon styles.
Why package nerds care
Claude Status Bar turns Claude Code's hook events into ambient macOS state without adding a dashboard or persistent window. Its self-installing hook integration and lifecycle—starting with an active Claude session and quitting when none remain—make it a focused example of a native companion utility distributed through Homebrew Cask.
Timeline
- 2026: Version 0.4.4 was distributed by the Homebrew cask represented in the input record.
- 2026: The project documented automatic hook installation, multi-session aggregation, and both Homebrew and notarized-DMG distribution.
Related projects
- Claude Code provides the hook events consumed by the application.
- Homebrew Cask is the recommended package distribution channel.
Sources
- Official README: https://github.com/m1ckc3s/claude-status-bar#readme
- Official releases: https://github.com/m1ckc3s/claude-status-bar/releases
- source_facts.provenance
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for claude-status-bar. Package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
~/.claude/settings.json
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
| No executable data was present. | |||
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-11-04
manager version0.4.5
manager updated
local dataok
upstreamnot checked
latest detectednot detected
https://github.com/m1ckc3s/claude-status-bar
- infoNo package-manager update timestamp was available.low confidence
- infoNo cached GitHub release or tag data was available.https://github.com/m1ckc3s/claude-status-barnone confidence
install metadata
Package metadata
| Package key | cask:claude-status-bar |
|---|---|
| Version | 0.4.5 |
| Package manager | Homebrew Cask |
| Package manager page | https://formulae.brew.sh/cask/claude-status-bar |
| Homepage | https://github.com/m1ckc3s/claude-status-bar |
| Repository | https://github.com/m1ckc3s/claude-status-bar |
| Source archive | https://github.com/m1ckc3s/claude-status-bar/releases/download/v0.4.5/ClaudeStatusBar.dmg |
| SHA-256 | dc42a480a86288b3a5ffd65d4f905460608b3fd25600efe5704b59275cb643eb |
| Bottle | not recorded |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew cask API |
|---|---|
| Tap | homebrew/cask |
| Full Token | claude-status-bar |
| Names |
|
| Depends On | |
| Artifacts | |
| Deprecated | no |
| Disabled | no |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment