GitHub - titojankowski/claude-status: Tiny macOS menu bar app showing status.claude.com as a green/yellow/red dot · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
titojankowski
claude-status
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>4 Commits<br>4 Commits
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
build.sh
build.sh
main.swift
main.swift
View all files
Repository files navigation
Claude Status
A tiny macOS menu bar app that shows the current status of status.claude.com as a colored dot.
◯ hollow ring — all systems operational. Drawn as a template image, so AppKit<br>tints it to match the menu bar: black in light mode, white in dark mode.
🟡 filled yellow — minor issue or maintenance
🔴 filled red — major or critical outage
⚫️ filled gray — the status check itself failed (offline, etc.)
Only trouble is a filled dot, so a healthy status stays visually quiet.
Click the dot for a breakdown: overall description, every component with its own status,<br>any active incidents (click to open the status page), and the time of the last check.
Polls every 60 seconds, plus an immediate re-check when the Mac wakes from sleep.
Build
./build.sh # produces ClaudeStatus.app<br>open ClaudeStatus.app
Single-file Swift, no dependencies. Requires macOS 13+ and the Xcode command line tools.
Hide when everything is fine
If even the hollow ring is too much, Settings → Hide When All Systems Operational<br>removes it from the menu bar entirely while status is green, so the app only appears<br>when something is actually wrong.
A gray "check failed" status still shows — silence should never be mistaken for health.
Since a hidden app has no menu to click, there are two ways back:
Launch the app again (double-click it in Finder). The dot reappears for 15<br>seconds so you can open the menu, then hides itself again.
From the command line:<br>ClaudeStatus.app/Contents/MacOS/ClaudeStatus --hide-when-green # show setting<br>ClaudeStatus.app/Contents/MacOS/ClaudeStatus --hide-when-green off # bring it back
A running app picks this up on its next poll, within 60 seconds.
Start at login
Settings → Start at Login in the app's menu. If macOS parks the request behind an<br>approval, the app opens the Login Items pane in System Settings for you.
You can also toggle it from the command line:
ClaudeStatus.app/Contents/MacOS/ClaudeStatus --login-status<br>ClaudeStatus.app/Contents/MacOS/ClaudeStatus --login on<br>ClaudeStatus.app/Contents/MacOS/ClaudeStatus --login off
How it works
Reads the standard Statuspage summary endpoint:
https://status.claude.com/api/v2/summary.json
The menu bar dot maps status.indicator (none / minor / major / critical /<br>maintenance) to a color; each row in the menu maps that component's own status<br>(operational / degraded_performance / partial_outage / major_outage /<br>under_maintenance) the same way.
License
Public domain — the Unlicense. No copyright. Clone it, fork it,<br>modify it, ship it, sell it, no attribution needed. See LICENSE.
About<br>Tiny macOS menu bar app showing status.claude.com as a green/yellow/red dot<br>Resources<br>Readme<br>Unlicense<br>Activity<br>Stars<br>0 stars<br>Watchers<br>0 watching<br>Forks<br>0 forks<br>Report repository
Releases
Packages
Contributors
Languages
You can’t perform that action at this time.