claude-kiosk
claude-kiosk is a local kiosk display for Claude usage and system resource stats. Shows these screens you tap/click to switch between:
- Usage: 5-hour and 7-day Claude usage bars (from the OAuth
usageendpoint), plus a weather strip (day, time, temperature, humidity) up top. - Extra accounts (optional): one more usage screen per additional Claude account, added with
claude-kiosk config --add-account NAME=DIRwhereDIRis that account'sCLAUDE_CONFIG_DIR(e.g.work=~/.claude-work). Remove with--remove-account NAME. - Overview: memory, CPU and disk usage bars for the host machine.
- Pomodoro: focus/break timer (25/5 min, 15 min long break every 4 sessions) with start/pause, skip and reset controls. State persists across reloads and the screen flashes and beeps when a phase ends.
It reads your existing Claude Code login from ~/.claude/.credentials.json (no separate API key needed), and runs entirely locally: no telemetry, no external accounts.
Installation
pip install claude-kiosk
or
uv tool install claude-kiosk
Usage
claude-kiosk serve
Open http://localhost:8420 in your browser, or open it directly in
a dedicated window:
claude-kiosk open
Full documentation, including configuration and the desktop launcher, at omadson.github.io/claude-kiosk.
Development
See CONTRIBUTING.md for the full contribution guide.
1 maintainer
Metadata
1 maintainer
Release files for claude-kiosk 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| claude_kiosk-0.4.0.tar.gz | 1.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| claude_kiosk-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.8 MB
Release files / claude_kiosk-0.4.0.tar.gz
| Download URL | claude_kiosk-0.4.0.tar.gz |
|---|---|
| Size | 1.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3458f9330631dae008c56c052e7491b408569af07d6c00688644b116a68f17d1
|
|
BLAKE2b-256 checksum How to use checksums |
803626ae713e07561636c590839aba0e31d1adb5e729b61969eca784613fb2aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / claude_kiosk-0.4.0-py3-none-any.whl
| Download URL | claude_kiosk-0.4.0-py3-none-any.whl |
|---|---|
| Size | 1.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c715c46f411158ceaa0d9d2ef44b38e8d5e84676d9a789b91470036011a680ed
|
|
BLAKE2b-256 checksum How to use checksums |
207ac6ee31ee0d2b2dec2b99d7ef567037df8c7ad2832e3cda9f0e39c086b87e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
