SDanker

Iauso — Development skill for Claude Code

Development community

Claude and Codex usage quota on a Waveshare e-ink display, driven by a Raspberry Pi.

How to install Iauso

This entry records only its repository, not the path inside it, so there is no exact command to give. Open SDanker/iauso and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Iauso does

Claude and Codex usage quota on a Waveshare e-ink display, driven by a Raspberry Pi. Optional self-hosted API so several screens share one set of queries.

Alternatives in Development

Microsandbox — Open-source self-hosted MicroVM sandboxes with sub-200ms startup, hardware-level isolation via libkrun 5k ★
Harnessrouter — HarnessRouter Community Edition: the self-hosted, Apache-2.0 edition of the unified interface for agent harnes 618 ★
Netclode — Self hosted cloud coding agent with k3s + kata containers + cloud hypervisor microVMs + tailscale + any harnes 249 ★

README

iauso — AI quota on an e-ink display

*[Léeme en español](README.es.md)*

**iauso** ("IA · uso" — AI usage in Spanish) shows how much of your **Claude** and **Codex** quota you have consumed, on an e-ink display attached to a Raspberry Pi: percentage used, when each window resets, and whether a session needs attention. No desktop, no heavy process running — a short refresh every five minutes.

You can also read the same data from a web page or a Telegram bot (see [docs/INTEGRATIONS.md](docs/INTEGRATIONS.md)), or keep the queries on a server and let the display just read them.

Python adaptation of the usage queries from [vinzdg/codenotch](https://github.com/vinzdg/codenotch). It was built for the **Waveshare 2.15inch e-Paper HAT+ (G)** (**296 × 160**, black, white, red and yellow) and that is the only panel tested on physical hardware. Since version 1.2 it also supports other common Waveshare panels (2.13", 2.9", 4.2", 7.5", with and without a second color) by reusing their official drivers — see [docs/PANELS.md](docs/PANELS.md). The official drivers are vendored, so there is no need to download the whole Waveshare repository.

![Panel showing demo data](docs/panel-demo.png)

The display shows the **percentage used**, two quota windows per provider and the reset date/time. Yellow from 70 %; red from 90 % — and both thresholds are changed with `warn_percent`/`crit_percent` in `config.json`, without touching code ([how](docs/CONFIGURATION.md#display)). The default timezone is `America/Santiago`, with DST handled by the system timezone database.

Where to start

I want to...	Read
Understand what it does and set up the Raspberry Pi	This README, from 1. Assembly and installation
Change something (colors, thresholds, windows, timings)	docs/CONFIGURATION.md — every option + copy-paste recipes
Use an e-ink panel other than the 2.15G	docs/PANELS.md
Keep