Перейти к основному содержимому

Быстрый старт OpenCode с CodeGraph

Запуск текущей интеграции OpenCode и поддерживаемый набор команд. Страница объясняет назначение, порядок применения и проверку результата.

Руководства

Репозиторный launcher настраивает MCP-сервер CodeGraph, LSP и plugin opencode-codegraph для текущего checkout. Перед запуском импортируйте проект и проверьте актуальность его CPG.

Интерактивная сессия

python scripts/run_opencode_codegraph.py --project <project-name>

Текущая модель launcher по умолчанию — openai/gpt-5.4. Меняйте её только на одобренную и доступную в вашем OpenCode:

python scripts/run_opencode_codegraph.py --project <project-name> --model <provider/model>

Версия source package — opencode-codegraph 0.1.38. Launcher получает опубликованную dependency version из package manifest; не закрепляйте старый npm range в локальной инструкции.

Поддерживаемые команды CodeGraph

Текущий каталог .opencode/commands содержит:

  • /audit — ограниченный audit workflow;
  • /continue — продолжение явной сессии CodeGraph;
  • /explain — объяснение кода с project evidence;
  • /next — проверка состояния и выбор следующего governed action;
  • /onboard — привязка текущего репозитория и project context;
  • /review — review ограниченного изменения;
  • /status — состояние сессии и контекста;
  • /update — обновление project context по контракту команды.

Поддержку slash command подтверждает её наличие в .opencode/commands и рабочий вызов из help.

Headless-запуск

Для одного неинтерактивного запроса:

python scripts/run_opencode_codegraph.py `
  --project <project-name> `
  --run "Explain the impact of changing <symbol> and cite source locations"

Используйте --session <id> или --continue-last только для нужной сессии. Проверьте имя проекта в ответе и сохраните предупреждения о freshness или degraded mode.

Проверка и восстановление

  1. Убедитесь, что launcher показывает ожидаемые project и API endpoint.
  2. До первой задачи выполните /status.
  3. Если MCP недоступен, проверьте здоровье CodeGraph и project scope; не подменяйте их raw database arguments.
  4. При устаревшем plugin повторите launcher без --no-plugin-install.
  5. При устаревших evidence обновите проект до принятия ответа.

Ответ агента остаётся рекомендательным, пока профессиональный reviewer не проверит указанный код и revision проекта.

Источники контракта

  • scripts/run_opencode_codegraph.py — default model, project/session flags и setup;
  • integrations/opencode/opencode-codegraph/package.json — версия plugin;
  • .opencode/commands — поддерживаемые command files;
  • .opencode/agents/codegraph.md — agent profile CodeGraph.

См. также: CLI · Диагностика