CLI для семантического поиска по коду на основе AST и MCP-сервер, который индексирует кодовую базу, чтобы coding agents могли находить код по смыслу.
yoanbernabeu/grepai
CLI для семантического поиска по коду с локальными эмбеддингами, анализом графа вызовов и MCP-сервером для AI-агентов — с приоритетом конфиденциальности.
- Звёзды
- 1,940
- Форки
- 160
- Открытые issues
- 81
- Последний коммит
- 6 дней назад
Что это?
grepai — это CLI-инструмент для поиска по кодовой базе по смыслу, а не по точному совпадению текста. Он строит векторный индекс кода с помощью эмбеддингов, поэтому запрос на естественном языке, например «поток аутентификации пользователя», может находить нужные функции, даже если они называются иначе.
Инструмент работает целиком на вашем компьютере и поддерживает локальные провайдеры эмбеддингов, например Ollama, а также LM Studio и OpenAI. Фоновый файловый наблюдатель обновляет индекс при изменении файлов. Кроме того, grepai умеет анализировать граф вызовов — так можно посмотреть, какие функции вызывают нужную, прежде чем изменять её.
grepai предоставляет MCP-сервер, через который AI-агенты, такие как Claude Code, Cursor и Windsurf, могут вызывать его как инструмент. По заявлению проекта, это сокращает количество входных токенов, которое агенты тратят на чтение кода: вместо необработанных результатов поиска они получают только релевантный контекст.
Ключевые возможности
- 01Семантический поиск, который находит код по смыслу, а не по точному совпадению текста
- 02Анализ графа вызовов для поиска функций, вызывающих нужную
- 03Полностью локальная работа с эмбеддингами Ollama, LM Studio или OpenAI
- 04Файловый наблюдатель, который автоматически поддерживает индекс в актуальном состоянии
- 05MCP-сервер для вызова grepai из AI-агентов
Сценарии использования
- Помогать Claude Code или Cursor находить нужный код, не читая файлы целиком
- Находить код по концепции, когда неизвестно точное имя функции
- Проверять, какие функции вызывают нужную, перед рефакторингом
- Искать по приватной кодовой базе, не отправляя код во внешние сервисы
Быстрый старт
- 1
Установить через Homebrew (macOS)
brew install yoanbernabeu/tap/grepai - 2
Установить провайдера эмбеддингов: загрузить модель Ollama nomic-embed-text с помощью pull
ollama pull nomic-embed-text - 3
Инициализировать grepai в проекте, затем запустить демон индексирования
grepai init && grepai watch - 4
Искать код по смыслу
grepai search "error handling"
Что важно знать
- Требуется отдельный провайдер эмбеддингов, например Ollama, LM Studio или OpenAI.
- В README для установки в Linux и Windows вместо менеджера пакетов используется установочный скрипт для curl или PowerShell.
В подборках
Темы
Частые вопросы
- Что такое grepai?
- CLI для семантического поиска по коду с локальными эмбеддингами, анализом графа вызовов и MCP-сервером для AI-агентов — с приоритетом конфиденциальности. grepai — это CLI-инструмент для поиска по кодовой базе по смыслу, а не по точному совпадению текста. Он строит векторный индекс кода с помощью эмбеддингов, поэтому запрос на естественном языке, например «поток аутентификации пользователя», может находить нужные функции, даже если они называются иначе.
- grepai можно использовать бесплатно? Какая у него лицензия?
- grepai распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- grepai всё ещё поддерживается?
- Активно поддерживается. Последний коммит в grepai — 2 нояб. 2026 г..
- Для чего можно использовать grepai?
- Помогать Claude Code или Cursor находить нужный код, не читая файлы целиком Находить код по концепции, когда неизвестно точное имя функции Проверять, какие функции вызывают нужную, перед рефакторингом Искать по приватной кодовой базе, не отправляя код во внешние сервисы
- Как установить grepai?
- Установить через Homebrew (macOS): brew install yoanbernabeu/tap/grepai Установить провайдера эмбеддингов: загрузить модель Ollama nomic-embed-text с помощью pull: ollama pull nomic-embed-text Инициализировать grepai в проекте, затем запустить демон индексирования: grepai init && grepai watch Искать код по смыслу: grepai search "error handling"
- Где скачать grepai?
- Исходный код и инструкции по установке — на GitHub: https://github.com/yoanbernabeu/grepai
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Локальный семантический поиск по коду: сочетает векторные эмбеддинги с ripgrep и позволяет задавать запросы на естественном языке.
Локальный CLI и инструмент для агентов: поиск по рабочей директории с помощью ripgrep, BM25 и векторного поиска.
Локальный MCP-сервер для семантического поиска по коду: Claude Code, Codex, Cursor и OpenCode находят нужное по смыслу с помощью эмбеддингов Ollama или LM Studio.
CLI и TUI для поиска похожих инструментов в пакетных реестрах, GitHub и Hacker News по описанию идеи на обычном английском — до начала разработки.
Подборка проверенных устанавливаемых навыков для AI-агентов, помогающих писать код, — Claude Code, Cursor и Copilot — и CLI для их установки.