Conecta tu agente

AWR no ejecuta tu agente. El cliente del agente (Codex, Claude Code, Kimi, Cursor, Grok) hace el trabajo con sus propias herramientas; AWR aporta hechos actualizados del proyecto, contexto de trabajo, reservas y memoria de sesión recuperable para el mismo proyecto inicializado. Las etiquetas de proveedor y modelo en los registros de sesión de AWR son solo metadatos: nunca lanzan ni configuran el cliente.

Cada cliente soportado sigue el mismo patrón:

Compila ambos ejecutables desde un checkout de AWR:

cargo build --locked -p awr-cli -p awr-mcp

Inicializa el proyecto de destino a partir de su manifiesto de fuente revisado (consulta Inicio rápido) y luego registra el servidor awr-mcp en el cliente, apuntando --project a la ruta absoluta del proyecto. Cada servidor se vincula a una única raíz de proyecto canónica; da a los servidores de proyectos distintos nombres distintos.
Verifica la conexión — un archivo de configuración en disco no es una conexión activa — y confirma la identidad del proyecto con una lectura de estado antes de cualquier trabajo.
Trabaja el ciclo de vida de sesión compartido: inicia o reanuda una sesión, lee el contexto, guarda un punto de control antes del traspaso, termina cuando pares. Consulta CLI y Herramientas MCP.

Las secciones siguientes dan las rutas de fusión, la configuración y las advertencias de cada cliente. Cuando un cliente documenta hooks automáticos de ciclo de vida, trátalos como no verificados hasta que hayas visto un disparador real y un recibo; el flujo manual de punto de control/reanudación siempre funciona.

Codex

Codex carga la configuración del proyecto solo para proyectos de confianza; sus clientes de CLI, escritorio e IDE comparten la configuración MCP en el mismo host. Elige una de dos opciones: fusionar la plantilla de configuración MCP en el .codex/config.toml del proyecto (reemplazando sus dos rutas y preservando la configuración existente), o registrar a nivel de usuario:

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

En la vista /mcp del cliente, confirma un servidor awr conectado y verifica la identidad del proyecto antes de trabajar; un servidor configurado no es prueba de una conexión activa. Herramientas de lectura esperadas: awr_project_status, awr_work_ready, awr_work_get, awr_context_compile, awr_search. Herramientas de mutación: awr_work_transition, awr_event_append, awr_evidence_record. El servidor no requiere una clave de API de modelo.

Codex es el único cliente con un instalador para hooks automáticos de ciclo de vida: usa awr client install para previsualizar la configuración exacta antes de --accept. La instalación preserva los hooks existentes y nunca aprueba su confianza automáticamente. Codex documenta SessionStart (startup|resume|clear|compact), PreCompact (manual|auto) y SessionEnd (informativo, tiempo de espera corto). Verifica la entrega real de disparadores en el cliente: hasta entonces, guarda puntos de control manualmente antes del traspaso o la compactación.

Claude Code

Claude Code se conecta a través de un adaptador controlado con nombre (id de adaptador claude_code). No es autoarrancable: AWR no lanzará Claude Code por ti, y tampoco lo detendrá por su cuenta; esos pasos quedan contigo. Lo que el adaptador sí soporta es leer el estado, reconectar/reanudar y la forense de resultados.

Ruta del operador:

Inicia Claude Code tú mismo.
Vincúlalo a AWR con el cliente genérico y el ID de conversación nativo:

awrj client bind --client generic --external-session claude:<native-id> \
  --work "$AWR_WORK" --session "$AWR_SESSION"

Cuando necesites observaciones de AWR, informa de las fases a través del informe de ejecución externa de la CLI compartida.
En un reintento, reconecta la misma identidad de ejecución antes de empezar cualquier cosa nueva.

Kimi

Esta guía se orienta a Kimi Code 0.41.0 (inspeccionado el 2026-09-08); las versiones anteriores de kimi-cli usan rutas de configuración y banderas distintas, así que comprueba primero kimi --version y kimi --help. Usa la herramienta de terminal de Kimi para llamar a la CLI de AWR y, opcionalmente, conecta el mismo proyecto por MCP stdio fusionando este servidor en el .kimi-code/mcp.json del proyecto (a nivel de usuario: ~/.kimi-code/mcp.json), preservando las demás entradas:

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

La configuración del proyecto requiere confianza del workspace. Usa /mcp-config para la configuración y /mcp para inspeccionar el estado de la conexión; los servidores añadidos editando la configuración se incorporan a las sesiones recién creadas. Confirma la identidad del proyecto con awr_project_status. La etiqueta de proveedor para los metadatos de sesión de Kimi es moonshot.

Los propios kimi --continue, kimi --session <kimi-conversation-id> y /compact de Kimi operan sobre su conversación; sus ID son independientes de los ID de AWR. Tras una compactación, compila el contexto para la misma sesión AWR activa: una reanudación explícita de AWR es solo para un traspaso real. Kimi documenta los hooks SessionStart, SessionEnd, PreCompact y PostCompact, pero esta integración no instala ningún adaptador automático; usa el proceso manual de punto de control.

Cursor

Comprobado contra Cursor 3.18.9 (2026-09-17). No ejecutes awr client install para Cursor (Unsupported), y no pases --client cursor a bind (InvalidInput): usa la identidad de cliente genérico que se muestra abajo. Fusiona la plantilla stdio en el .cursor/mcp.json del proyecto o en el ~/.cursor/mcp.json de usuario:

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

La tabla de campos stdio de Cursor requiere "type": "stdio" y no acepta cwd. AWR solo necesita un command absoluto más --project. Recarga la ventana y comprueba Output → MCP Logs ante un fallo de arranque; cuando existen ambos archivos de configuración, confirma en Customize cuál adjuntó la Agent Window. Dos advertencias:

Herramientas agrupadas. En el árbol fuente actual, el tools/list predeterminado devuelve ocho herramientas de dominio (awr_query, awr_context, awr_work, awr_evidence, awr_session, awr_continuity, awr_change, awr_compaction) en lugar de nombres de herramientas planos. Sondea el estado a través de awr_query:

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

Los nombres planos siguen siendo llamables pero no están en el catálogo predeterminado; define AWR_MCP_TOOL_EXPOSURE_MODE=flat solo si tu build de Cursor no puede enrutar a través de dominios. Las versiones empaquetadas no exponen el awr_query agrupado: compila desde el árbol fuente para esta ruta, y comprueba primero el catálogo de herramientas de tu build.

Cloud Agents no puede alcanzar un awr-mcp de portátil ni 127.0.0.1; necesita una puerta de entrada HTTPS alcanzable con raíces de proyecto en el lado del servidor. El servicio HTTP compartido de AWR usa un token bearer (no OAuth de Cursor):

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

Para la identidad, vincula el cliente genérico con el ID de conversación nativo, fallando si está vacío para que nunca vincules el literal 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 documenta los hooks sessionStart, sessionEnd y preCompact en .cursor/hooks.json, pero no hay instalador para ese dialecto: guarda puntos de control manualmente hasta que tengas un disparador de hook en vivo y un recibo de punto de control.

Grok

Comprobado contra Grok Build 1.0.13 (2026-09-08). Usa la herramienta de terminal de Grok para llamar a la CLI de AWR, o conecta su cliente MCP stdio desde el directorio del proyecto:

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 escribe o actualiza .grok/config.toml (el ámbito de usuario es el predeterminado cuando se omite la bandera); usa un nombre de servidor distinto si awr ya se refiere a otro proyecto. La tabla equivalente es:

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

Usa /mcps en Grok Build para inspeccionar y refrescar las conexiones, luego llama a awr_project_status y verifica la identidad del proyecto. La confianza del proyecto es un prerrequisito aparte: una carpeta sin confianza deja el servidor sin arrancar, así que revisa primero el proyecto en el flujo de confianza normal del cliente. La etiqueta de proveedor para los metadatos de sesión de Grok es xai.

La continuación de conversación nativa de Grok es independiente de la recuperación de sesión de AWR:

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

El --session-id de Grok crea una conversación nueva: no es ni un ID de AWR ni una bandera de reanudación. Tras la compactación nativa, compila el contexto para la misma sesión AWR activa; usa el flujo explícito de reanudación de AWR solo para un traspaso real.

Grok Build documenta eventos de sesión y compactación en su sistema de hooks, pero aquí no se instala ningún adaptador automático; usa el proceso manual de punto de control hasta que hayas verificado un disparador real y un recibo. Los conectores personalizados de Grok web requieren una URL MCP alcanzable: una ruta de ejecutable local no puede introducirse como esa URL; el servicio HTTP compartido de AWR puede servir ese papel, pero desplegarlo y cumplir los requisitos de autenticación del conector es un paso aparte que esta guía no verifica.

Próximos pasos

Herramientas MCP — toda la superficie de herramientas que tu cliente puede llamar una vez conectado.
Flujo de trabajo diario — el bucle de inicio, trabajo, punto de control y reanudación, uses el cliente que uses.