raine/claude-history

What it solves

claude-history is a terminal-based history browser designed for users of AI coding agents like Claude Code, Pi, and Oh My Pi (OMP). It solves the problem of navigating, searching, and managing the large volume of local conversation transcripts generated by these agents, which are typically stored as JSONL files.

How it works

The tool scans project directories to automatically discover session files. It provides a Terminal User Interface (TUI) that allows users to search through conversations using both lexical (keyword) and semantic (meaning-based) search. It indexes tool outputs, thinking blocks, and dialogue to make them searchable. Users can view transcripts in a ledger-style viewer with vim-style navigation, export messages, or directly resume and fork conversations back into the original agent's environment.

Who it’s for

Developers and power users who use AI coding agents (Claude Code, Pi, OMP) and need a way to efficiently retrieve past interactions, manage session history, and transition between different project worktrees.

Highlights

• Multi-Agent Support: Works with Claude Code, Pi, and Oh My Pi.
• Hybrid Search: Combines fuzzy lexical search with local semantic embeddings for meaning-based retrieval.
• TUI Conversation Viewer: Features markdown rendering, vim-style scrolling, and toggleable thinking/tool blocks.
• Session Management: Ability to resume, fork, rename, or delete conversations directly from the interface.
• Cross-Project Forking: Allows forking a conversation from one project into the current working directory.
• Claude Code Skill: Includes a companion skill that allows Claude to search and read its own history.