sift-light — плагин
Плагин локального поиска по файлам, заметкам и логам: агент получает пронумерованные фрагменты с путями и листает выдачу курсором
- 103 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Поиск читает любые файлы в выбранной области, включая заметки, логи и файлы с ключами
- Хуки по умолчанию блокируют поисковые команды оболочки и меняют привычное поведение агента
- Включение поиска по смыслу ставит на диск модель и требует больше 1 ГиБ памяти на первой загрузке
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/sift-lightОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Поиск читает любые файлы в выбранной области, включая заметки, логи и файлы с ключами
- Хуки по умолчанию блокируют поисковые команды оболочки и меняют привычное поведение агента
- Включение поиска по смыслу ставит на диск модель и требует больше 1 ГиБ памяти на первой загрузке
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
sift-light подключает к агенту инструмент `sift_light` для поиска по локальным проектам, документам, заметкам и логам. Точные запросы по имени, символу, имени файла или тексту ошибки идут по быстрому пути. Если совпадений мало, агент сразу получает текст и расположение, если много, сперва приходит карта файлов и фрагментов, и агент выбирает, что открыть. Несколько условий задаются списками `anyOf` и `allOf`, область поиска сужается до папки. Продолжение выдачи и контекст вокруг найденного агент получает по курсору: следующая страница, строки до и после совпадения. Поиск по смыслу, режимы `concept` и `hybrid`, по умолчанию выключен: для него нужна локальная модель, и включается он параметром `vectorSearchEnabled` в `sift-light.json`. Плагин входит в Claude Code, Codex, Kimi Code, DeepSeek Harness, Pi и OMP, а в остальные клиенты подключается как обычный MCP-сервер. Встроенные хуки по умолчанию запрещают агенту обычный поиск через оболочку, чтобы он пользовался инструментом.
Для кого. Разработчикам, чей агент тратит контекст на повторные `grep` и открытие файлов, и тем, кто ищет по большим папкам заметок, документов и логов.
Подходит, если
- Агент снова и снова открывает файлы целиком, чтобы найти одну строку
- По папке с контрактами или заметками надо узнать, в каких документах упоминается возврат средств
- В логах ищется текст ошибки, а совпадений слишком много для одного ответа
- Формулировку помнят неточно, и поиск по смыслу на своем компьютере решает задачу
- Хочется по ходу работы держать единое правило поиска для Claude Code и Codex
Не подходит, если
- Агенту нужна свобода запускать любые команды поиска: в режиме `hard` хуки блокируют обычные поисковые команды оболочки
- Нужен поиск по интернету или по облачным документам: плагин ищет только на локальном диске
- Нет Node.js 22.19 или новее: сервер на нем работает
- Компьютер слабый, а поиск по смыслу нужен постоянно: первая загрузка модели занимает десятки секунд и больше 1 ГиБ памяти
Пример запроса к агенту
Найди во всех документах папки contracts упоминания возврата средств и покажи сначала карту файлов, а потом открой два самых подходящихОграничения
Сервер требует Node.js 22.19 и новее. В режиме по умолчанию хуки жестко запрещают обычный поиск через оболочку, смягчить это можно значением `SIFT_LIGHT_ENFORCE_SEARCH=prefer` или `off`. Поиск по смыслу выключен, а при включении первая загрузка локальной модели занимает десятки секунд и больше 1 ГиБ памяти, авторы называют это наблюдением, а не гарантией. Лицензия AGPL-3.0. Для Kimi Code и DeepSeek Harness 0.2.1-rc.5 адаптеры привязаны к конкретным версиям клиента.
Как отключить. В Claude Code отключите плагин через `/plugin`, в Codex через `/hooks` и менеджер плагинов, для MCP удалите сервер командой `claude mcp remove sift-light`. Только хуки отключаются значением `SIFT_LIGHT_ENFORCE_SEARCH=off`.
Частые вопросы
Как подключить sift-light к Claude Code?
Проще всего плагином: `/plugin marketplace add lightsifter/sift-light`, затем `/plugin install sift-light@sift-light`. Для голого MCP-сервера выполните `claude mcp add sift-light -- npx -y --package sift-light@latest sift-light-mcp --stdio`. После установки перезапустите сессию.
Почему агент больше не запускает grep?
В режиме `hard`, который включен по умолчанию, хуки плагина блокируют обычные поисковые команды оболочки и направляют агента к `sift_light`. Чтобы оставить оба способа, запустите клиент с `SIFT_LIGHT_ENFORCE_SEARCH=prefer`, чтобы убрать запрет совсем, поставьте `off`.
Как включить поиск по смыслу?
Установите локальную модель командой `npx -y --package sift-light@latest sift-light-model --install-model`, добавьте `"vectorSearchEnabled": true` в `sift-light.json` и перезапустите клиент. Одной установки модели недостаточно. Без этого режимы `concept` и `hybrid` возвращают явную ошибку и тихо не подменяются точным поиском.
Что делать, если ответ пришел со статусом waiting?
Это долгая операция поиска по смыслу. Скопируйте запрос `nextRequest` из ответа без изменений, обычно `{"mode": "await", "operationId": "..."}`: он продолжит ту же работу и не запустит ее заново.
Как подключить sift-light к Codex?
Выполните `codex plugin marketplace add lightsifter/sift-light`, затем `codex plugin add sift-light@sift-light`. После установки проверьте и подтвердите доверие к хуку в `/hooks`. Плагин Codex содержит скилл `local-search`, который помогает агенту найти отложенный инструмент.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныOry Lumen
Lumen
Плагин смыслового поиска по коду для Claude Code, Codex, Cursor и OpenCode, который работает целиком на вашей машине
Локальный MCP-сервер строит индекс кода на SQLite и tree-sitter, и агент ищет символы, вызовы и смысл одним запросом
Локальный поиск по коду для Claude Code и Codex: шесть быстрых инструментов вместо grep и Read, индекс обновляется сам.
codesearch ищет по коду сразу в нескольких репозиториях гибридным поиском и работает офлайн, без GPU и Docker.
Локальный индекс кода для агентов: MCP-инструмент map ищет по смыслу и структуре, код не покидает машину
Поиск по исходникам ранжирует совпадения с учетом структуры кода и дает агенту нужные фрагменты без отдельного индекса.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| sift-light (эта карточка) | нет | 103 | ||
| grepai | нет | 1 950 | ищет по коду семантически и строит графы вызовов, без хуков, которые заменяют обычный поиск | |
| Claude Context | да | API-ключ | 12 690 | индексирует кодовую базу в векторной базе, а не ищет точным путем по любым локальным файлам |
Коротко о README
README начинается с образа внимательного библиотекаря и разбирает сценарии: найти фрагмент, начать с карты, продолжить по курсору, найти по неточной формулировке, искать по нескольким условиям и в выбранной папке. Затем идут установка для Pi, OMP, MCP, Claude Code, Codex, Kimi и DeepSeek Harness, настройка политики поиска и параметры локальной модели.