AWR
GitHub
Русский
English中文Españolहिन्दीPortuguêsРусский日本語한국어DeutschFrançais

Подключите вашего агента

Исходный файл на GitHub

AWR не запускает вашего агента. Клиент агента (Codex, Claude Code, Kimi, Cursor, Grok) выполняет работу своими собственными инструментами; AWR предоставляет актуальные факты проекта, рабочий контекст, захваты и восстанавливаемую память сессий для того же инициализированного проекта. Метки провайдера и модели в записях сессий AWR — только метаданные: они никогда не запускают и не настраивают клиент.

Каждый поддерживаемый клиент следует одной и той же схеме:

  1. Соберите оба исполняемых файла из checkout AWR:
cargo build --locked -p awr-cli -p awr-mcp
  1. Инициализируйте целевой проект из его проверенного манифеста источников (см. Быстрый старт), затем зарегистрируйте сервер awr-mcp в клиенте, указав --project на абсолютный путь проекта. Каждый сервер привязывается к одному каноническому корню проекта; давайте серверам для разных проектов разные имена.
  2. Проверьте соединение — файл конфигурации на диске не является живым соединением — и подтвердите идентичность проекта чтением статуса до любой работы.
  3. Работайте в общем жизненном цикле сессий: начните или возобновите сессию, прочитайте контекст, создайте контрольную точку перед передачей, завершите, когда останавливаетесь. См. CLI и Инструменты MCP.

Разделы ниже дают пути слияния конфигурации, настройку и оговорки для каждого клиента. Там, где клиент документирует автоматические хуки жизненного цикла, считайте их непроверенными, пока вы не увидели реальное срабатывание и квитанцию; ручной процесс контрольных точек и возобновления работает всегда.

Codex

Codex загружает конфигурацию проекта только для доверенных проектов; его CLI, настольный и IDE-клиенты разделяют конфигурацию MCP на одном хосте. Выберите один из двух вариантов: слейте шаблон конфигурации MCP в .codex/config.toml проекта (заменив его два пути, сохранив существующую конфигурацию) или зарегистрируйте на уровне пользователя:

codex mcp add awr -- /absolute/path/to/awr-mcp \
  --project /absolute/path/to/initialized/project
codex mcp get awr --json

В представлении /mcp клиента подтвердите подключённый сервер awr и проверьте идентичность проекта до работы; настроенный сервер не доказывает активное соединение. Ожидаемые инструменты чтения: awr_project_status, awr_work_ready, awr_work_get, awr_context_compile, awr_search. Инструменты изменения: awr_work_transition, awr_event_append, awr_evidence_record. Сервер не требует API-ключа модели.

Codex — единственный клиент с установщиком автоматических хуков жизненного цикла: используйте awr client install, чтобы предварительно просмотреть точную конфигурацию до --accept. Установка сохраняет существующие хуки и никогда не одобряет их доверие автоматически. Codex документирует SessionStart (startup|resume|clear|compact), PreCompact (manual|auto) и SessionEnd (совещательный, короткий тайм-аут). Проверьте фактическую доставку срабатываний в клиенте — до этого создавайте контрольные точки вручную перед передачей или компактификацией.

Claude Code

Claude Code подключается через именованный управляемый адаптер (id адаптера claude_code). Он не автозапускаем: AWR не запустит Claude Code за вас и не остановит его сам — эти шаги остаются за вами. Что адаптер поддерживает, так это чтение статуса, переподключение/возобновление и криминалистику результатов.

Путь оператора:

  1. Запустите Claude Code самостоятельно.
  2. Привяжите его к AWR через общий клиент и нативный ID диалога:
awrj client bind --client generic --external-session claude:<native-id> \
  --work "$AWR_WORK" --session "$AWR_SESSION"
  1. Когда вам нужны наблюдения AWR, сообщайте фазы через отчёт о внешнем выполнении общего CLI.
  2. При повторе переподключите ту же идентичность выполнения, прежде чем начинать что-либо новое.

Kimi

Это руководство ориентировано на Kimi Code 0.41.0 (проверено 2026-09-08); более старые выпуски kimi-cli используют другие пути конфигурации и флаги, поэтому сначала проверьте kimi --version и kimi --help. Используйте терминальный инструмент Kimi для вызова CLI AWR и опционально подключите тот же проект через stdio MCP, слив этот сервер в .kimi-code/mcp.json проекта (уровень пользователя: ~/.kimi-code/mcp.json), сохранив другие записи:

{
  "mcpServers": {
    "awr": { "command": "/absolute/path/to/awr-mcp",
      "args": ["--project", "/absolute/path/to/initialized/project"],
      "cwd": "/absolute/path/to/initialized/project" }
  }
}

Конфигурация проекта требует доверия рабочей области. Используйте /mcp-config для настройки и /mcp для инспекции статуса соединения; серверы, добавленные редактированием конфигурации, подключаются к вновь созданным сессиям. Подтвердите идентичность проекта через awr_project_status. Метка провайдера для метаданных сессий Kimi — moonshot.

Собственные kimi --continue, kimi --session <kimi-conversation-id> и /compact Kimi работают с его диалогом; их ID отделены от ID AWR. После компактификации скомпилируйте контекст для той же активной сессии AWR — явное возобновление AWR нужно только для реальной передачи. Kimi документирует хуки SessionStart, SessionEnd, PreCompact и PostCompact, но эта интеграция не устанавливает никакого автоматического адаптера; используйте ручной процесс контрольных точек.

Cursor

Проверено на Cursor 3.18.9 (2026-09-17). Не запускайте awr client install для Cursor (Unsupported) и не передавайте --client cursor в bind (InvalidInput) — используйте идентичность общего клиента, показанную ниже. Слейте шаблон stdio в .cursor/mcp.json проекта или пользовательский ~/.cursor/mcp.json:

{
  "mcpServers": {
    "awr": { "type": "stdio", "command": "/absolute/path/to/awr-mcp",
      "args": ["--project", "/absolute/path/to/initialized/project"] }
  }
}

Таблица полей stdio Cursor требует "type": "stdio" и не принимает cwd. AWR нужен только абсолютный command плюс --project. Перезагрузите окно и проверьте Output → MCP Logs при сбое запуска; когда существуют оба файла конфигурации, подтвердите в Customize, какой из них подключило Agent Window. Две оговорки:

Сгруппированные инструменты. В текущем дереве исходников tools/list по умолчанию возвращает восемь доменных инструментов (awr_query, awr_context, awr_work, awr_evidence, awr_session, awr_continuity, awr_change, awr_compaction) вместо плоских имён инструментов. Проверяйте статус через awr_query:

{"child_tool": "awr_project_status", "arguments": {}}

Плоские имена остаются вызываемыми, но их нет в каталоге по умолчанию; устанавливайте AWR_MCP_TOOL_EXPOSURE_MODE=flat, только если ваша сборка Cursor не может маршрутизировать через домены. Упакованные релизы не предоставляют сгруппированный awr_query — соберите из дерева исходников для этого пути и сначала проверьте каталог инструментов вашей сборки.

Cloud Agents не могут достучаться до awr-mcp на ноутбуке или 127.0.0.1; им нужна достижимая HTTPS-входная точка с серверными корнями проектов. Общий HTTP-сервис AWR использует bearer-токен (не Cursor OAuth):

{
  "mcpServers": {
    "awr": { "url": "http://127.0.0.1:8080/mcp",
      "headers": { "Authorization": "Bearer ${env:AWR_ENGINEERING_TOKEN}" } }
  }
}

Для идентичности привяжите общий клиент с нативным ID диалога, завершаясь ошибкой, если он пуст, чтобы вы никогда не привязали буквальный cursor::

: "${HOST_CONVERSATION_ID:?set the native host conversation ID first}"
AWR_EXTERNAL="cursor:${HOST_CONVERSATION_ID}"
awrj client bind --client generic --external-session "$AWR_EXTERNAL" \
  --work "$AWR_WORK" --session "$AWR_SESSION"

Cursor документирует хуки sessionStart, sessionEnd и preCompact в .cursor/hooks.json, но установщика для этого диалекта нет — создавайте контрольные точки вручную, пока у вас нет живого срабатывания хука и квитанции контрольной точки.

Grok

Проверено на Grok Build 1.0.13 (2026-09-08). Используйте терминальный инструмент Grok для вызова CLI AWR или подключите его stdio MCP-клиент из каталога проекта:

cd /absolute/path/to/initialized/project
grok mcp add --scope project awr -- /absolute/path/to/awr-mcp \
  --project /absolute/path/to/initialized/project
grok mcp doctor awr --json

add --scope project записывает или обновляет .grok/config.toml (область пользователя — по умолчанию, когда флаг опущен); используйте другое имя сервера, если awr уже ссылается на другой проект. Эквивалентная таблица:

[mcp_servers.awr]
command = "/absolute/path/to/awr-mcp"
args = ["--project", "/absolute/path/to/initialized/project"]

Используйте /mcps в Grok Build для инспекции и обновления соединений, затем вызовите awr_project_status и проверьте идентичность проекта. Доверие проекту — отдельное предварительное условие: недоверенная папка оставляет сервер незапущенным, поэтому сначала проверьте проект в обычном процессе доверия клиента. Метка провайдера для метаданных сессий Grok — xai.

Нативное продолжение диалога Grok отделено от восстановления сессий AWR:

grok --cwd "$AWR_PROJECT" --continue
grok --cwd "$AWR_PROJECT" --resume <grok-conversation-id>

--session-id Grok создаёт новый диалог — это ни ID AWR, ни флаг возобновления. После нативной компактификации скомпилируйте контекст для той же активной сессии AWR; используйте явный процесс возобновления AWR только для реальной передачи.

Grok Build документирует события сессии и компактификации в своей системе хуков, но автоматический адаптер здесь не устанавливается; используйте ручной процесс контрольных точек, пока не проверите фактическое срабатывание и квитанцию. Пользовательские коннекторы Grok web требуют достижимый MCP URL — локальный путь к исполняемому файлу нельзя ввести как этот URL; общий HTTP-сервис AWR может служить этой роли, но его развёртывание и выполнение требований аутентификации коннектора — отдельный шаг, который это руководство не проверяет.

Следующие шаги

  • Инструменты MCP — полная поверхность инструментов, которую ваш клиент может вызывать после подключения.
  • Ежедневный рабочий процесс — цикл «старт — работа — контрольная точка — возобновление», какой бы клиент вы ни использовали.