Ory Lumen — плагин
Lumen
Плагин смыслового поиска по коду для Claude Code, Codex, Cursor и OpenCode, который работает целиком на вашей машине
- 313 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Скачивает и запускает бинарник из релиза GitHub при первой сессии
- Читает весь код проекта для индексации и хранит индекс на диске
Установка
- Работает в
Ручная установка
/plugin marketplace add ory/claude-pluginsЗатем /plugin install lumen@ory. Перед этим выполните ollama pull ordis/jina-embeddings-v2-base-code. Проверка: /lumen:doctor.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скачивает и запускает бинарник из релиза GitHub при первой сессии
- Читает весь код проекта для индексации и хранит индекс на диске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Lumen — плагин с MCP-инструментом semantic_search, который дает кодинг-агенту карту проекта. Вместо чтения файлов целиком агент ищет нужные функции, типы и модули по смыслу. Все работает локально: векторы строит Ollama или LM Studio, индекс лежит в SQLite с расширением sqlite-vec, внешний сервис не нужен. При старте сессии Lumen проходит по проекту, строит дерево Меркла из хэшей файлов и заново обрабатывает только измененное. Файлы режутся на смысловые куски (функции, типы, методы) через AST Go или грамматики tree-sitter. Lumen знает 12 семейств языков: Go, Python, TypeScript, JavaScript, Svelte, Rust, Ruby, Java, PHP, C и C++, C# и Dart. В набор входят еще инструменты health_check и index_status и два скилла: doctor проверяет состояние, reindex заново строит индекс. Рабочие деревья Git делят один индекс, поэтому новое дерево заполняется из соседнего за секунды. При первой сессии плагин скачивает бинарник из релиза GitHub.
Для кого. Для разработчиков, которые работают в больших репозиториях и монорепозиториях с Claude Code, Codex, Cursor или OpenCode и хотят сократить расход токенов без отправки кода в облако.
Подходит, если
- Агент тратит много токенов на чтение целых файлов в большом репозитории
- Код нельзя отправлять во внешний сервис
- Нужен поиск по смыслу («где обрабатывается повторная отправка платежа»), когда точная строка неизвестна
- Работаете с несколькими деревьями Git одного репозитория и не хотите индексировать каждое с нуля
- Требуется одинаковый поиск в Claude Code, Codex, Cursor и OpenCode
Не подходит, если
- Проект на языке вне списка из 12 семейств: куски кода для него не режутся по смыслу
- Нужен поиск по точному тексту или регулярному выражению: для этого хватит grep
- Нужен общий облачный индекс для всей команды: у каждого разработчика индекс свой
Пример запроса к агенту
Найди через semantic_search, где в этом репозитории обрабатывается повторная отправка webhook, и покажи только нужные функцииОграничения
Нужен запущенный Ollama или LM Studio с моделью для векторов кода. Первый запуск строит индекс, и на большом проекте это занимает время. Замеры экономии автор сделал с Claude на девяти задачах по исправлению ошибок в девяти языках, и результат зависит от репозитория: в Rust качество решений слабое в обоих режимах. Плагин для Codex требует Codex CLI 0.147.0 или новее. GitHub определяет лицензию как NOASSERTION, но в файлах проекта указана Apache 2.0.
Как отключить. В Claude Code выполните `/plugin uninstall lumen@ory`, в Codex удалите плагин командой `codex plugin`, в OpenCode уберите `@ory/lumen-opencode` из массива `plugin` в `opencode.json`. Индекс можно удалить из каталога `~/.local/share/lumen`.
Частые вопросы
Как поставить Lumen в Claude Code?
Сначала скачайте модель: `ollama pull ordis/jina-embeddings-v2-base-code`. Затем выполните `/plugin marketplace add ory/claude-plugins` и `/plugin install lumen@ory`. Проверьте установку в новой сессии командой `/lumen:doctor`.
Отправляются ли мои исходники в облако?
Нет. Векторы и индекс остаются на вашей машине, ключи API не нужны.
Сколько экономит Lumen?
Автор замерил девять задач в девяти языках: стоимость сеанса падала во всех случаях, в среднем с 0,40 до 0,29 доллара, а время сократилось со 174 до 125 секунд. Выходных токенов стало на 37 процентов меньше. Исходные данные и фреймворк замеров лежат в репозитории.
Какие инструменты и скиллы появляются?
MCP-инструменты semantic_search, health_check и index_status, а также скиллы doctor и reindex. В Claude Code они вызываются командами `/lumen:doctor` и `/lumen:reindex`.
Как подключить Lumen в OpenCode?
Добавьте `@ory/lumen-opencode` в массив `plugin` файла `opencode.json` и проверьте командой `opencode mcp list`. Бинарник и индекс появятся при первом поиске.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныИндексация кода для LLM: VectorCode строит поиск по репозиторию и отдает нужный контекст агенту через CLI и MCP
CocoIndex Code
CocoIndex Code (ccc)
Плагин с AST-семантическим поиском по коду: скилл, MCP-сервер и CLI ccc помогают агенту находить нужный код без полного чтения файлов
Локальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
MCP-сервер семантического поиска по кодовой базе: индексирует проект в векторной базе и отдает агенту только нужные фрагменты
MCP-сервер, который превращает большую кодовую базу в семантический граф функций для точной навигации и поиска по смыслу
MCP-сервер индексирует локальный репозиторий через tree-sitter и дает агенту поиск по коду, список файлов и сводку по структуре файла
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Ory Lumen (эта запись) | нет | 313 | ||
| ChunkHound | нет | 1 455 | исследует код со ссылками на источники и историей Git, без упора на экономию токенов | |
| code-index-mcp | нет | не нужна | 158 | индексирует репозиторий через tree-sitter и ищет без векторов |
Коротко о README
Главная таблица показывает экономию по языкам на замерах автора. Остальное — справочник: установка в четырех средах, выбор модели для векторов, исключения из индекса и устранение неполадок.