Sobre el proyecto

CodeAgent Mobile — Clients es el repositorio público de los puentes del lado cliente de CodeAgent Mobile, una capa de continuidad de flujos de trabajo que te permite supervisar agentes de codificación con IA (Claude Code, Copilot, Cursor, Windsurf, JetBrains AI, OpenAI Codex, Vertex AI, etc.) desde un dispositivo móvil o un panel web. El repositorio cuenta con tres clientes diferenciados: - **apps/cli** – `codeam-cli`, un puente de terminal que envuelve Claude Code en una PTY y transmite comandos a cualquier dispositivo. Se instala mediante npm y se usa con un flujo de emparejamiento por código QR. - **apps/vsc-plugin** – una extensión para VS Code, Cursor y Windsurf que se conecta al mismo relé backend, permitiéndote aprobar diferencias, redirigir prompts y supervisar sesiones desde tu teléfono. - **apps/jetbrains-plugin** – un complemento para la familia IntelliJ (IDEA, WebStorm, PyCharm, Rider, GoLand, ...) que integra las mismas capacidades de control móvil. Todos los clientes comparten la misma configuración de variables de entorno (`CODEAM_API_URL` y `CODEAM_TEST_MODE=1`) para apuntar a una API de producción, staging o autoalojada. Leen estas variables del proceso host; los complementos de VS Code y JetBrains también admiten el ajuste `apiBaseUrl` como sobrescritura manual. La estructura del repositorio sigue un patrón de monorepo, con `apps/` para cada cliente, un paquete TypeScript `packages/shared` que aloja el analizador del protocolo de fragmentos y las tablas de precios de modelos (incluidas en el momento de la compilación), y scripts raíz para compilar, probar y publicar. Los requisitos previos de compilación son Node ≥ 18, Python 3 (para el manejo de PTY) y JDK 17 para el complemento de JetBrains. Los lanzamientos se coordinan mediante una única línea de versiones (que comienza en 2.0.0). Una etiqueta `vX.Y.Z` activa la publicación automatizada del CLI en npm, la extensión de VS Code tanto en el VS Code Marketplace como en Open VSX, y el complemento de JetBrains en el canal estable del JetBrains Marketplace. Las etiquetas de prelanzamiento omiten el envío al marketplace de JetBrains. Arquitectónicamente, los clientes actúan como relés ligeros: se conectan al backend de CodeAgent por REST/WebSocket, reenvían comandos al agente de IA local (por medio de PTY, APIs de IDE o terminal) y transmiten la sesión a la interfaz móvil/web para su aprobación, redirección y supervisión asíncrona. El proceso de contribución sigue un flujo simple: abre una incidencia para cambios no triviales, mantén los cambios limitados por aplicación, ejecuta las pruebas correspondientes (`npm run test:cli`) y asegúrate de que las compilaciones se realicen correctamente antes de enviar un pull request. El proyecto está licenciado bajo la Licencia MIT. Este repositorio es ideal para desarrolladores que quieran ampliar los flujos de trabajo de codificación con IA más allá del escritorio, proporcionando un plano de control unificado para múltiples IDE y agentes de terminal desde una única interfaz móvil.