Metadata-Version: 2.4
Name: subtle-claude-code
Version: 0.0.1
Summary: Claude Code session log explorer
Project-URL: Repository, https://github.com/itsderek23/subtle
License-Expression: MIT
License-File: LICENSE
Keywords: claude,claude-code,developer-tools,session-logs
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: fastapi>=0.115.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: orjson>=3.10.0
Requires-Dist: uvicorn[standard]>=0.32.0
Provides-Extra: dev
Requires-Dist: httpx>=0.27.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.14.0; extra == 'dev'
Requires-Dist: twine>=6.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Subtle

Explore and analyze your Claude Code logs with ease.

![screenshot](docs/screenshot.png)

## Privacy

Subtle runs entirely on your local machine:

* All data processing happens locally
* No telemetry
* Your conversations never leave your computer

## Setup

```bash
uv sync
```

## Run

```bash
uv run python -m subtle
```

Server starts at http://127.0.0.1:8000

### Custom Port

Specify a port via command line:

```bash
uv run python -m subtle --port 3000
```

Or via environment variable:

```bash
PORT=3000 uv run python -m subtle
```

CLI arguments take precedence over environment variables.

## Test

```bash
uv run pytest
```

