Metadata-Version: 2.4
Name: claude-kiosk
Version: 0.1.0
Summary: Local kiosk display for Claude usage and system resource stats.
Keywords: 
Author: Madson Dias
Author-email: Madson Dias <madsonddias@gmail.com>
License-Expression: MIT
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: typer>=0.12,<1
Requires-Python: >=3.9, <4
Project-URL: Repository, https://github.com/omadson/claude-kiosk
Project-URL: Documentation, https://omadson.github.io/claude-kiosk/
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/omadson/claude-kiosk/main/docs/assets/logo.png" alt="claude-kiosk logo" width="120">
</p>

<h1 align="center">claude-kiosk</h1>

<p align="center">
  <a href="https://github.com/omadson/claude-kiosk/actions/workflows/ci.yml"><img src="https://github.com/omadson/claude-kiosk/actions/workflows/ci.yml/badge.svg" alt="Build"></a>
  <a href="https://omadson.github.io/claude-kiosk/"><img src="https://img.shields.io/badge/docs-online-blue" alt="Docs"></a>
  <img src="https://img.shields.io/badge/coverage-%E2%89%A570%25-brightgreen" alt="Coverage">
  <a href="https://pypi.org/project/claude-kiosk/"><img src="https://img.shields.io/pypi/v/claude-kiosk" alt="PyPI version"></a>
  <a href="https://pypi.org/project/claude-kiosk/"><img src="https://img.shields.io/pypi/dm/claude-kiosk" alt="Downloads"></a>
  <a href="https://github.com/omadson/claude-kiosk/blob/main/LICENSE"><img src="https://img.shields.io/github/license/omadson/claude-kiosk" alt="License"></a>
</p>

`claude-kiosk` is a local kiosk display for Claude usage and system resource stats. Shows two screens you tap/click to switch between:

- **Usage**: 5-hour and 7-day Claude usage bars (from the OAuth `usage` endpoint), plus a weather strip (day, time, temperature, humidity) up top.
- **Overview**: memory, CPU and disk usage bars for the host machine.

<p align="center">
  <img src="https://raw.githubusercontent.com/omadson/claude-kiosk/main/docs/assets/screenshots/usage.png" alt="Usage screen" width="49%">
  <img src="https://raw.githubusercontent.com/omadson/claude-kiosk/main/docs/assets/screenshots/overview.png" alt="Overview screen" width="49%">
</p>

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

```bash
pip install claude-kiosk
```

or

```bash
uv tool install claude-kiosk
```

## Usage

```bash
claude-kiosk serve
```

Open `http://localhost:8420` in your browser, or open it directly in
a dedicated window:

```bash
claude-kiosk open
```

Full documentation, including configuration and the desktop launcher,
at **[omadson.github.io/claude-kiosk](https://omadson.github.io/claude-kiosk/)**.

## Development

See [CONTRIBUTING.md](CONTRIBUTING.md) for the full contribution guide.
