Subtle - Claude Code session log explorer

Explore and analyze your Claude Code session logs with ease. Subtle is a local, privacy-focused web app that helps you understand your Claude Code usage patterns.

👇 Click the image for a short video:

Table of Contents

• Privacy
• Prerequisites
• Installation
• Usage
• Development

Privacy

Subtle runs entirely on your local machine:

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

Prerequisites

• Python 3.10 or higher
• Claude Code session logs (stored in ~/.claude/projects/)

Installation

# uv
uv add subtle-claude-code

# Or with pip
pip install subtle-claude-code

Usage

subtle start

Server starts at http://127.0.0.1:8000

For the list of available options, run:

subtle --help

Custom Port

subtle start --port 3000

Or via environment variable:

PORT=3000 subtle start

Development

Setup

git clone https://github.com/itsderek23/subtle.git
cd subtle
uv sync

Run locally

uv run subtle start

Test

uv run pytest