karanb192

Hindcast — Development skill for Claude Code

Development community

Browse, search & replay every Claude Code session on your Mac.

How to install Hindcast

This entry records only its repository, not the path inside it, so there is no exact command to give. Open karanb192/hindcast and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Hindcast does

Browse, search & replay every Claude Code session on your Mac. Local-first session viewer, timeline scrubber & cost tracker (ccusage alternative).

Alternatives in Development

Ccusage — CLI for analyzing Claude Code/Codex usage from local JSONL files 11.8k ★
Agent Blackbox — Local-first flight recorder for coding agents : replay every run as a live session map, score the context bill 74 ★
Decant — Local-first analysis of Claude Code and Codex sessions: token spend, context windows, files touched, and cost 59 ★

README

Every Claude Code session you've ever run. Indexed, searchable, scrubbable.

Find that session from three weeks ago, scrub through what the agent did, and resume it in your terminal with one paste. Local-first: it reads the transcripts Claude Code already writes to ~/.claude/projects/, and nothing leaves your Mac.

A Claude Code session on the Hindcast tape

My own archive, as of August 2026: 114 sessions across 65 projects, half a gigabyte of JSONL, 17M output tokens, reaching back to April. Hindcast cold-indexes all of it in about 4 seconds on an M3 Pro, then keeps the index fresh as new sessions land.

The 30-second film

https://github.com/user-attachments/assets/3d784ee4-add6-4716-b668-877af637b925

Install

brew tap karanb192/tap
brew trust karanb192/tap
brew install --cask hindcast
brew install ripgrep    # search engine; without it ⌘K matches titles only

Apple Silicon only for now. Builds are signed and notarized (Developer ID), so the app opens first try, no Gatekeeper hoops. Prefer a download? Grab the DMG from [Releases](https://github.com/karanb192/hindcast/releases).

One thing worth doing today: Claude Code prunes transcripts by file age, `cleanupPeriodDays` in `~/.claude/settings.json`, default 30 days. Hindcast can only index what still exists. Mine is set to 60, which is why the archi