conversation-search

Search past Claude Code conversations by topic, date, or both to return session IDs and resume commands.

26|5|Updated Nov 14, 2025
One-click install
npx skills add https://github.com/akatz-ai/cc-conversation-search --skill conversation-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conversation-search
Source: https://github.com/akatz-ai/cc-conversation-search/tree/main/skills/conversation-search
Command: npx skills add https://github.com/akatz-ai/cc-conversation-search --skill conversation-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables quick discovery of past Claude Code conversations and outputs the exact resume commands, saving you time and eliminating manual digging.

Core Features & Use Cases

  • Session resumption: Retrieve session IDs and project paths to resume work precisely.
  • Unified CLI: Use a single cc-conversation-search command with subcommands to search, list, context, and tree.
  • Date filtering & time navigation: Filter by calendar dates or relative days to focus on relevant history.
  • Claude Code integration: Integrates with Claude to automatically surface and resume previous work.
  • Multi-project support: Works across all Claude Code projects.

Quick Start

Install the cc-conversation-search CLI, initialize the index, then run:

  • cc-conversation-search init
  • cc-conversation-search search "your topic" --days 7 --json
  • cc-conversation-search resume <MESSAGE_UUID> to resume a specific conversation

Frequently Asked Questions about conversation-search

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

FAQPage Schema
How do I find and resume past Claude Code conversations by topic or date?

Use cc-conversation-search to retrieve past Claude Code conversations by topic, date range, or both. The tool returns session IDs and project paths with ready-to-use resume commands, letting you pick up work instantly without manual digging through history.

Can I search Claude Code conversation history across multiple projects?

Yes. The conversation-search Skill works across all Claude Code projects in your local environment. It maintains a unified SQLite index that indexes conversations from every project, enabling multi-project topic and date filtering in a single search.

How do I set up conversation search for my Claude Code sessions?

Install the cc-conversation-search CLI, then run cc-conversation-search init to build the local SQLite index. After initialization, use cc-conversation-search search "topic" --days 7 --json to query by topic and timeframe, or cc-conversation-search resume <MESSAGE_UUID> to jump back into a specific session.

What's the fastest way to find a conversation from last week in Claude Code?

Run cc-conversation-search search "your keywords" --days 7 --json to filter conversations from the last week. The tool returns matching session IDs and project paths, plus the exact command to resume that conversation immediately.

Do I need an API connection to search my Claude Code conversation history?

No. Conversation search uses a local SQLite index and deterministic extraction—no API calls required. All queries run locally against your stored conversation metadata, making searches fast and keeping your data private.

Can conversation search filter by specific calendar dates?

Yes. Beyond relative time filters like --days 7, the tool supports absolute date filtering to target specific calendar dates. Combine date and topic filters in hybrid queries to narrow results to exact timeframes and subjects.