Corbell CLI
CLI строит граф сервисов из кода нескольких репозиториев и пишет по PRD проектный документ с учетом принятых в команде решений
- 628 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Corbell читает код всех репозиториев из `workspace.yaml` и отправляет его фрагменты выбранному провайдеру LLM
- Выгрузка в Linear, Jira и Notion создает задачи и страницы во внешних сервисах по токенам из переменных окружения или `workspace.yaml`
- Команда `corbell ui serve` открывает локальный сайт на порту 7433, а `corbell mcp serve` дает MCP-клиенту доступ к графу и поиску по коду
Установка
- Работает в
Ручная установка
pip install "corbell[anthropic]"Нужен Python 3.11 или новее. Для GPT-4o вместо набора anthropic возьмите openai, для выгрузок добавьте notion, linear, jira.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Corbell читает код всех репозиториев из `workspace.yaml` и отправляет его фрагменты выбранному провайдеру LLM
- Выгрузка в Linear, Jira и Notion создает задачи и страницы во внешних сервисах по токенам из переменных окружения или `workspace.yaml`
- Команда `corbell ui serve` открывает локальный сайт на порту 7433, а `corbell mcp serve` дает MCP-клиенту доступ к графу и поиску по коду
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Фича затрагивает пять-десять репозиториев, а решения о Kafka или SQS, схемах авторизации и владельце ограничения запросов лежат в Confluence и чатах. Corbell собирает эту картину из самого кода. Команда `corbell graph build --methods` строит граф сервисов, зависимостей и вызовов в локальной базе SQLite: типизированные сигнатуры методов, потоки выполнения, пары файлов, которые часто меняются вместе, хранилища и очереди. Поддерживаются Python, JavaScript, TypeScript, Go, Java, C#, Rust, Ruby и PHP. По документу PRD `corbell spec new --feature "Payment Retry" --prd-file prd.md` пишет проектный документ. Сначала он по смыслу находит нужные сервисы: индекс фрагментов кода строит модель all-MiniLM-L6-v2, а флаг `--service` указывать не нужно. Затем подмешивает топологию графа, реальные фрагменты кода и паттерны, которые команда извлекла из прошлых RFC и ADR командами `corbell docs scan` и `corbell docs learn`. После каждого запроса к модели Corbell печатает расход токенов и оценку стоимости. Без ключа режим шаблона создает каркас документа с контекстом из графа. Дальше документ можно проверить на соответствие графу и ограничениям командой `corbell spec review`, утвердить, разбить на параллельные треки задач `corbell spec decompose` и выгрузить в Linear, Jira или Notion. Для просмотра графа есть локальный интерфейс `corbell ui serve` на порту 7433, а команда `corbell mcp serve` отдает граф, поиск по коду и список сервисов Cursor и Claude Desktop.
Для кого. Ведущим инженерам и архитекторам бэкенда, у которых фичи проходят через много репозиториев и нужны проектные документы, согласованные с уже принятыми решениями.
Подходит, если
- Новый PRD затрагивает несколько сервисов, и нужен черновик проектного документа с верными именами методов и сервисов
- Команда хочет, чтобы новые документы опирались на старые RFC и ADR, а не придумывали паттерны заново
- Надо задокументировать существующую кодовую базу без PRD: для этого есть режим `corbell spec new --existing`
- Архитектурные ограничения вроде «только Azure» или «p99 ниже 200 мс» должны проверяться в каждом новом документе
- Утвержденный документ нужно разбить на задачи и выгрузить в Linear или Jira вместе с контекстом методов и сервисов
Не подходит, если
- Проект состоит из одного небольшого репозитория: граф сервисов и поиск по нескольким репозиториям тут ничего не добавят
- Нужен контекст кода для агента прямо в редакторе без проектных документов: подойдет индексатор кода с MCP
- Код нельзя отправлять внешним моделям, а локальной модели нет: без нее остается только режим шаблона без LLM
- Задача состоит в настройке правил и памяти агента, проектные документы не нужны
Пример запроса к агенту
Построй граф по моим репозиториям и напиши проектный документ для фичи «Повтор платежа с экспоненциальной задержкой» по файлу docs/payment-retry-prd.mdОграничения
Нужен Python 3.11 или новее. Зависимости объемные: sentence-transformers для индекса, а модель эмбеддингов загружается отдельно. Для провайдеров LLM установите нужный дополнительный набор: `pip install "corbell[anthropic]"` или `corbell[openai]`. Поддерживаются anthropic, openai, ollama, aws, azure и gcp, ключи задаются переменными окружения вроде ANTHROPIC_API_KEY.
Выгрузка в Linear требует CORBELL_LINEAR_API_KEY, выгрузка в Jira берет адрес, почту и токен из `workspace.yaml`. Доступность провайдеров Anthropic и OpenAI из России при подготовке карточки не проверялась, локальный Ollama ключа не просит.
Как отключить. Удалите пакет командой `pip uninstall corbell`. В Cursor и Claude Desktop уберите блок corbell из конфигурации MCP. Рабочая папка `corbell-data` с графом и конфигом `workspace.yaml` остается в вашем проекте, ее можно удалить вручную.
Частые вопросы
Как поставить Corbell?
Выполните `pip install corbell`, для доступа к модели добавьте набор: `pip install "corbell[anthropic]"` для Claude или `"corbell[openai]"` для GPT-4o. Для выгрузок есть наборы notion, linear и jira. Нужен Python 3.11 или новее. После установки запустите `corbell init`, и в проекте появится `workspace.yaml`.
Как подключить Corbell к Cursor или Claude Desktop?
Команда `corbell mcp serve` запускает MCP-сервер по stdio. В `~/.cursor/mcp.json` или `claude_desktop_config.json` добавьте блок corbell с командой corbell и аргументами mcp serve. Если редактор меняет рабочую папку, задайте переменную CORBELL_WORKSPACE с путем к проекту. Для клиентов в браузере есть режим SSE: `--transport sse --port 8000`.
Какие инструменты MCP дает Corbell?
Четыре: graph_query ищет зависимости сервисов, методы и пути вызовов, get_architecture_context находит сервисы, нужные для описания фичи, code_search ищет по смыслу в индексе кода, list_services выводит список сервисов графа.
Можно ли запустить Corbell без ключа API?
Да, двумя способами. Флаг `--no-llm` и режим шаблона создают каркас документа с контекстом из графа. А провайдер ollama работает с локальной моделью вроде llama3 или mistral и ключа не требует.
Как Corbell выбирает сервисы для документа?
Он формирует три-четыре поисковых запроса по PRD, кодирует их моделью all-MiniLM-L6-v2 и ищет похожие фрагменты кода в индексе. Сервисы ранжируются по числу фрагментов в верхе выдачи, а сервисы с тегом infrastructure, например репозитории AWS CDK, добавляются всегда. Увидеть выбор без генерации можно командой `corbell spec context "..."`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПлагин для Claude Code ведет фичу от PRD до слияния: субагенты работают волнами в отдельных ветках, каждый PR проходит ревью
CLI строит граф зависимостей по коду без нейросетей и отдает его агенту по MCP: что заденет правка, не нарушены ли слои
Одиннадцать скиллов ведут агента от идеи до проверенного кода через PRD и RFC, которые хранятся в файлах репозитория
codesight за один запуск собирает карту проекта: маршруты, модели БД, зависимости, env-переменные. Отдает ее агенту файлами или через MCP-сервер
Скилл рисует каждый pull request как схему архитектуры и потоков данных прямо в описании PR, чтобы ревью шло быстрее
Скилл /graphify строит граф знаний по коду, документам и PDF проекта, чтобы агент отвечал запросами к графу, а не грепом
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Corbell (эта запись) | нет | 628 | ||
| GitNexus | нет | не нужна | 48 101 | индексирует один репозиторий в граф знаний и отвечает агенту по MCP, документы не пишет |
| CCPM | нет | 8 423 | скилл управления разработкой через PRD, эпики и задачи с синхронизацией с GitHub, без графа кода |
Коротко о README
README начинается с проблемы: решения по архитектуре теряются в страницах Confluence и чатах, а новому инженеру приходится начинать с нуля. Дальше схема работы от графа и сканирования документов до проектного документа, проверки, разбиения на задачи и выгрузки. Затем идут установка, быстрый старт за две минуты и подробное руководство: конфигурация рабочей папки, сборка графа, генерация документа, ограничения, проверка и экспорт, интерфейс графа, справочник команд, MCP, автоматический выбор сервисов и провайдеры LLM.