OpenCodeRAG — плагин
Семантический поиск по коду, память между сессиями и проверка команд для OpenCode. Работает локально, есть режимы MCP и CLI
- 64 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Плагин пишет индекс и заметки в проект, запускает локальные модели и при включении охранника оценивает команды оболочки.
Установка
- Работает в
Ручная установка
npm install -g opencode-rag-pluginПервая команда быстрого старта. Затем `opencode-rag setup` и `opencode-rag index` в каталоге проекта.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин пишет индекс и заметки в проект, запускает локальные модели и при включении охранника оценивает команды оболочки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`OpenCodeRAG` — плагин для OpenCode, который собирает локальный индекс кода и отдает агенту нужные фрагменты вместо целых файлов. Поиск гибридный: по смыслу и по точным именам, фрагменты нарезаются с учетом синтаксического дерева. Дополнительно есть память для заметок и решений, которые попадают в контекст следующих сессий, вики проекта, описание изображений локальной моделью и режим документирования командой `/doc`. По умолчанию работает через Ollama, поэтому код не уходит наружу. Включаемые отдельно модули: модель решений для классификации и охранник оболочки, оценивающий команды до запуска. Тот же набор доступен как MCP-сервер и как CLI `opencode-rag`.
Для кого. Пользователям OpenCode и других агентов, которые работают с большими репозиториями и хотят экономить токены и сохранять заметки между сессиями.
Подходит, если
- Репозиторий большой, и агент читает целые файлы ради одной функции
- Решения и подводные камни проекта нужно помнить между сессиями
- Перед запуском команд оболочки хочется второе мнение локальной модели
- Недокументированный код требуется описать командой `/doc`
Не подходит, если
- Нет Node.js 22 или Ollama и нет желания их ставить
- Нужна защита как песочница: охранник оболочки лишь подстраховка
- Проект маленький, и индекс не окупит настройку
Пример запроса к агенту
Найди в проекте код, который проверяет авторизацию в промежуточном слое, и покажи файлы со строками без чтения целиком.Ограничения
Нужны Node.js 22 или новее и Ollama (провайдер по умолчанию). Качество поиска зависит от модели эмбеддингов: легкие модели для CPU теряют точность. Описание изображений желательно запускать на GPU, иначе его отключают. Охранник оболочки стоит один вызов модели на команду (около 200 мс) и по умолчанию пропускает команду при сбое: это страховка, а не песочница. Модель решений работает только с эндпоинтом Ollama `/v1/systemone`. ClickHouse включается отдельно и требует сервера.
Как отключить. Выполните `npm uninstall -g opencode-rag-plugin`, уберите записи плагина из `.opencode/` в проекте и удалите индекс. Рабочие файлы среды выполнения лежат в `~/.opencode/`.
Частые вопросы
Как поставить?
Выполните `npm install -g opencode-rag-plugin`, затем `opencode-rag setup` в проекте и `opencode-rag index`. Мастер настроит модели, а после запуска OpenCode инструменты доступны агенту.
Не уходит ли код наружу?
По умолчанию нет: эмбеддинги считает локальный Ollama, база лежит в каталоге проекта. Код уйдет только если вы сами подключите сторонний API.
Можно ли без OpenCode?
Да, CLI и MCP-сервер работают без него. MCP по умолчанию выключен: включите `mcp.enabled` или подключите вручную.
Что за охранник оболочки?
Локальная модель оценивает команду на разрушительные и вредоносные действия до запуска. Он выключен по умолчанию и включается флагом `setup --shell-guard on`.
Как добавить заметку в память?
Командой `opencode-rag quirk add "npm needs --legacy-peer-deps" --type gotcha --tag installation`. Запись попадет в контекст, когда понадобится.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин для OpenCode запускает команду параллельных агентов с личными сессиями, общей доской задач и перепиской
Самостоятельный ИИ-агент для кода с веб-интерфейсом: карта проекта, память решений, локальные модели через Ollama, права
Плагин-оркестратор для OpenCode и Codex CLI: несколько агентов, хуки, встроенные MCP, режим ultrawork и правки по хешам строк
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Память кодинг-агента между сессиями, машинами и коллегами: решения и тупики сами попадают в следующие запросы.
Терминальный ИИ-агент для кода на базе opencode: любые модели по своим ключам, рои субагентов, цели и сжатие вывода.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| OpenCodeRAG (эта карточка) | нет | 64 | ||
| MCP Local RAG | нет | не нужна | 430 | локальный поиск по документам; здесь индекс кода, память, вики и проверка команд |
| code-graph-rag | нет | не нужна | 5 352 | строит граф кода; OpenCodeRAG ищет по смыслу и именам и хранит заметки между сессиями |
Коротко о README
Документация перечисляет возможности (поиск, память, решения, защита, документирование, зрение, измерения), быстрый старт, устройство гибридного поиска, справочник инструментов, конфигурацию, приватность и ограничения.