Claude Code theme

claude-status

A macOS menu bar app and desktop widget for monitoring Claude Code sessions.

65 stars 20 forksThemes & HUDs Source

Install

From source
git clone https://github.com/gmr/claude-status.git

From the README

Claude Status

A native macOS menu bar app that monitors all your Claude Code sessions in one place. See what every session is doing at a glance and jump to any one with a click.

Download the latest release from the Releases page.

Features

- Real-time status indicator — A small indicator in your menu bar shows the aggregate state across all sessions: active, waiting for input, compacting context, or idle. Choose between emoji indicators or minimal colored dots.
- One-click session focusing — Click a session in the dropdown or a desktop widget to focus its exact window, tab, or pane. Works with VS Code, Zed, Xcode, JetBrains IDEs (IntelliJ IDEA, PyCharm, WebStorm, GoLand, CLion, RubyMine, Rider, PhpStorm, DataGrip, DataSpell), iTerm2 (with tab and window-specific AppleScript focusing), Terminal, Warp, Alacritty, Kitty, WezTerm, Ghostty, and tmux (automatic window and pane selection with any supported terminal).
- Usage analytics — Tracks time spent in each session state and session concurrency throughout the day. See your daily usage summary and concurrency counts in the menu bar dropdown and desktop widgets.
- Session naming — Use the /name-session slash command to label sessions with meaningful names like "API Refactor" or "Bug Fix #421". Names show up in the menu bar and widgets so you always know which session is which.
- Desktop widgets — Multiple native WidgetKit widgets show session status, usage analytics, and concurrency at a glance on your desktop.
- Launch at login — Runs quietly in the menu bar with no dock icon. Configure everything from a simple settings window.

Session States

Install

Download the latest release from the Releases page. Move Claude Status.app to /Applications and launch it.

On first launch, the app will prompt to install the Claude…
Read the full README on GitHub

Details

Language
Swift
License
BSD-3-Clause
Last updated
29 July 2026

FAQ

What is claude-status?

A macOS menu bar app and desktop widget for monitoring Claude Code sessions. It is a theme for Claude Code, from gmr/claude-status on GitHub.

How do I install claude-status?

Clone gmr/claude-status from GitHub and follow the setup steps in its README.

Is claude-status popular?

gmr/claude-status has 65 GitHub stars and 20 forks, and is included in 1 curated Claude Code list. It was last updated on 29 July 2026.

More themes & huds

Browse the most popular Claude Code mods, all themes & huds, or the skills and MCP server directories.