This CLI tool addresses the challenge of managing and searching Claude Code's local conversation history. It provides developers with a powerful, terminal-based interface to quickly find, review, and resume past interactions, significantly streamlining workflows and enhancing productivity when working with AI-generated code or assistance.

How It Works

claude-history operates as a command-line interface (CLI) that launches an interactive terminal UI (TUI). It employs fuzzy search with field-aware relevance scoring, prefix matching, and word boundary awareness to locate conversations. The tool indexes tool outputs, enabling searches across bash commands, file contents, and grep results, not just user/assistant text. A built-in viewer renders conversations with markdown support, offering vim-style scrolling, in-viewer search, and message navigation. Core functionalities include resuming and forking conversations directly from the TUI, with options for cross-project session management and worktree awareness.

Quick Start & Requirements

• Primary install:
  • Shell script: curl -fsSL https://raw.githubusercontent.com/raine/claude-history/main/scripts/install.sh | bash
  • Homebrew (macOS/Linux): brew install raine/claude-history/claude-history
  • Cargo: cargo install claude-history
• Prerequisites: Standard system build tools for Cargo installation; Homebrew or curl for script-based installs. No specific language versions or hardware requirements are detailed beyond those necessary for Claude Code itself.
• Links: Installation scripts are provided directly.

Highlighted Details

• Advanced fuzzy search with field-aware relevance scoring, prefix matching, word boundary awareness, and tool output indexing.
• Interactive TUI viewer with vim-style navigation, in-viewer search, markdown rendering, and message-level actions (copy, jump).
• Seamless integration for resuming and forking conversations directly from the TUI, including cross-project session copying.
• Worktree-aware project filtering and scope toggling (all conversations vs. current workspace).

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or project roadmaps are provided in the README.

Licensing & Compatibility

The license for this project is not explicitly stated in the provided README. This lack of clarity may pose a compatibility concern for commercial use or integration into proprietary systems.

Limitations & Caveats

As a "companion CLI for Claude Code," the tool is inherently dependent on Claude Code's local history format and operational context. The absence of a specified open-source license is a notable adoption blocker requiring clarification.