Apresentação do PP-CLI (Printing Press CLI), uma ferramenta para…

INEMA

``text Use o Printing Press para criar uma CLI para a API do Tally.

A CLI deve conseguir: - listar formulários; - buscar respostas recentes; - filtrar por data; - gerar um resumo das respostas. ``` O agente deve pesquisar o serviço, entender como acessar os dados, gerar a CLI, testar e entregar uma estrutura utilizável.

Exemplo de comandos que uma CLI poderia ter⌗

Uma CLI bem feita para agentes não precisa copiar todos os endpoints de uma API. Ela deve ter comandos úteis.

Por exemplo, para uma comunidade:

bash community sync community posts recent --limit 20 community posts search "automação" community wins --top 5 community summarize --since 7d

Para YouTube:

youtube videos recent --channel meu-canal youtube comments list --video VIDEO_ID youtube comments summarize --video VIDEO_ID youtube analytics overview --last 30d

Para vendas:

sales leads recent sales leads search "Brasil" sales report weekly sales export --format csv

O foco não é só “ter acesso à API”. O foco é criar comandos que respondem perguntas reais.

Cuidados importantes⌗

Mesmo usando uma CLI, você ainda precisa respeitar autenticação, limites e segurança.

Não coloque API keys direto no código. Use variáveis de ambiente:

export API_KEY="sua_chave_aqui"

CLI não elimina rate limit. Se uma API permite só certa quantidade de chamadas por dia, a CLI ainda precisa respeitar isso.

Nem tudo precisa virar CLI. Se é uma tarefa simples e pontual, uma API direta pode bastar. O PP-CLI faz mais sentido quando você vai usar aquele serviço várias vezes, quer economizar tokens ou quer automatizar fluxos.

Teste antes de confiar. Sempre rode comandos de teste, confira a saída e veja se o agente está usando a CLI corretamente.

PP-CLI vs API vs MCP⌗

Uma forma simples de entender:

Caminho	Melhor quando	Problema
API	Você precisa de acesso bruto e completo aos dados	Pode devolver JSON enorme e gastar muitos tokens
MCP	Você quer expor várias ferramentas para o agente descobrir	Pode adicionar contexto e overhead demais
CLI	Você quer comandos rápidos, limpos e repetíveis	Precisa ser bem projetada

A ideia do PP-CLI não é dizer que API e MCP nunca servem. A ideia é colocar a CLI como uma camada mais eficiente para o agente.

Ou seja:

API continua útil. MCP continua útil. Mas para muitos fluxos com agentes de IA, uma CLI bem desenhada pode ser mais rápida, mais barata e mais controlável.

Resumo final⌗

O PP-CLI / Printing Press CLI é uma solução para criar CLIs voltadas para agentes de IA. Ele ajuda a transformar APIs, sites e serviços em comandos simples, rápidos e econômicos em tokens.

A grande vantagem é que o agente passa a usar comandos bem definidos, com respostas limpas e objetivas, em vez de depender de APIs pesadas ou MCPs cheios de contexto.

Para começar, o mínimo é ter Node/npm e Go. Para usar o fluxo completo, o ideal é também usar Claude Code com os skills do Printing Press.

O caminho mais simples para testar é:

npx -y @mvanhorn/printing-press install starter-pack

Para criar suas próprias CLIs, instale o binário:

go install github.com/mvanhorn/cli-printing-press/v4/cmd/printing-press@latest

E use no Claude Code:

/printing-press nome-do-app-ou-url

Em poucas palavras:

PP-CLI é uma fábrica de CLIs para agentes de IA trabalharem com mais velocidade, menos tokens e mais controle.

m de skill para Claude Code e MCP server. (GitHub)

Exemplo simples de uso⌗

Imagine que você quer que um agente consulte posts recentes de uma comunidade, mas essa comunidade não tem API pública.

Sem PP-CLI, o agente talvez precise abrir o navegador, navegar pela página, extrair conteúdo, lidar com HTML, cookies e vários detalhes.

Com uma CLI criada para isso, o agente poderia simplesmente chamar algo como:

school posts recent --limit 10

Ou:

school wins --category wins --top 3

E a CLI devolveria uma resposta limpa, por exemplo:

1. Michael - Melhor resultado da semana 2. Chris - Automação concluída 3. Fernando - Novo projeto publicado

O agente recebe apenas o necessário, sem jogar uma página inteira ou um JSON enorme dentro do contexto.

Instalação mínima⌗

Para começar a usar o PP-CLI ou instalar CLIs prontas, o mínimo prático é ter:

Node.js e npm
Go
opcionalmente Git
opcionalmente Claude Code, se quiser usar o fluxo com skills

Verifique se você já tem Node e npm:

node -v npm -v

Verifique se você já tem Go:

go version

Se esses comandos funcionarem, você já tem a base para testar.

Instalando CLIs prontas⌗

O caminho mais fácil é instalar o starter pack da biblioteca pública:

npx -y @mvanhorn/printing-press install starter-pack

Segundo a biblioteca oficial, o starter pack inclui CLIs como ESPN, Flight Goat, Movie Goat e Recipe Goat. ([GitHub][4])

Depois você pode listar ou buscar ferramentas disponíveis:

npx -y @mvanhorn/printing-press list

npx -y @mvanhorn/printing-press search sports

Para instalar uma CLI específica:

npx -y @mvanhorn/printing-press install espn

Instalando o binário principal⌗

Para criar suas próprias CLIs, instale o binário principal:

go install github.com/mvanhorn/cli-printing-press/v4/cmd/printing-press@latest

Depois teste:

printing-press --help

Se o comando não for encontrado, talvez o diretório de binários do Go não esteja no seu PATH. Em Linux/macOS, você pode tentar:

export PATH="$PATH:$(go env GOPATH)/bin"

Para deixar permanente no zsh:

echo 'export PATH="$PATH:$(go env GOPATH)/bin"' >> ~/.zshrc source ~/.zshrc

Usando com Claude Code⌗

O fluxo mais interessante do Printing Press é com Claude Code, porque ele usa skills para guiar o processo de criação da CLI.

A documentação de onboarding do projeto diz que o ponto de entrada principal é o comando /printing-press <API name> dentro do Claude Code, que roda um fluxo de pesquisa, geração, build e verificação. ([GitHub][5])

Instale os skills:

npx skills add mvanhorn/cli-printing-press/skills -g -a claude-code -y

Depois abra o Claude Code:

claude

E use:

/printing-press NomeDoApp

Ou:

/printing-press https://site-ou-servico.com

Exemplo:

/printing-press Hacker News

Ou:

/printing-press https://exemplo.com

Baixar o repositório é melhor?⌗

Depende do seu objetivo.

Para só testar, o npx é mais rápido.

Para aprender, modificar, estudar ou criar algo próprio, clonar o repositório é melhor.

Você pode fazer:

mkdir -p ~/Code cd ~/Code git clone https://github.com/mvanhorn/cli-printing-press.git cd cli-printing-press

Depois:

go mod download go install ./cmd/printing-press

E testar:

printing-press --help

Também vale clonar a biblioteca de CLIs prontas:

cd ~/Code git clone https://github.com/mvanhorn/printing-press-library.git

A biblioteca oficial reúne CLIs geradas, testadas e contribuídas pela comunidade. ([GitHub][4])

Como criar uma CLI própria⌗

Depois de instalar tudo, você pode pedir ao Claude Code algo como:

```Use o Printing Press para criar uma CLI para este site: exemplo.com ↗

Quero comandos para: - listar posts recentes; - buscar por categoria; - resumir os resultados; - exportar para JSON.```

Ou, para uma API:

O que é o PP-CLI / Printing Press CLI⌗

O PP-CLI, ou Printing Press CLI, é uma ferramenta pensada para criar e usar CLIs otimizadas para agentes de IA.

CLI significa Command Line Interface, ou seja, uma interface de linha de comando. Em vez de o agente acessar uma ferramenta por uma API cheia de dados brutos ou por um MCP carregado de descrições e ferramentas, ele usa comandos simples, rápidos e diretos.

A ideia principal é:

Em vez de fazer o agente “conversar” com APIs pesadas ou MCPs cheios de contexto, você cria uma CLI enxuta, local, rápida e feita para o agente usar bem.

O Printing Press funciona como uma espécie de fábrica de CLIs. Ele pode gerar uma CLI a partir de uma API, de um site ou de um serviço que nem sempre tem uma API pública bem organizada. Além disso, ele também pode gerar skills para ferramentas como Claude Code e até um MCP server em alguns fluxos. A página oficial descreve o projeto como uma forma de transformar APIs, sites e projetos em CLIs eficientes para agentes. (printingpress.dev)

Por que isso importa⌗

Agentes de IA precisam usar ferramentas externas: buscar dados, consultar sites, puxar informações de sistemas, criar relatórios, executar ações e automatizar tarefas.

O problema é que os caminhos tradicionais nem sempre são ideais.

APIs⌗

APIs são poderosas, mas normalmente foram feitas para programas, não necessariamente para agentes de IA. Uma API pode devolver respostas enormes em JSON, com muitos campos que o agente não precisa. Isso aumenta o uso de tokens, polui o contexto e exige mais trabalho para interpretar os dados.

MCPs⌗

MCPs ajudam na descoberta de ferramentas, mas podem adicionar muita sobrecarga. Um servidor MCP pode expor várias ferramentas, descrições e schemas, mesmo quando o agente só precisa de uma tarefa simples. Isso pode consumir tokens antes mesmo de a ferramenta ser usada.

CLIs⌗

Uma CLI bem desenhada pode entregar exatamente o que o agente precisa: comandos claros, saída limpa, dados resumidos e menor uso de contexto. O próprio repositório do Printing Press afirma que uma boa CLI funciona como “memória muscular” para o agente: sem ficar caçando documentação, sem caminhos errados e sem desperdício de tokens. (GitHub)

Vantagens do PP-CLI⌗

A principal vantagem do PP-CLI é criar ferramentas mais eficientes para agentes de IA.

Ele ajuda em pontos como:

Menos tokens A CLI pode resumir ou filtrar os dados antes de devolver a resposta ao agente. Em vez de mandar um JSON gigante para o contexto, ela entrega só o necessário.

Mais velocidade Como a CLI pode rodar localmente e usar estruturas como cache ou SQLite, algumas consultas ficam mais rápidas e evitam chamadas repetidas à API.

Mais controle Você define os comandos que fazem sentido para o seu fluxo. Em vez de expor 100 endpoints genéricos, pode criar comandos úteis como search, sync, summary, recent, export, deploy, score, etc.

Melhor para automação CLIs são fáceis de combinar. Um comando pode puxar dados, outro pode filtrar, outro pode gerar um resumo, outro pode salvar em arquivo.

Mais amigável para agentes A saída pode ser pensada para IA: curta, estruturada, legível e focada no objetivo.

Serve para sites sem API pública Uma das ideias fortes do Printing Press é permitir criar CLIs para serviços que não têm uma API pública clara, ou cuja API não é boa para agentes. O site oficial afirma que a ferramenta pode partir de APIs, websites e outros projetos para gerar CLIs token-efficient. (printingpress.dev)

O que o PP-CLI pode gerar⌗

O Printing Press pode gerar mais do que apenas um comando simples.

Dependendo do fluxo, ele pode gerar:

uma CLI em Go;
um skill para Claude Code;
um skill para OpenClaw;
um MCP server;
estrutura de comandos;
documentação;
testes e verificação;
comandos otimizados para o domínio da ferramenta.

O README do projeto descreve o Printing Press como algo que lê documentação de API, estuda ferramentas existentes e gera uma CLI eficiente, além de skill para

PP-CLI Printing Press