perseus — droid plugin

Semantic code search for Factory Droid. Perseus indexes your repo (symbols, tests, graph) and answers "where does X live / how does Y work" queries by meaning, via MCTS over a trained retrieval planner. Ranked path:line hits with snippets in ~2-5s.

What this plugin adds

• MCP server — query, research, impact, overview, path, eval tools (served by perseus mcp; the perseus CLI is auto-installed on first launch if missing).
• perseus-search skill — teaches the agent to reach for perseus before grep, and how to phrase queries that rank well.
• /perseus <question> — one-shot semantic search from chat.
• /perseus-setup — install the CLI, sign in, index the repo, verify.
• SessionStart hook — auto-installs the perseus CLI if missing, then nudges the agent that perseus is available / the repo needs indexing.

Install

droid plugin marketplace add https://github.com/efficientsystemsinc/perseus-droid
droid plugin install perseus@perseus-droid

The CLI self-installs on first session/MCP launch (macOS/Linux; on Windows run irm https://perseus.computer/install.ps1 | iex). Then run /perseus-setup once per machine to sign in and index the repo, or just perseus login && perseus index.