trouve-plugin

One plugin package exposing trouve code search across four agent harnesses:

• OpenCode and Kilo Code — native trouve_search and trouve_find_related tools backed by a persistent trouve server process (npm package trouve-plugin).
• Claude Code — MCP server + trouve-search sub-agent + workflow skill (this directory doubles as the Claude plugin bundle).
• Codex — MCP server + workflow skill (this directory also carries the Codex plugin manifest).

All routes require the trouve binary on PATH: cargo install trouve, or download a release binary.

OpenCode

Add to ~/.config/opencode/opencode.json (or a per-project config):

{ "plugin": ["trouve-plugin"] }

Kilo Code

kilo plugin trouve-plugin --global

or add { "plugin": ["trouve-plugin"] } to your Kilo config. Works in both the Kilo CLI and the VS Code extension.

For OpenCode and Kilo, the plugin keeps one trouve server process alive for the whole session and speaks its JSON-RPC stdio protocol directly, so repeat queries — including against remote git URLs — reuse the server's in-process index cache. It also warms the project index in the background at session start and (throttled) after each idle turn, so the first search never pays the index build and later searches see the agent's own edits. To adjust, pass options:

{ "plugin": [["trouve-plugin", { "content": "all", "warm": true }]] }

content accepts "code" (default), "docs", "config", "all", or an array of those. Set "warm": false to disable background index warming.

Claude Code

/plugin marketplace add jimsimon/trouve
/plugin install trouve@trouve

Installs the trouve MCP server (tools surface as mcp__trouve__search and mcp__trouve__find_related in Claude Code), the trouve-search sub-agent, the workflow skill, and a SessionStart hook that warms the project index in the background so the first search of a session is instant (POSIX shells; on Windows the first search builds the index instead).

Codex

codex plugin marketplace add 'https://github.com/jimsimon/trouve.git' --ref main
codex plugin add trouve@trouve

Installs the trouve MCP server (tools surface as mcp__trouve__search and mcp__trouve__find_related) and the workflow skill.

Tools (OpenCode / Kilo Code)

• trouve_search — search with a natural-language or code query. Arguments: query (required), repo (defaults to the project root; local path or https:// git URL), top_k (default 5), max_snippet_lines (default 10).
• trouve_find_related — find code similar to a file_path + line from a prior search result. Same optional arguments.

Alternative: manual MCP or tool-file setup

Agents this plugin doesn't cover can run trouve as an MCP server (a single config entry), and OpenCode can alternatively load a standalone native tool file — see INSTALL.md for per-agent instructions. Use one route per agent, not several — otherwise the model sees duplicate trouve tools. The Agent integrations section of the main README has a feature grid comparing every route.

Development

npm install
npm run typecheck

The version in package.json and both plugin manifests is kept in lockstep with the trouve crate version (scripts/sync_versions.py, enforced in CI).

License

MIT, same as trouve.