From claude-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-reflectionsThis skill is limited to using the following tools:
Search past conversations to answer: $ARGUMENTS
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
Search past conversations to answer: $ARGUMENTS
~/.claude/plugins/local-marketplace/plugins/claude-reflections/, replace / with -, prepend -
/home/corona/foo → -home-corona-fooCheck 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
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.
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
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...
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 formatmessage.content: text (user) or array of blocks (assistant)| 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.