Skill

reflections

Search past conversation history and answer questions about previous project discussions. Use when asked about "how did we...", "what was our approach to...", or any question requiring context from past conversations. On first use, check installation status.

npx claudepluginhub andrewleech/claude-reflections --plugin claude-reflections

Tool Access

This skill is limited to using the following tools:

BashRead

Preview

Search past conversations to answer: $ARGUMENTS

SKILL.md

Similar Skills

cache-components

139.2k

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

mcp-builder

124.2k

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

9 files

anthropics-skills-13

canvas-design

124.2k

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

20 files

anthropics-skills-13

Stats

Stars0

Forks0

Last CommitFeb 20, 2026

Actions

View Source View Plugin View on GitHub View README

Search Conversation History

Search past conversations to answer: $ARGUMENTS

Environment

Plugin directory: ~/.claude/plugins/local-marketplace/plugins/claude-reflections
Project name formula: strip leading /, replace / with -, prepend -
- Example: /home/corona/foo → -home-corona-foo

Workflow

Check installation:
```
ls ~/.claude/plugins/local-marketplace/plugins/claude-reflections/pyproject.toml
```
If file not found, tell the user: "The reflections system is not installed. Run ./install.sh in the plugin directory at ~/.claude/plugins/local-marketplace/plugins/claude-reflections/."
Search conversations:
```
cd ~/.claude/plugins/local-marketplace/plugins/claude-reflections
uv run claude-reflections search "SEARCH_TERMS" --project="PROJECT_NAME" --limit 5
```
- Extract search terms from the user's question
- Derive project name from the working directory
- Search auto-indexes the project incrementally before searching
Read matched conversations: For each search result, use Read to examine the JSONL file at the returned line number (±10 lines for context).
Synthesize answer: Extract relevant information and provide a clear answer. Cite conversation dates if helpful.

CLI Reference

All commands run from the plugin directory.

PLUGIN_DIR=~/.claude/plugins/local-marketplace/plugins/claude-reflections
cd "$PLUGIN_DIR"

# List all indexed projects
uv run claude-reflections list

# Check indexing status for a project
uv run claude-reflections status --project="-home-corona-foo"

# Search (auto-indexes when --project specified)
uv run claude-reflections search "query terms" --project="-home-corona-foo" --limit 5

# Manual full reindex
uv run claude-reflections index --project="-home-corona-foo" --full --verbose

Search Output Format

1. [assistant] Score: 0.892
   Project: -home-corona-foo
   File: /home/corona/.claude/projects/-home-corona-foo/abc123.jsonl
   Line: 45
   Time: 2025-01-04T10:30:00+00:00
   Preview: We implemented authentication using...

JSONL Format

Conversation files at ~/.claude/projects/<project>/*.jsonl contain one JSON object per line:

{"type":"user","timestamp":"2025-01-04T10:30:00Z","message":{"role":"user","content":"How do we handle auth?"}}
{"type":"assistant","timestamp":"2025-01-04T10:30:15Z","message":{"role":"assistant","content":[{"type":"text","text":"We use JWT..."}]}}

type: "user" or "assistant"
timestamp: ISO format
message.content: text (user) or array of blocks (assistant)

Troubleshooting

Issue	Solution
Plugin not installed	Run `./install.sh` in the plugin directory
No search results	Check project is indexed: `uv run claude-reflections list`
Wrong project name	Verify with `pwd \| sed 's\|^/\|-\|' \| tr '/' '-'`
Database error	Delete `~/.claude/reflections/<project>/vectors.db` and reindex
CLI errors	See install.md for full troubleshooting

For installation or configuration issues, direct the user to install.md.