Claudio app icon

Claude Code,
on your desk.

Claudio is a small AMOLED display that shows your usage limits, every open session and what each one is doing. A menu bar app on your Mac keeps it up to date.

Download for Mac Learn more

macOS 14 or later on Apple silicon.

Sessions: open Claude Code sessions and what each one is doing Usage: the 5-hour and weekly limits Today: messages per hour Stats: a 26-week heatmap
Sessions

Every session,
at a glance.

One row per open Claude Code session, with the project, its title, the git branch and what it's doing right now: editing, running a command, two agents working. Sessions waiting on you go on top, in orange.

Sessions screen with five sessions, one waiting for input
Limits and history

Know where your
limits stand.

Swipe or tap a button to move between workspaces. Usage shows the 5-hour and weekly limits and when each resets. Today charts your messages hour by hour. Stats keeps 26 weeks of history, the same numbers as /stats.

Usage screen
Usage. 5-hour and weekly limits.
Today screen
Today. Messages per hour.
Stats screen
Stats. 26 weeks of activity.

Clawd lets you know when Claude needs you.

When Claude Code asks a question or wants a permission, Clawd walks onto the screen and points at the session, and the message scrolls along the bottom. When a long task finishes, he comes back to dance. While sessions work, the Clawd in the corner types, searches and thinks along with them.

Clawd pointing at a session that needs input Clawd animation on the splash screen
Mac app

Lives in your menu bar.

Click Clawd in the menu bar for the same usage, sessions and today's activity, plus the full heatmap. Claudio reads the token Claude Code already keeps in your Keychain, so there's nothing to log in to.

Menu bar panel with usage, sessions and today's activity
Activity tab with the 26-week heatmap
Setup

A welcome guide
does the hard part.

The first time you open Claudio, it flashes the latest firmware over USB, helps you pair the display over Bluetooth and installs the Claude Code hooks that feed sessions and alerts. Flashing again later keeps your pairing and settings.

Welcome guide step that flashes the display
⌨️

Buttons that type

Hold the left button for push to talk. The right one sends Shift+Tab, Claude Code's mode toggle. The display pairs as a Bluetooth keyboard, so the keys go to whatever window has focus.

🪝

Hooks that leave yours alone

Claudio adds its own hooks to ~/.claude/settings.json, keeps the ones you already have and backs up the file first.

🔔

Beeps and chimes

An optional beep on alerts, and a chime when the 5-hour limit resets, on boards with a speaker.

🔄

Updates from the menu bar

Settings checks for new firmware and flashes it over USB.

🧩

Seven boards

Built and tested on the Waveshare ESP32-S3 AMOLED 2.16. Six other Waveshare boards build too, though only the 2.16 is checked against the current screens.

🐧

Linux and Windows

On Linux, a small bash daemon feeds the display. On Windows, a daemon shows usage only.

Get started.

2

Install Claudio

With Homebrew, or download the app.

3

Follow the guide

Open Claudio. It flashes the display, pairs it and installs the hooks.

brew install --cask eduardoborges/tap/claudio

You need Claude Code, logged in to a paid plan.