Repowise: интеллект кодовой базы для AI-агентов
Обзор Repowise — open-source MCP-сервера для анализа кода: health-score, dead code, git-аналитика и авто-документация для AI-агентов.
Что такое Repowise и для кого он создан
Repowise — это MCP-сервер с интеллектом кодовой базы, который обеспечивает AI-агентов глубоким, граф-ориентированным пониманием репозитория через специализированные инструменты — заменяя десятки файловых чтений и grep-запросов одним, ёмким и насыщенным контекстом вызовом.
Repowise индексирует кодовую базу в пять слоёв интеллекта (граф, git, wiki, решения, code health) и открывает их AI-агентам через MCP-инструменты, сформированные под конкретные задачи.
Проект одинаково полезен разным категориям пользователей:
- Индивидуальные разработчики —
pip install repowise, затемrepowise initи запросы из Claude Code, Cursor или любого MCP-агента. 100% локально, со своим API-ключом, бесплатно под AGPL-3.0. - Тимлиды — знание о том, какие PR стоит проверить перед мерджем: change-risk scoring плюс бесплатный Repowise PR Bot, который публикует один детерминированный комментарий на PR (хотспоты, скрытые связи, деградирующий health) — без LLM.
- Руководители инженерных команд — видят, сколько кода написал AI и насколько он здоров: провенанс агентов, тренды code health и bus factor из git-истории.
- Безопасность и соответствие требованиям — анализ достижимости CVE, обнаружение секретов во всей git-истории и SBOM на реальном графе зависимостей.
- Предприятия — on-prem/air-gapped, SSO/SCIM, коммерческое лицензирование (без обязательств AGPL) и IP-индемнификация.
Как работает Repowise: пять слоёв интеллекта
graph TD
A[Git-репозиторий] --> B[repowise init]
B --> C[Граф зависимостей\nAST + call graph]
B --> D[Git-аналитика\nHotspots, ownership, churn]
B --> E[Wiki / авто-документация]
B --> F[Архитектурные решения\nDecisions]
B --> G[Code Health\n51+ детектор]
C --> H[(SQLite + vector store\n.repowise/)]
D --> H
E --> H
F --> H
G --> H
H --> I[MCP-инструменты]
H --> J[Локальный дашборд]
I --> K[Claude Code / Cursor / Codex]
Repowise — это движок кодовой базовой разведки. Направьте его на git-репозиторий, и он создаст единый артефакт — SQLite + vector store под .repowise/, который могут запрашивать как AI-агенты, так и люди.
Пять слоёв интеллекта
Статическая структура. Каждый файл, символ и ребро импорта, распарсенные языкоориентированными резолверами более чем для 19 языков: Python, TypeScript, JavaScript, Svelte, Vue, Java, Kotlin, Go, Rust, C++, C#, Scala, Ruby на уровне Full; C, Swift, PHP, Dart, Object Pascal на уровне Good; SQL через выделенный sqlglot-обработчик; а также конфигурационные и данные-форматы (OpenAPI, Protobuf, GraphQL, Dockerfile, Terraform и т.д.).
Git-интеллект. Churn-хотспоты, ownership, bus factor, паттерны изменений — всё добывается из git-истории.
Авто-документация. Repowise генерирует и поддерживает структурированную wiki для любой кодовой базы.
Архитектурные решения. Decision-слой сохраняет почему код структурирован именно так.
Code Health. Один и тот же индекс даёт команде дефект-валидированный health score, оценку change-risk для каждого PR и локальный дашборд для всего этого.
Ключевые возможности и MCP-инструменты
Repowise предоставляет AI-агентам пять слоёв интеллекта (граф зависимостей, git-история, документация, архитектурные решения, code health) через девять MCP-инструментов, обеспечивая глубокое понимание кодовой базы и снижая стоимость исследования.
| MCP-инструмент | Что отвечает |
|---|---|
get_overview() | Карта архитектуры, ключевые модули, точки входа, git-сигналы |
get_answer(question) | Гибридный поиск (full-text + vector), PageRank и граф-экспансия |
get_why(query?, targets?) | Архитектурные решения с дословными доказательствами |
get_health(targets?, include?) | Health-оценки и findings по трём осям: дефект, поддерживаемость, производительность |
get_risk(targets?, changed_files?) | Хотспоты, зависимые, совместные изменения, пробелы в тестах |
get_change_risk(revspec) | Риск коммита/ветки по дефектам, поддерживаемости и производительности |
get_dead_code(...) | Недостижимый код по уровням уверенности |
Dead code detection
Dead code detection: Repowise — ✅, SonarQube Community — ❌, DeepWiki — ❌, CodeScene — ❌. Это редкая функция, которую конкуренты не предлагают в полном объёме.
Поддержка языков
26 языков разобрано до AST, 40 на пятиступенчатой лестнице, с осведомлённостью о фреймворках там, где существует обработчик экосистемы. Каждый язык поставляется в open-source дистрибутиве.
Full (13): Python · TypeScript · JavaScript · Svelte · Vue · Java · Kotlin · Go · Rust · C++ · C# · Scala · Ruby — полный конвейер: AST-символы, разрешение импортов, resolved call graph, наследование, docstrings, граф-рёбра фреймворков и маркеры code health.
Быстрый старт
# Установка
pip install repowise
# или
uv tool install repowise
# Инициализация репозитория
cd /path/to/your/repo
repowise init --yes --no-prose # Граф, git, health, dead code. Без ключа.
# Запуск MCP-сервера и дашборда
repowise serve
# Проверка health из CLI
repowise health
# Оценка PR-ветки на риск
repowise risk main..HEAD
# Поиск мёртвого кода
repowise dead-code
Тарифы и цены
Repowise бесплатен для публичных репозиториев, Pro — $15/месяц, Teams — $60/месяц, Enterprise — по запросу. Основной движок распространяется под AGPL-3.0 и бесплатен для самохостинга.
| Тариф | Цена | Ключевые возможности |
|---|---|---|
| Free (OSS) | $0 | До 2 репозиториев, 500 коммитов истории, без LLM, самохостинг |
| Pro | $15/мес | AI-powered docs, чат, поиск. $5/мес кредитов LLM включено. |
| Teams | $60/мес (от 3 мест) | Индекс один раз, доступ всей команде. Portfolio health, ownership intel, общий пул кредитов. |
| Enterprise | По запросу | SSO/SCIM, RBAC, workflow-интеграции, приоритетная поддержка и SLA, встраивание без обязательств AGPL. |
Repowise PR Bot — бесплатное GitHub-приложение, один детерминированный комментарий на PR (касание хотспотов, скрытые связи, деградирующий health, dead code) — без вызовов LLM.
Плюсы и минусы
| ✅ Плюсы | ❌ Минусы |
|---|---|
| Open-source (AGPL-3.0), полностью самохостируемый | Первоначальная индексация занимает ~25 минут |
| Не требует API-ключа для базовых функций | Требует Python 3.11+ |
| 26+ языков, включая COBOL, GDScript, Elixir | AGPL-лицензия неудобна при встраивании в продукт |
| Dead code detection — редкость среди конкурентов | Prose-документация требует LLM-ключ |
| 10 MCP-инструментов для любых агентов | Более слабая точность для Java/C# (overloaded methods) |
| Измеримые метрики (ROC AUC 0.731 по дефектам) | Enterprise-функции скрыты за коммерческой лицензией |
| Бесплатный PR Bot без LLM | Нет merge-блокирующих quality gate, как у SonarQube |
| Локальный дашборд + CLI | Молодой проект (релиз июнь 2026) |
Сравнение с альтернативами
Вот как Repowise соотносится с ключевыми конкурентами по возможностям code health:
| Возможность | Repowise | CodeScene | SonarQube |
|---|---|---|---|
| Open-source / самохостинг | ✅ AGPL-3.0 | ⚠️ Docker, проприетарный | ✅ Community Build |
| Code health score (1–10) | ✅ 51+ детекторов | ✅ 25–30 детекторов | ❌ |
| Dead code detection | ✅ | ❌ | ❌ |
| MCP-инструменты для AI-агентов | ✅ 10 инструментов | ✅ | ✅ |
| Git-история (hotspots, ownership) | ✅ | ✅ | ❌ |
| Test-coverage intelligence | ✅ LCOV/Cobertura/JaCoCo | ❌ | ✅ |
| Merge-блокирующий quality gate в CI | ⚠️ Узкий scope | ❌ | ✅ Полноценный |
| Кол-во поддерживаемых языков | 26+ (AST) | ~25 | 40+ (paid) |
| Цена (min) | $0 (OSS) | Платный | $0 (Community) |
Repowise выигрывает там, где нужен AI-агентный контекст, dead code и git-интеллект «из коробки». SonarQube — лучший выбор, если нужен огромный каталог правил и жёсткие merge-gate.
Вердикт
Repowise — это open-source платформа кодовой базовой разведки, специально разработанная для AI-ассистированных инженерных команд. Она располагается между вашим репозиторием и AI-агентом — индексируя, анализируя и обогащая кодовую базу контекстными слоями, которые статическое чтение файлов просто не может предоставить.
Кому подойдёт:
- Командам, активно использующим Claude Code, Cursor, Codex или другие MCP-агенты
- Проектам с накопленным техническим долгом, которому нужна приоритизация
- Организациям, которым важна приватность кода (self-hosted)
- Инженерным лидерам, отслеживающим «здоровье» монорепозиториев
Кому не подойдёт:
- Командам, которым нужны жёсткие CI-gate с огромным каталогом правил — здесь сильнее SonarQube
- Проектам на редких языках без Full-tier поддержки
Рейтинг: 8.5/10
Repowise — пожалуй, лучший на сегодня открытый инструмент для обеспечения AI-агентов глубоким контекстом кодовой базы. Сочетание zero-LLM-базовой аналитики, dead code detection, git-интеллекта и готового MCP-сервера выгодно выделяет его на фоне как проприетарных инструментов, так и более узкоспециализированных альтернатив.