---
url: https://al-mo.de/apps/claude-status-bar/
title: Claude Status Bar — Your Claude Code usage, in your panel or tray.
description: A usage meter for Claude Code that lives in your panel or tray — both rate limits, with countdowns to reset. Native on Linux, Windows, and macOS.
---

Linux · Windows · macOS

# Claude Status Bar

Your Claude Code usage, in your panel or tray.

A usage meter for Claude Code that lives in your panel or tray — both rate limits, with countdowns to reset. Native on Linux, Windows, and macOS.

[Download](https://github.com/mkalmousli/ClaudeStatusBar/releases/latest)[View source](https://github.com/mkalmousli/ClaudeStatusBar)

![Claude Status Bar](https://al-mo.de/assets/mirror/ClaudeStatusBar-screenshots-gui.png)

## Available on

[GitHub Releases](https://github.com/mkalmousli/ClaudeStatusBar/releases)

## See how it works

![Claude Status Bar — Both limits, always in view](https://al-mo.de/assets/mirror/ClaudeStatusBar-screenshots-gui.png)

01

### Both limits, always in view

The 5-hour and weekly limits as live percentages, with exactly how long until each resets.

![Claude Status Bar — A tiny meter in your panel](https://al-mo.de/assets/mirror/ClaudeStatusBar-screenshots-xfce4-plugin.png)

02

### A tiny meter in your panel

The same numbers as a compact bar in your XFCE panel or tray: 5h, weekly, percent and countdown at a glance.

![Claude Status Bar — Every session, side by side](https://al-mo.de/assets/mirror/ClaudeStatusBar-screenshots-sessions.png)

03

### Every session, side by side

See each Claude Code session's own reading and model, and click a heading to sort. Resume a session with a double-click.

![Claude Status Bar — Make it yours](https://al-mo.de/assets/mirror/ClaudeStatusBar-screenshots-settings.png)

04

### Make it yours

Meter height, icon, and colour bands that shift from green to red as you approach the limit.

![Claude Status Bar — Honest about itself](https://al-mo.de/assets/mirror/ClaudeStatusBar-screenshots-about.png)

05

### Honest about itself

Version, license (GPL-3.0-or-later), source and where to report bugs — and it only reads files Claude Code already writes on your machine.

## Why you'll like it

01

### Both limits at a glance

5-hour and weekly usage, always visible.

02

### No terminal needed

Everything is visible from the tray or panel icon.

03

### Cross-platform

Native xfce4-panel plugin, plus a tray icon on KDE/GNOME/Windows/macOS.

What it's built with, and why

## What it's built with, and why

Kotlin Single codebase for the tray logic and the native xfce4-panel plugin binding.

xfce4-panel plugin API (C bindings) Only reliable way to embed a live widget natively in an XFCE panel.

System tray protocols (Windows/macOS/KDE/GNOME) Each desktop exposes usage differently — this abstracts over all of them.

Claude Code's local usage data Reads rate-limit state directly, no network calls or extra permissions needed.

Recent activity

## Recent activity

- [53b3542](https://github.com/mkalmousli/ClaudeStatusBar/commit/53b354236d6d6a5fc6202f85e4a833bd7ec01427) Add logo, social preview and a more presentable README
- [e8288b0](https://github.com/mkalmousli/ClaudeStatusBar/commit/e8288b06d17a0a192d5196985c48bfb5a42d52b7) Add demo screenshots to the README
- [84fd40c](https://github.com/mkalmousli/ClaudeStatusBar/commit/84fd40c91f186af0c4711bbc5120d0daff70f98a) Rewrite in C with a GTK3 GUI, prebuilt releases and auto-update

Version **v2.0.0**

Platforms

Linux Windows macOS

License **[GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.html)**

## Related articles

- [Claude Status Bar: your Claude Code limits, always visible](https://al-mo.de/blog/claude-status-bar/): A usage meter that shows both rate limits and the countdown to each reset, in your Xfce panel or system tray.

Enjoying this project? [Support my open-source work](https://al-mo.de/donate/)

License: [GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.html)