claude-history-viewer

Search, manage, and resume Claude Code sessions via a local web interface.

8|Updated Jul 26, 2026
One-click install
npx skills add https://github.com/joonlab/joonlab-claudecode-setting-for-share --skill claude-history-viewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-history-viewer
Source: https://github.com/joonlab/joonlab-claudecode-setting-for-share/tree/main/claude/skills/claude-history-viewer
Command: npx skills add https://github.com/joonlab/joonlab-claudecode-setting-for-share --skill claude-history-viewer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fastapi, uvicorn, pydantic, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill solves the difficulty of navigating, searching, and resuming long-running or scattered Claude Code conversation sessions by providing a centralized, searchable web interface.

Core Features & Use Cases

  • Session Management: Rename, tag, describe, and delete sessions directly from a browser.
  • Advanced Search: Perform keyword, semantic, or hybrid searches across all conversation history to find specific past decisions or code snippets.
  • Resume Integration: Instantly resume any session in your terminal via iTerm2 or cmux integration.

Quick Start

Start the history viewer server by running the claude-history command in your terminal and opening the provided local URL in your browser.

Frequently Asked Questions about claude-history-viewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search my Claude Code conversation history for a specific code snippet?

You can search Claude Code conversation history using full-text keyword search or hybrid semantic embedding-based retrieval. This provides a local web-based interface to find specific past decisions or code snippets across all sessions.

Can I manage and rename my Claude Code sessions from a browser interface?

Yes, you can manage Claude Code sessions directly from a browser. The interface allows you to rename, tag, describe, and delete sessions, providing a centralized hub for navigating scattered conversations.

How do I resume a previous Claude Code session in my terminal?

You can resume a Claude Code session instantly in your terminal via iTerm2 or cmux integration. The web interface provides resume integration to launch terminal-based session resumption directly.

Do I need FastAPI to run the local web interface for session management?

Yes, FastAPI is required for the backend server. The session management web interface uses FastAPI and uvicorn to serve the local application, while pydantic manages data validation.

What is the best way to navigate long-running Claude Code conversation sessions?

The best way to navigate long-running Claude Code sessions is using a centralized searchable web interface. It indexes local file system session metadata, enabling semantic search and browser-based management.

Does semantic search across conversation history work with locally stored sessions?

Yes, semantic search works with locally stored sessions. The viewer integrates with local file systems to index session metadata and performs semantic embedding-based retrieval across all conversation history.