O que e o CLI-Anything?

E um framework open-source do laboratorio HKUDS que automaticamente transforma qualquer software em uma interface de linha de comando (CLI) que agentes de IA podem controlar nativamente, sem depender de automacao de GUI ou screen scraping.

Quais softwares ja tem CLI gerada pelo CLI-Anything?

Mais de 50 aplicacoes incluindo Blender (208 testes), Inkscape (202), LibreOffice (158), Audacity (161), GIMP (107), Draw.io (138), ComfyUI (70), Ollama (98), Kdenlive, Shotcut, OBS Studio, Godot, QGIS, FreeCAD e muitas outras.

Como instalar e usar o CLI-Anything?

No Claude Code: /plugin marketplace add HKUDS/CLI-Anything && /plugin install cli-anything. Para usar CLIs prontas: pip install cli-anything-hub && cli-hub install gimp. A CLI gerada fica disponivel como cli-anything- .

O CLI-Anything funciona com qualquer software?

O framework foi projetado para ser universal, mas a qualidade da CLI gerada depende da complexidade do software e da qualidade do seu codigo-fonte. Softwares com APIs internas bem definidas tendem a produzir CLIs mais robustas. A comunidade mantem uma wishlist para solicitar novos softwares.

CLI-Anything: O Framework que Transforma Qualquer Software em CLI para Agentes de IA

O cenario esta mudando rapido. Se hoje o software e construido para humanos clicarem em botoes, amanha o usuario primario sera um agente de IA que precisa controlar esse software programaticamente. O problema? A maioria das aplicacoes nao tem uma API decente — e automatizar via GUI e fragil, lento e horrivel de manter.

E exatamente ai que entra o CLI-Anything, um projeto do laboratorio HKUDS (University of Hong Kong Data Science) que ja acumulou 40.9k estrelas no GitHub. A proposta e ousada e direta: transformar qualquer software em uma CLI que agentes de IA possam controlar nativamente.

O Pipeline de 7 Fases: Da Analise ao Pacote Publicado

A magica do CLI-Anything esta no seu pipeline automatizado de 7 fases. Voce aponta o agente para o diretorio de um software e ele executa tudo sozinho:

Analysis — O agente le o codigo-fonte, entende a arquitetura, mapeia acoes da GUI para APIs internas
Design — Define grupos de comandos, hierarquia de subcomandos e a experiencia REPL
Implementation — Gera uma CLI completa em Python usando o framework Click, com suporte a subcomandos e REPL interativo com estado persistente e undo/redo
Test Planning — Projeta a estrategia de testes: unitarios, E2E nativos, E2E com backend real, CLI subprocess
Test Writing — Implementa os testes com pytest. E aqui que entra um dos principios mais importantes: os testes FALHAM quando o backend real nao esta presente — sem mock, sem stub, sem atalho
Documentation — Gera documentacao completa e um arquivo SKILL.md que agentes como Claude Code, Codex e OpenClaw conseguem descobrir e carregar automaticamente
Publishing — Empacota a CLI como um pacote Python instalavel via pip e registra no CLI-Hub, o repositorio central de CLIs comunitarias

Nada de Mock: Software Real ou Nada

O que diferencia o CLI-Anything de outras tentativas de automacao e sua filosofia zero compromise. As CLIs geradas chamam o software REAL — nao existem fallbacks, mocks ou implementacoes de brinquedo. Se voce gerar uma CLI para o Blender, ela vai abrir o Blender de verdade, executar operacoes reais e renderizar com CYCLES ou EEVEE.

Isso resolve um problema que o paper do projeto chama de "Rendering Gap" — a discrepancia entre o que a GUI mostra e o que ferramentas de exportacao ingenuas produzem. Aplicativos como GIMP e Blender aplicam efeitos no momento da renderizacao; exportadores simples frequentemente descartam esses efeitos silenciosamente. A solucao do CLI-Anything envolve um pipeline: renderizador nativo → traducao de filtros → scripts de renderizacao.

Dois Modos: Subcomando e REPL com Estado

Cada CLI gerada oferece dois modos de interacao:

Modo Subcomando — Ideal para scripting. Voce encadeia comandos como:

cli-anything-libreoffice document new -o report.json --type writer
cli-anything-libreoffice --project report.json writer add-heading -t "Q1 Report" --level 1
cli-anything-libreoffice --project report.json export render output.pdf --overwrite

Modo REPL — Ideal para trabalho interativo. Mantem estado persistente do projeto, permitindo navegar entre contextos e desfazer/refazer operacoes. O prompt mostra o contexto ativo:

$ cli-anything-blender
blender> scene new --name ProductShot
blender[ProductShot]> object add-mesh --type cube --location 0 0 1
blender[ProductShot]*> render execute --output render.png --engine CYCLES

E toda saida pode ser estruturada em JSON com a flag --json — perfeito para consumo por agentes.

SKILL.md: A Interface de Descoberta para Agentes

Um detalhe brilhante do projeto e que cada CLI gerada inclui um arquivo SKILL.md no formato que agentes modernos (Claude Code, OpenClaw, Codex) usam para descobrir capacidades. Quando um agente encontra esse arquivo, ele sabe exatamente quais comandos estao disponiveis, como usa-los e o que esperar como saida.

Isso cria um ecossistema onde agentes podem descobrir e instalar CLIs autonomamente. O CLI-Hub — o repositorio central — tem uma meta-skill que permite a um agente pesquisar, encontrar e instalar a CLI certa para completar uma tarefa, tudo sem intervencao humana.

O Ecossistema: 50+ Aplicacoes, 2.330 Testes

O projeto ja gerou CLIs para mais de 50 aplicacoes. Alguns numeros impressionantes:

Blender — 208 testes, renderizacao 3D completa via CLI
Inkscape — 202 testes, edicao vetorial programatica
LibreOffice — 158 testes, geracao de documentos, planilhas e apresentacoes
Audacity — 161 testes, processamento de audio em lote
GIMP — 107 testes, manipulacao de imagens
Draw.io — 138 testes, diagramas gerados programaticamente
ComfyUI — 70 testes, pipelines de imagem AI automatizados
Ollama — 98 testes, gestao de LLMs locais

E isso cobre dominios que vao de criacao 3D e edicao de video (Kdenlive, Shotcut, OBS Studio) ate ferramentas de desenvolvimento (Godot, LLDB, RenderDoc), passando por software cientifico (QGIS, FreeCAD, Uni-Mol Tools). A taxa de passagem dos 2.330 testes e de 100%.

Instalacao: Dois Caminhos

Se voce usa Claude Code, a instalacao e um comando:

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

Para usar CLIs ja geradas por outros, basta o CLI-Hub:

pip install cli-anything-hub
cli-hub list              # explora o catalogo
cli-hub install gimp      # instala uma CLI especifica
cli-anything-gimp --help  # usa

Por Que Isso Importa

O CLI-Anything resolve um gargalo fundamental na automacao por IA. Hoje, quando um agente precisa usar o GIMP ou o Blender, as opcoes sao ruins: screen scraping (fragil, lento), APIs limitadas (quando existem) ou automation via GUI (quebravel).

Com o CLI-Anything, o agente ganha uma interface estruturada, documentada, testada e com saida em JSON. E como dar a um agente o equivalente a uma API REST — mas para qualquer software, inclusive aqueles que nunca foram projetados para serem controlados programaticamente.

O projeto tem uma visao clara do futuro: agentes de IA serao os principais usuarios de software, e software que nao oferecer uma interface para agentes sera tao obsoleto quanto um site sem responsividade mobile.

Conclusao

O CLI-Anything e um dos projetos open-source mais relevantes para o ecossistema de agentes de IA em 2026. Ele nao e so mais uma ferramenta de automacao — e uma camada de infraestrutura que conecta o mundo do software tradicional ao mundo dos agentes autonomos.

Com 40.9k estrelas, 50+ CLIs geradas, 2.330 testes com 100% de passagem e uma comunidade ativa, o projeto ja provou que a abordagem funciona. E o melhor: e tudo open-source, com uma licenca permissiva, esperando suas contribuicoes.

O codigo-fonte completo, documentacao em ingles, chines e japones, e instrucoes de instalacao estao disponiveis no repositorio oficial: github.com/HKUDS/CLI-Anything