Codex Agent Monitor

Extensión de VS Code que muestra las conversaciones principales de Codex en una lista compacta, como la vista Todos de Codex. Cada fila muestra el título real del chat. Un círculo verde indica que está trabajando; los chats sin actividad en curso muestran el tiempo desde su última actividad. La tarea completa y el estado se pueden leer al pasar el cursor. Las conversaciones terminadas siguen visibles hasta pulsar Acabado (✓). El panel se sitúa por defecto en la barra lateral izquierda para mantener el chat de Codex abierto a la derecha. Se actualiza automáticamente y ofrece un botón de actualización en su cabecera. También permite editar el nombre real de un chat mediante Codex.

Requisitos

VS Code 1.106 o posterior.
Codex instalado para que existan sesiones locales que observar.

Crear e instalar

Desde esta carpeta:

npm install
npm test
npm run package
code --install-extension .\codex-agent-monitor.vsix

Abre Agentes Codex desde su icono en la barra de actividad izquierda, o ejecuta Codex Monitor: Mostrar agentes en la paleta de comandos. La vista Actividad cabe en un ancho reducido; puedes ajustarlo arrastrando el borde de la barra. El chat de Codex queda disponible a la derecha. Si no aparece tras instalar, recarga una vez la ventana de VS Code.

Usa Buscar chats recientes para filtrar por título. Pulsa la parte principal de una fila para abrir esa conversación en la barra de Codex. El lápiz Editar nombre abre un cuadro con el título actual; al confirmar, cambia el nombre de esa conversación en Codex. Cancelar el cuadro no cambia nada. El botón ✓ es independiente: solo quita la fila del monitor y guarda esa preferencia localmente; no borra el chat de Codex. La lista se conserva al cerrar VS Code, al terminar el turno y aunque los archivos de sesiones dejen de estar disponibles. Si empieza otro turno en una conversación marcada como acabada, vuelve a aparecer. La navegación desde una fila usa la ruta de conversación de la extensión Codex instalada (/local/<thread-id>), comprobada en openai.chatgpt 26.51002.51308; no es una API pública estable. Si una versión futura cambia esa ruta, la lista seguirá funcionando pero el acceso directo puede requerir una actualización.

VS Code recuerda los paneles que mueves. Si prefieres otra ubicación, arrastra el icono Agentes Codex a la barra lateral deseada. Para ver chat y monitor simultáneamente, deja el monitor a la izquierda y Codex a la derecha. Desde la versión 0.1.1 se usan identificadores de vista y contenedor que evitan conservar la posición antigua bajo el chat.

La extensión lista los chats locales de Codex de todos los proyectos, como la vista Todos de Codex, independientemente de la carpeta abierta en VS Code. Lee los archivos JSONL de la carpeta sessions de CODEX_HOME si está definida, o de ~/.codex/sessions en otro caso. Un turno permanece en curso desde su inicio hasta que Codex registra su finalización o cancelación, aunque transcurran varios minutos sin eventos nuevos. Cada archivo se atribuye a la sesión que lo creó; los metadatos heredados dentro de un subagente no reemplazan la actividad de la conversación principal. Si la fuente no está disponible, la vista muestra ese estado y conserva los chats pendientes. Los textos de las tareas se insertan como texto, sin interpretar HTML.

En el primer uso se incorporan los chats principales con actividad en las últimas 48 horas, incluidos los ya terminados. Desde entonces se conservan las conversaciones con actividad nueva hasta que se marquen como acabadas. Los subagentes no aparecen en la lista.

Privacidad y otros equipos

El VSIX es local. Para usarlo de forma privada en otros equipos, copia codex-agent-monitor.vsix y ejecuta Extensions: Install from VSIX… desde la paleta de cada VS Code, o code --install-extension codex-agent-monitor.vsix. No es necesario copiar el proyecto ni instalar Node.js.

La extensión se publica en Marketplace como JaviFRX.codex-agent-monitor. Activa Settings Sync con Extensions incluido e inicia sesión con la misma cuenta de VS Code en tus equipos para instalarla automáticamente. También puedes instalar un archivo VSIX desde la paleta mediante Extensions: Install from VSIX….

Los títulos se leen de session_index.jsonl, en la misma carpeta de datos de Codex. Editar nombre utiliza la solicitud thread/name/set del servidor local de Codex; requiere la extensión Codex instalada y una conversación local accesible. No modifica el índice directamente ni guarda un alias exclusivo del monitor. Los títulos se actualizan al renombrar un chat y se conservan si el índice deja de estar disponible. Si una conversación aún no figura en el índice, se usa su tarea como título de respaldo. El lápiz y el botón ✓ aparecen al pasar el ratón o enfocar la fila con el teclado.

Los registros de Codex, los extractos de tareas y las filas marcadas Acabado permanecen en cada equipo. El monitor no envía esos datos a Settings Sync ni a servicios externos.

Desarrollo

src/activity-store.js descubre y sigue la actividad local. src/extension.js conecta el almacén con VS Code, y src/monitor-view.js representa las tarjetas en la vista. El paquete generado no necesita dependencias de ejecución ni acceso a servicios externos.