claude-kiosk
claude-kiosk is a local kiosk display for Claude usage and system resource stats. Shows three 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. - 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.3.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.3.0.tar.gz | 1.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| claude_kiosk-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.8 MB
Release files / claude_kiosk-0.3.0.tar.gz
| Download URL | claude_kiosk-0.3.0.tar.gz |
|---|---|
| Size | 1.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e35c379376882479fa86a760d70165bafd08853248d0366464e12ffbff302f10
|
|
BLAKE2b-256 checksum How to use checksums |
4c7e7062fe135a31685d1cef09e323050d44ebff5d19df10e8f3ee8e72e5a0d1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","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.3.0-py3-none-any.whl
| Download URL | claude_kiosk-0.3.0-py3-none-any.whl |
|---|---|
| Size | 1.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
392cc078a86d5ff690e89ffe980c620f4102bd777d468887a4e7f207c419133e
|
|
BLAKE2b-256 checksum How to use checksums |
5acd5843b17b61986a4fb6bb1a7d7f97911389e2f5e85595c697f8ef720cf3d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","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}
|
