---
title: "lumen"
description: "Precise local semantic code search for coding agents, powered by local embedding models."
canonical: https://agentpluginsdirectory.com/plugins/lumen
last-updated: 2026-09-26
---

# lumen
Precise local semantic code search for coding agents, powered by local embedding models.
- Slug: lumen
- Publisher: Ory Corp
- Repository: https://github.com/ory/lumen
- Manifest: plugins/lumen/plugin.json
- Version: 0.0.42
- License: Apache-2.0
- Category (editorial): agent-tooling
- Skills: 2 (doctor, reindex)
- MCP servers: 1 (lumen)
- Stars: 301
- Repository created: 2026-02-27
- Repository last pushed: 2026-08-11
- Publisher type: Organization
- Listing: https://agentpluginsdirectory.com/plugins/lumen
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What lumen does, in the publisher's words

Claude reads entire files to find what it needs. Lumen gives it a map.

Lumen is a 100% local semantic code search engine for AI coding agents. No API keys, no cloud, no external database, just open-source embedding models (Ollama or LM Studio), SQLite, and your CPU. A single static binary and your own local embedding server.

The payoff is measurable and reproducible: across 9 benchmark runs on 9 languages and real GitHub bug-fix tasks, Lumen cuts cost in every single language, up to 39%. Output tokens drop by up to 66%, sessions complete up to 53% faster, and patch quality is maintained in every task. All verified with a transparent, open-source benchmark framework that you can run yourself.

- Demo

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/ory/lumen/HEAD/README.md

## Skills

- doctor: Run a health check on the bundled Lumen semantic search setup for the current project, verify backend reachability and index freshness, and summarize remediation steps.
- reindex: Refresh or rebuild the bundled Lumen index for the current project, preferring MCP-driven refreshes and using the CLI only for an explicit clean rebuild.

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

## MCP servers

- lumen: transport: stdio; command: ./scripts/run stdio

Read from the plugin's own mcp.json. Environment variable names only, never values.