claude-find
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Basarisiz
- exec() — Shell command execution in src/db.ts
- network request — Outbound network request in src/embeddings.ts
- process.env — Environment variable access in src/index.ts
- network request — Outbound network request in src/index.ts
- process.env — Environment variable access in src/server.ts
Permissions Gecti
- Permissions — No dangerous permissions requested
This tool provides semantic search capabilities across your past Claude Code sessions. It indexes raw conversation transcripts locally, allowing you to retrieve context, past decisions, and code history from your entire chat history.
Security Assessment
Overall risk: Medium. The tool accesses sensitive data by design—it reads your raw conversation histories located in `~/.claude/projects/`, which could contain proprietary code or personal data. The automated scan failed because of shell command execution in `src/db.ts`, which is likely used to manage its local SQLite database, but this warrants a manual code review to ensure no command injection vulnerabilities exist. It makes outbound network requests, though these appear to be limited to communicating with the locally hosted Ollama instance for generating embeddings. It accesses environment variables for configuration purposes, and no hardcoded secrets or dangerous permissions were detected.
Quality Assessment
Quality and maintenance are currently basic. It uses a standard, permissive MIT license and was updated very recently. However, it suffers from extremely low community visibility with only 5 GitHub stars. It heavily relies on third-party dependencies, requiring users to install both the Bun runtime and Ollama to function.
Verdict
Use with caution—while the concept is useful and data stays local, the early-stage low community trust and detected shell execution routines mean you should review the source code before granting it access to your proprietary session data.
Pull deep memory from across your Claude Code sessions — when you need it.
claude-find
Pull deep memory from across your Claude Code sessions — when you need it.
Semantic search over all your past Claude Code sessions. Finds context by meaning and keywords. Searches the raw conversation transcripts, not compressed summaries, so Claude gets the full picture: reasoning, constraints, failed approaches, and decisions.
Setup
brew install bun ollama
bunx claude-find setup
setup starts Ollama, pulls the embedding model, sets session retention to permanent, and registers the MCP server with Claude Code. Sessions are indexed in the background on startup. Searches work immediately and return progressively more complete results as indexing continues.
Install Bun and Ollama, then run bunx claude-find setup. It detects your platform and guides you through anything missing.
Use it
In any Claude Code session:
/find that database migration we discussed last week
/find why we chose websockets over polling
/find the session where we kept getting timeout errors
/find refactoring the payment module across all projects
Claude searches your past sessions semantically, finds the relevant conversations, and synthesizes the context: what was tried, what failed, what constraints you set, and what decisions were made.
How it works
- Indexes all Claude Code session JSONL files from
~/.claude/projects/ - Extracts user + assistant messages, compact summaries, file paths from tool calls
- Enriches each chunk with metadata context (project, branch, files, date) for better retrieval
- Embeds conversation chunks using qwen3-embedding via Ollama (GPU accelerated)
- Searches with hybrid semantic + keyword (FTS5) merged via Reciprocal Rank Fusion
- Returns raw conversation chunks so Claude can synthesize with full context
After upgrading, run bunx claude-find index to rebuild the index with the latest improvements.
What makes this different
- Searches raw transcripts. Nothing lost through compression.
- Retroactive: works on all existing sessions immediately. No hooks needed.
- Permanent history: setup disables Claude Code's 30-day session cleanup so your sessions are searchable forever.
- Non-blocking: indexes in the background at startup. Searches work instantly, even mid-indexing.
- Uses compact summaries: Claude's own session understanding, boosted in ranking.
- Indexes tool call metadata: search by files touched, errors encountered.
- Fast: Ollama + GPU keeps indexing fast and memory bounded.
Requirements
License
MIT
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi