CLI-Anything: convertir software existente en interfaces para agentes

Todo lo que hay que saber sobre HKUDS/CLI-Anything: una metodología, plugin y catálogo para generar interfaces de línea de comandos estructuradas sobre aplicaciones existentes, con el objetivo de que agentes de IA puedan operar software originalmente diseñado para personas.

Qué es CLI-Anything

CLI-Anything es un proyecto de HKUDS que propone hacer el software “agent-native” envolviéndolo con una CLI estructurada. El repositorio combina una metodología de generación, un plugin para asistentes de programación, harnesses ya creados y CLI-Hub, un catálogo para descubrir e instalar CLIs comunitarias.

La idea no es que un agente opere una GUI haciendo clic como una persona, sino que una aplicación con código fuente reciba una interfaz por comandos, salida JSON y una SKILL.md que explique al agente cómo usarla. El README afirma que esto permite controlar aplicaciones sin API previa, reconstrucción completa o automatización gráfica compleja; esa es la propuesta del proyecto y debe verificarse por aplicación, no suponerse universalmente.

CLI-Anything es Apache-2.0. El repositorio registra un lanzamiento v0.3.0 el 24 de abril de 2026 y enumera varios harnesses de ejemplo, además de una hoja de ruta y contribuciones de comunidad.

El origen: la línea de comandos como interfaz común para agentes

El problema que plantea es que muchos agentes pueden llamar APIs o herramientas web, pero no interactuar de forma fiable con aplicaciones de escritorio, CAD, edición audiovisual, diagramación o software especializado. Su respuesta es generar una capa CLI cuya gramática, JSON y documentación sean consumibles por agentes.

El proyecto reúne un flujo de siete fases para analizar el código fuente, diseñar comandos, implementar una envoltura, probarla y documentarla. El artículo asociado en arXiv lo sitúa dentro del concepto de agent-native computer use: adaptar software existente a las exigencias de modelos con razonamiento y uso de herramientas.

El repositorio reconoce dos límites importantes: necesita modelos de frontera para generar harnesses fiables y la calidad se degrada cuando el objetivo solo ofrece binarios compilados, en vez de código fuente. Además, una primera ejecución puede necesitar refinamiento manual para cubrir capacidades reales.

Filosofía y principios

CLI antes que GUI para el agente. La interfaz textual estructurada permite comandos reproducibles, parámetros explícitos y salida procesable.

Harness por aplicación. Cada software recibe su propio paquete, documentación y pruebas, en lugar de una automatización visual genérica.
JSON y skill como contrato. La salida --json y SKILL.md pretenden dar al agente un formato estable para descubrir y ejecutar capacidades.

Renderizado de UI en primer plano y modo oscuro de una ventana de terminal ejecutando un comando cli-anything-gimp --json. El terminal muestra una salida JSON brillante y perfectamente estructurada en verde y cian neón. La interfaz es elegante y futurista, encarnando el concepto de "JSON y skill como contrato" para agentes de IA.

Generación con validación. El flujo no se limita a escribir una envoltura: pide pruebas unitarias, E2E, documentación de arquitectura y refinamiento iterativo.
Distribución comunitaria. CLI-Hub se plantea como un índice desde el que agentes pueden buscar, instalar y leer una CLI específica.

Cómo funciona

El usuario instala el marketplace/plugin o usa la skill de Codex incluida, invoca /cli-anything sobre una ruta de software y el agente sigue la metodología para generar el harness. El resultado se instala como paquete Python local y expone un binario de la forma cli-anything-<software>.

Código fuente de una aplicación → análisis en siete fases → harness CLI
                                                       ├─ subcomandos y REPL
                                                       ├─ salida JSON
                                                       ├─ SKILL.md
                                                       └─ pruebas y documentación

Los harnesses del monorrepo conservan una SKILL.md canónica bajo skills/cli-anything-<software>/. El paquete generado incluye una copia de compatibilidad, y los agentes pueden descubrir las skills mediante el comando de npx skills que el repositorio indica.

Componentes principales

Plugin CLI-Anything: añade comandos como /cli-anything, /refine y /validate a clientes compatibles.
HARNESS.md: SOP o metodología central del proyecto; describe el proceso de construcción.
Harness generado: paquete instalable, binario, subcomandos, REPL y salida estructurada.
SKILL.md: instrucciones de uso para agentes y descubrimiento dentro del ecosistema de skills.

CLI-Hub: paquete cli-anything-hub que lista, busca, instala, actualiza, desinstala y lanza CLIs de la comunidad.
Pruebas: el repositorio recomienda pytest por harness y una modalidad CLI_ANYTHING_FORCE_INSTALLED=1 para validar el uso instalado.

El ecosistema

El README documenta instalación como marketplace de Claude Code y GitHub Copilot CLI, una skill incluida para Codex y referencias para OpenCode; Cursor y Windsurf aparecen como integraciones previstas o en evolución. Esto acredita intención y material de integración, no experiencia idéntica en todas las plataformas.

CLI-Hub se presenta como la capa de distribución. El usuario instala cli-anything-hub con pip y luego usa cli-hub list, search, info, install, update o launch. Como el catálogo puede contener software de terceros, conviene revisar el paquete, sus permisos y sus fuentes antes de instalarlo.

El repositorio muestra contribuciones para software como Rekordbox, Calibre, 3MF y MiniMax, y menciona objetivos de CAD, DAW, IDE, EDA y herramientas científicas. Esas listas reflejan el estado y la ambición del proyecto, no una certificación de compatibilidad total para cada aplicación.

Números del repo

Medición: 24 de agosto de 2026, API de GitHub. El artículo fuente de este repositorio no incluyó una tabla de métricas propia; estas cifras se verificaron directamente contra la API pública de GitHub al momento de la publicación.

Métrica	Valor
Estrellas	48.026
Bifurcaciones	4.455
Suscriptores reales	182

watchers_count replica las estrellas en la respuesta general de GitHub; por eso se informa subscribers_count como suscriptores reales.

Guía rápida de uso

Instalación y primer arranque

Para Claude Code, el README ofrece:

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything
/cli-anything ./gimp

Para una CLI que ya fue generada, la ruta indicada es instalar el harness y ejecutar el binario:

cd gimp/agent-harness
pip install -e .
cli-anything-gimp --help
cli-anything-gimp --json layer add -n "Background" --type solid --color "#1a1a2e"

En Windows, la documentación advierte que Claude Code usa bash: recomienda Git for Windows o WSL para disponer de bash y cygpath.

Flujos de trabajo habituales

Crear un harness nuevo: dar al agente la ruta de un proyecto con código fuente y pedir /cli-anything; revisar después comandos, cobertura y seguridad.
Refinar cobertura: usar /refine para añadir capacidades que no aparecieron en la primera generación y /validate para comprobar el resultado.
Usar una CLI existente: buscarla en CLI-Hub, inspeccionarla, instalarla y leer su SKILL.md antes de dar instrucciones al agente.
Automatizar artefactos: integrar comandos JSON en un flujo de agente para CAD, imágenes, diagramas, subtítulos u otras aplicaciones ya envueltas.

Trampas frecuentes y soluciones

Esperar cobertura perfecta en una ejecución. El propio README indica que es normal necesitar refinamiento y corrección manual.
Intentar envolver binarios sin fuente. El pipeline analiza código; con binarios que exigen decompilación la cobertura y calidad disminuyen.
Usar un modelo débil para generar el harness. El proyecto declara dependencia de modelos de frontera; validar de forma especial el resultado generado por modelos menores.
Confundir JSON con seguridad. Una interfaz estructurada facilita automatización, pero un comando puede seguir modificar archivos, proyectos o bibliotecas; aplicar permisos y copias de respaldo.
Instalar sin revisar el catálogo. Un CLI comunitario puede ejecutar dependencias y operaciones locales. Revisar repositorio, pruebas y política de privilegios antes de confiarle datos o rutas sensibles.

Seguridad y modelo de confianza

CLI-Anything cambia la superficie de control de una GUI a comandos ejecutables por agentes. Esto mejora auditabilidad y repetición, pero puede amplificar operaciones destructivas si el agente recibe permisos amplios. Los harnesses deben validar parámetros, limitar rutas, ofrecer modo de vista previa y conservar pruebas de los cambios antes de aplicarlos.

El proyecto documenta, por ejemplo, rutas de escritura protegidas y respaldo obligatorio en un harness de Rekordbox. Es una práctica específica de una contribución; no basta para inferir que todos los harnesses del catálogo cuentan con el mismo control.

La recomendación operativa es generar y probar cualquier CLI en un clon o proyecto de prueba, ejecutar pruebas E2E sobre copias de artefactos, revisar la SKILL.md y no conceder al agente credenciales o acceso a bibliotecas productivas hasta haber revisado el comportamiento. Estas son prácticas de despliegue derivadas de la naturaleza del sistema, no una certificación de seguridad del repositorio.

Cómo lo recibió la comunidad

El repositorio fue publicado en Hacker News; la página recuperada identifica el envío, pero no devolvió discusión ni métricas suficientes para atribuir una recepción concreta.

Una reseña en DEV Community explica la motivación como resolver el control de software sin API y destaca la metodología de siete fases, JSON, pruebas y SKILL.md. Es una síntesis editorial, no una evaluación comparativa independiente.

Un post de Reddit del 16 de agosto repite una afirmación de más de un millón de llamadas al ecosistema y 47.000 estrellas. Como proviene de un post que enlaza una publicación social y no de métricas auditadas, debe tomarse como una afirmación promocional, no como dato de adopción comprobado.

TrendingRepo informó ausencia de señales recuperables en varias redes durante su análisis; esa falta de resultados no prueba ausencia de comunidad y puede deberse al método o fecha de búsqueda.

CLI-Anything frente a otras propuestas

Propuesta	Coincidencia verificable	Diferencia verificable
Automatización GUI	Ambas controlan software creado para personas.	CLI-Anything busca una interfaz textual y JSON generada desde código, en vez de interacción por coordenadas o visión.
API oficial de una aplicación	Ambas exponen operaciones programables.	CLI-Anything crea un harness cuando no hay API útil; su calidad depende de la base de código y del proceso de generación.
CLI manual	Ambas usan comandos reproducibles.	El proyecto añade generación asistida, skills, pruebas y un hub de distribución para agentes.
Browser/computer-use agent	Ambos pueden ejecutar tareas de software.	CLI-Anything privilegia contratos de comandos; el agente de navegador actúa sobre la interfaz ya existente.

Casos de uso y a quién puede ayudar este repositorio

Equipos que mantienen software con código fuente y quieren exponer tareas repetibles a agentes sin construir una API completa desde cero.
Agentes que producen artefactos de CAD, edición multimedia, diagramas o documentos y necesitan comandos con salida verificable.
Desarrolladores de herramientas internas que desean normalizar una interfaz CLI, JSON, documentación de skill y pruebas alrededor de una aplicación existente.
Investigadores de computer use que comparan la automatización estructurada por comandos con interacción visual o APIs tradicionales.

No es una solución mágica para hacer cualquier binario seguro, completo o correctamente automatizable. La revisión humana, pruebas sobre copias y el control de permisos siguen siendo indispensables.

Recursos

Repositorio: https://github.com/HKUDS/CLI-Anything
CLI-Hub: https://clianything.cc/
Metodología: https://github.com/HKUDS/CLI-Anything/blob/main/cli-anything-plugin/HARNESS.md
Plugin: https://github.com/HKUDS/CLI-Anything/tree/main/cli-anything-plugin
Paper: https://arxiv.org/abs/2606.03854
Releases: https://github.com/HKUDS/CLI-Anything/releases

Nota: artículo elaborado con el repositorio, releases, paper y cobertura pública recuperados el 17 de agosto de 2026. La cobertura de software y el catálogo de CLI-Hub evolucionan rápidamente; cada harness debe validarse antes de uso productivo.