Project Sentinel: traspaso de contexto de Claude Code y control de la ejecución

Project Sentinel es un mod de la comunidad creado por los colaboradores de Project Sentinel (Arjun0014). Está pensado para sesiones largas de Claude Code, y su función más conocida es el traspaso de contexto de Claude Code: cuando la ventana de contexto se llena, Context Autopilot pide a Claude que termine la unidad de trabajo actual y escriba un archivo de notas, y después vacía el contexto y empieza uno nuevo que lee esas notas. El mod se llamó Control Room hasta la versión 1.4.0, por eso el panel y la barra de estado siguen llevando ese nombre.

Alrededor de eso añade mucho más. Una barra de estado sobre el prompt muestra el uso del contexto, la caché de prompts y el coste de la ejecución. Cache Guardian controla cuánto tiempo sigue caliente la caché de prompts y pregunta antes de un cambio de modelo que volvería a enviar 100k tokens o más. Las categorías de permisos te permiten configurar las instalaciones de paquetes, los pushes, los despliegues y acciones similares para que pidan confirmación o se denieguen. Otras partes incluyen una Mission Queue y una Decision Inbox, límites de subagentes, un enrutador de modelos, un regulador de carga de la máquina y un compañero pixelado opcional. El README del autor las enumera todas; esta página cubre lo que comprobamos en el código.

La grabación inicia Claude Code con el mod cargado en el pequeño proyecto de demostración y pide a Claude que lea README.md y describa el proyecto en una frase. Antes del prompt, la barra sobre la entrada dice "Ready" con una insignia de Control Room y RUN $0.00. Mientras se ejecuta el turno cambia a "Thinking" y después muestra el medidor de contexto llenándose hasta el 4%. Cuando el turno termina muestra "Read 1 file", la barra de contexto, CACHE 1h left y el coste de la ejecución, de menos de un céntimo.

Usa cualquiera de los métodos del bloque de instalación; instalan directamente desde el marketplace del propio autor, llamado control-room. La barra aparece en el siguiente inicio de sesión. Ejecuta /control-room o /cr para abrir el panel.

El plugin tiene un único módulo de hooks, hooks/register.tsx, que construye un solo adaptador de host para todas las llamadas al motor y registra cada hook como unas pocas líneas que llaman a un objeto de runtime. Cada hook de control tiene un .catch que recurre al comportamiento propio de Claude Code. Este es el hook de llamadas a herramientas, de hooks/register.tsx:

on('tool.call', async ($, e, next) => {
  if (rt.isStandby) return next(e)
  if (rt.host === null) rt.bind(hostOf($))
  const tool = String(e.tool)
  const input: Record<string, unknown> = isRecord(e) ? { ...e } : {}
  const refusal = await rt.beforeTool(tool, input, e.tool_use_id, e.agentId)
  if (refusal !== null) return { deny: refusal }
  // ... then next(e), with afterTool in a finally block
})

beforeTool divide en tokens los comandos de shell, clasifica cada segmento en una categoría de permisos y aplica el ajuste más estricto. Si esa comprobación falla, el .catch sigue rechazando los comandos claramente peligrosos. El estado se guarda en el $.store del plugin (ajustes, registros de ejecución, memoria de la caché) y en átomos de $.state que leen los hooks de renderizado.

Todo se configura desde el panel (/cr) o con el comando /cr: perfiles, umbral de Autopilot (70% de la ventana por defecto, o un número de tokens), el nombre del archivo de traspaso, el estado de los permisos por categoría, el estilo de respuesta, la estrategia del enrutador, el modo y el límite de subagentes, los topes de recursos, Keep warm y el compañero. /cr reset confirm restaura los valores por defecto. El docs/CONFIGURATION.md del autor enumera todas las opciones.

Leímos el manifiesto, hooks/hooks.json, hooks/register.tsx, el adaptador de host, core/settings.ts, features/prompts.ts, features/permissions/decide.ts, app/formerStore.ts y el SECURITY.md del autor. El plugin tiene unos 60 archivos TypeScript (unas 7.800 líneas en los cuatro más grandes). No leímos cada línea de la interfaz, del panel ni del módulo del compañero de 3.000 líneas (kit.client.tsx); para esos y el resto buscamos en todos los archivos llamadas de red, eval, importaciones dinámicas, llamadas a procesos, escrituras de archivos, secretos y Unicode oculto, y no encontramos nada más allá de lo que se indica aquí. No hay package.json en el plugin, ni script de instalación, ni binarios, ni código minificado.

Resultados:

• Red: ninguna. No hay fetch, sockets ni hosts. Las peticiones al modelo pasan por el propio cliente de Claude Code (la comprobación opcional del guardián y Keep warm, que está desactivado por defecto y vuelve a enviar la última petición con un mensaje corto "reply ok").
• Procesos: top -l 0 -s 2 -n 0 (un muestreador de CPU y memoria de larga duración que se ejecuta mientras "Live CPU and memory" está activado, que es lo predeterminado) y sysctl -n kern.memorystatus_level en macOS; typeperf y systeminfo en Windows; git status --porcelain=v1 --branch en repositorios git. Todos usan argumentos fijos y ninguna shell. El muestreador se detiene cuando termina la sesión.
• Escritura de archivos: ninguna por parte del propio plugin, salvo su propio archivo de $.store. El archivo de notas del traspaso (NEXT_SESSION_PROMPT.md por defecto) lo escribe Claude con sus herramientas normales, sujetas a permisos. Lee una vez el antiguo archivo de almacén de Control Room en ~/.claude/plugins/store/ para trasladar los ajustes; ese archivo nunca se modifica.
• Daemons: ninguno. Los temporizadores de los vigilantes viven en el proceso de Claude Code.
• Entorno: lee HOME, USERPROFILE y CLAUDE_CONFIG_DIR (para encontrar el almacén antiguo) y los ajustes de la caché de prompts CLAUDE_CODE_PROMPT_CACHE_TTL, ENABLE_PROMPT_CACHING_1H y FORCE_PROMPT_CACHING_5M. El resumen del SECURITY.md del autor dice que nunca lee variables de entorno, pero su propia tabla incluye esta lectura. No se envía nada a ningún sitio.
• Telemetría: ninguna.
• Influencia en el modelo: añade una sección de directrices al prompt del sistema cuando están activadas funciones como Autopilot o Frontier Max, añade notas breves a los resultados de las herramientas, ofrece dos herramientas (milestones y decision_request) y envía sus propios prompts (traspaso, continuación, trabajo en cola). El texto está en features/prompts.ts. Frontier Max (desactivado por defecto) le dice a Claude que la sesión "is being evaluated for frontier-level autonomous capability" y que evite detenerse antes de tiempo. No encontramos texto oculto ni de ancho cero, ni instrucciones dirigidas a un revisor.
• Hooks de control: puede rechazar llamadas a herramientas (por defecto: force push, resets y comandos peligrosos denegados; instalaciones, descargas, pushes, despliegues, borrados y ediciones fuera del proyecto piden confirmación), preguntar antes de un cambio de modelo o de reanudar un contexto grande con la caché fría, ocultar o rechazar subagentes y continuar un turno que se detuvo antes de tiempo (guardián, desactivado por defecto). Nunca responde a una comprobación de permisos y nunca relaja una denegación. Esto coincide con el README.
• Requisitos externos: ninguno más allá de Claude Code 2.1.287 o posterior. top y sysctl vienen con macOS.
• Licencia: MIT, con un archivo LICENSE en el repositorio y en la carpeta del plugin.

claude plugin validate no informó de errores ni avisos. El comando claude plugin test no encontró archivos *.test.ts en la carpeta del plugin, porque el autor guarda el entorno de tests en una carpeta tools/test aparte del repositorio, así que no pudimos ejecutar los tests del autor. Trata el mod como amplio e invasivo: puede reescribir prompts, denegar herramientas y vaciar tu contexto cuando activas esas funciones.

Comprobado con Claude Code 2.1.296 en macOS (validate y una sesión grabada). Si algo no parece ir bien:

• Ejecuta /cr para ver el panel y los ajustes actuales.
• Si falta la barra, revisa el estilo de la barra en Setup; se puede desactivar.
• Si Claude rechaza un comando, mira en Guardrails: los estados de permisos por defecto deniegan los force push y los comandos peligrosos.
• Si también tienes cargado el antiguo plugin control-room, Project Sentinel queda en espera y lo avisa una vez.
• En Windows, los contadores de CPU y memoria necesitan un Windows en inglés.