almost-cli: CLI multiágil sin nube, con BYOK y agentes localizados
El proyecto almost-cli permite ejecutar un conjunto de agentes de IA localmente, conectados a tus propias claves de OpenAI, Gemini, DeepSeek o NVIDIA NIM, sin exponer datos al proveedor.
almost-cli es un asistente de programación que rompe el modelo de “rentar un modelo y subir el código al cloud”. En lugar de eso, el proyecto se basa en BYOK (Bring Your Own Key) y en ejecutar agentes especializados en tu máquina. Los agentes —Arquitecto, Planificador, Constructor, Tester y Depurador— se orquestan a través de una CLI/TUI, y cada uno puede usar un modelo distinto, por ejemplo un modelo barato para la fase de planificación y un modelo potente para la depuración, sin cambiar la configuración del agente.
El stack se organiza en capas que garantizan seguridad y composabilidad. La capa de Orquestador coordina el Runtime de los agentes, un motor de contexto y un motor de permisos. Los agentes operan con un conjunto de herramientas explícitas: sistema de archivos, shell, Git, búsqueda y MCP. Los permisos son denegados por defecto; cada llamada a una herramienta se revisa y los servidores MCP están protegidos por el permiso correspondiente. De esta forma, los datos y el código nunca salen de tu entorno, salvo que tú lo permitas.
La propuesta de almost-cli se centra en la separación entre identidad de agente y modelo. Un agente es la configuración de prompt, herramientas y flujo de trabajo; el modelo es simplemente el motor de ejecución. Así, puedes intercambiar proveedores por agente sin tocar la lógica de negocio.
El proyecto está organizado en paquetes:
- packages/agent-core y packages/providers/,
- packages/tools/ y packages/permissions,
- packages/context, orchestrator, sessions, storage y agent-definitions.
Para probarlo, basta con clonar el repositorio, instalar dependencias con pnpm install, ejecutar pnpm typecheck, pnpm test y pnpm build. El autor invita a la comunidad a contribuir, ya que el repositorio es abierto y el desarrollo se hace en público.
La relevancia de BYOK es clara: la seguridad y el control recaen sobre el equipo. No hay una cuenta backend ni un proveedor que mantenga tus claves; todo permanece en tu máquina, con auditoría explícita y límites de permisos. Este enfoque puede ser atractivo para organizaciones que requieren cumplimiento y no quieren exponer su código o datos.
Lo que queda por ver es la madurez de la herramienta en entornos productivos y cómo se integra con flujos de CI/CD existentes. La comunidad de desarrolladores de infraestructuras locales y de agentes de IA puede encontrar en almost-cli una base para experimentar sin comprometer la seguridad.
