MicroCodex coloca un agente estilo Codex en un binario de menos de 1 MB

MicroCodex es un agente de codificación local escrito en C++23 que empaqueta flujos de trabajo al estilo OpenAI/Codex en un binario de menos de 1 MB. Se ejecuta en un terminal y admite indicaciones de una sola vez, una interfaz interactiva en la terminal, herramientas locales de codificación, conversaciones duraderas y compactación automática del contexto.

Instalación y uso

En macOS o Linux, el proyecto ofrece un instalador de una sola línea:

''sh curl -fsSL https://github.com/paoloanzn/microcodex/releases/latest/download/install.sh | sh ''

Tras la instalación, ejecute microcodex login para autenticarse y luego inicie el agente con microcodex. Los usuarios también pueden descargar archivos específicos por plataforma desde la Release más reciente en GitHub. Las compilaciones disponibles incluyen binarios para Apple Silicon/arm64 y x86_64 para macOS, además de binarios x86_64 y arm64 para Linux. Linux requiere las bibliotecas en tiempo de ejecución libcurl y OpenSSL.

Recomendado

Este benchmark de SVG de una rana pone a prueba la literalidad de la IA

El instalador selecciona automáticamente la compilación nativa. Para instalar una versión específica, los usuarios pueden establecer MICROCODEX_RELEASE, por ejemplo v0.1.0:

''sh curl -fsSL https://github.com/paoloanzn/microcodex/releases/latest/download/install.sh | MICROCODEX_RELEASE=v0.1.0 sh ''

La autenticación usa un plan de ChatGPT existente. microcodex login abre un flujo basado en el navegador, mientras que microcodex login --device-auth admite máquinas remotas o sin interfaz (headless) mediante un código de un solo uso. Las credenciales OAuth se almacenan en $CODEX_HOME, o en ~/.codex cuando esa variable no esté establecida.

El agente puede ejecutarse de forma interactiva o aceptar una tarea puntual. La documentación del proyecto da este ejemplo:

''sh microcodex microcodex “Encuentra la prueba que falla, arréglala y ejecuta el conjunto de pruebas relevante” ''

Habilidades, seguridad y compilación

MicroCodex detecta habilidades del sistema de archivos Codex en $CODEX_HOME/skills, recurriendo a ~/.codex/skills si no las encuentra. Cada habilidad requiere un archivo SKILL.md con frontmatter YAML que contenga un nombre y una descripción. Los metadatos se cargan en las instrucciones del agente al iniciar la sesión; la habilidad completa se lee solo cuando su nombre o descripción coincide con la tarea.

El proyecto no es un sandbox. Antes de lanzar el shell del usuario, aplica una lista de denegación léxica que cubre comandos como rm -f, rm -rf, git reset --hard, git clean forzado, git checkout --, herramientas de formateo de disco y comandos de apagado. La lista de denegación no es un analizador de shell ni un límite de seguridad completo: comandos destructivos no reconocidos o indirectos pueden pasar, y las operaciones de archivo se ejecutan con los mismos permisos que el proceso de MicroCodex.

Compilar desde el código fuente requiere un compilador C++23, make y—en Linux—los archivos de desarrollo de libcurl y OpenSSL:

''sh git clone --recurse-submodules https://github.com/paoloanzn/microcodex.git cd microcodex make ''

El ejecutable resultante se escribe en build/microcodex; make test ejecuta la suite de pruebas. El repositorio está licenciado bajo Apache-2.0. Actualmente el proyecto no tiene soporte MCP, y no se puede copiar texto desde el terminal durante una sesión de MicroCodex.