hunhee98/pluck

Pluck is a local code search tool designed for AI coding agents like Claude Code, Codex, or Cursor. It runs as a background process on your machine and exposes smarter ways for agents to read and search your codebase over MCP (Model Context Protocol), a standard way for AI tools to call external services. The problem it solves: when AI agents explore code using standard tools like cat or grep, they repeatedly read entire files, even parts they don't need, and re-read the same chunks multiple times. Each read consumes part of the agent's context window (the limit on how much text the AI can hold in mind at once). Pluck replaces these wasteful reads with structured alternatives that cut eligible code-read tokens by 84-88%. Instead of dumping an entire file, pluck reads code at the Abstract Syntax Tree (AST) level using Tree-sitter, which means it understands the structure of the code and can return just function signatures or outlines, with full bodies available on demand. For search, it combines keyword matching (BM25F) with semantic similarity (using a small embedding model, potion-code-16M) to rank the most relevant code chunks for a given query. A session deduplication feature tracks which chunks the agent has already seen and replaces repeats with a single short placeholder instead of resending all the text. Every pluck tool has a raw fallback that behaves exactly like the standard cat or grep command, so agents never lose capability by defaulting to pluck. Pluck is built in Rust (1.75+) and is available via crates.io or a Homebrew tap. The full README is longer than what was provided.