Modulo 1.2 - Instalacao completa

📋 Pre-requisitos

Antes de instalar qualquer coisa, valide o ambiente. 9 em cada 10 dores de cabeca vem de versao desatualizada.

Ferramenta	Versao minima	Verificar
Go	1.26.3	`go version`
Node.js	18+	`node -v`
npm	9+	`npm -v`
Claude Code	2.0+	`claude --version`
git	2.x	`git --version`

💡 Dica

Use asdf ou nvm para gerenciar versoes de Node por projeto. Para Go, prefira o tarball oficial (e mais consistente entre arquiteturas).

🐹 Instalar Go 1.26.3

Pule se ja tem go version go1.26.3 ou superior. Senao, instale do tarball oficial.

🐧 Ubuntu / Debian / NVIDIA Spark

# 1. Descubra a arquitetura
uname -m
# arm64 (Mac M1/M2, Spark, Pi 5)  -> linux-arm64
# x86_64                          -> linux-amd64

# 2. Baixe a versao correta
cd /tmp
curl -LO https://go.dev/dl/go1.26.3.linux-arm64.tar.gz
# OU
curl -LO https://go.dev/dl/go1.26.3.linux-amd64.tar.gz

# 3. Instale em /usr/local/go
sudo tar -C /usr/local -xzf go1.26.3.linux-*.tar.gz

# 4. Adicione ao PATH
echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> ~/.bashrc
source ~/.bashrc

# 5. Confirme
go version
# go version go1.26.3 linux/arm64

🍎 macOS

# Homebrew
brew install go

# Ou pegue o tarball: https://go.dev/dl/

💡 Por que $HOME/go/bin no PATH?

E onde go install coloca os binarios compilados. Tudo que voce instalar via Go (printing-press, CLIs geradas) cai la. Sem isso no PATH, voce nao acha o binario.

🏭 Binario factory

O binario printing-press e a fabrica — ele cria CLIs novas. Nao e o que o agente chama no dia a dia; ele gera as CLIs especificas.

Instalar via go install

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

Vai baixar dependencias e compilar (~1 min). No fim:

$ printing-press --version
printing-press 4.5.2

✓ Para que serve o factory

✓Gerar CLI nova a partir de URL/API
✓Validar (verify, score, shipcheck)
✓Regerar CLI mantendo patches (regen-merge)
✓Publicar no library oficial

✗ Para que NAO serve

✗Nao e a CLI que o agente chama no dia a dia
✗Nao processa dados de runtime — so gera codigo
✗Nao expoe API HTTP — e ferramenta de dev

🧩 Skills no Claude Code

As skills (com prefixo pp-*) sao o que o agente realmente invoca. Elas mapeiam linguagem natural para comandos da CLI.

📥 Opcao A: clone do repo

Recomendado se voce vai contribuir ou estudar o codigo.

git clone https://github.com/mvanhorn/cli-printing-press.git

As skills ficam em cli-printing-press/skills/ e o Claude Code as descobre automaticamente.

🚀 Opcao B: instalar so as skills (leve)

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

Mais rapido para quem so quer usar.

🔍 Como o Claude descobre

No startup, o Claude Code escaneia ~/.claude/skills/ (global) e .claude/skills/ (projeto). Cada skill tem um arquivo SKILL.md com triggers em linguagem natural.

🎁 Starter-pack: 4 CLIs prontas

Bundle inicial com espn, flight-goat, movie-goat e recipe-goat. Em 30 segundos voce ja tem 4 CLIs funcionais.

Instalar

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

Saida esperada:

Bundle "starter-pack" -> espn, flight-goat, movie-goat, recipe-goat
Installed espn
  binary: ~/go/bin/espn-pp-cli
  skill:  pp-espn
Installed flight-goat
  binary: ~/go/bin/flight-goat-pp-cli
  skill:  pp-flight-goat
Installed movie-goat
  ...
Installed recipe-goat
  ...

Done. 4 CLIs installed in 28s.

📜 Listar o que foi instalado

npx -y @mvanhorn/printing-press list

NAME           BINARY                  SKILL              VERSION
espn           espn-pp-cli             pp-espn            1.4.0
flight-goat    flight-goat-pp-cli      pp-flight-goat     0.9.2
movie-goat     movie-goat-pp-cli       pp-movie-goat      2.1.0
recipe-goat    recipe-goat-pp-cli      pp-recipe-goat     1.2.5

🩺 Verificacao + troubleshooting

Script de validacao que cobre tudo de uma vez, mais os erros mais comuns e como resolver.

Cole tudo no terminal

echo "Go:        $(go version)"
echo "Node:      $(node -v)"
echo "npm:       $(npm -v)"
echo "Claude:    $(claude --version)"
echo "PP binary: $(printing-press --version)"
echo "Installed CLIs:"
npx -y @mvanhorn/printing-press list 2>/dev/null | tail -n +2

Se cada linha retornou um numero de versao, esta pronto para o Modulo 1.3.

⚠️ Erros frequentes

go: command not found — PATH nao foi recarregado. Rode source ~/.bashrc ou abra novo terminal.
go install falhou (versao) — Sua versao de Go e antiga. Confirme go version >= 1.26.3.
Permissao negada em /usr/local/go — Use sudo no tar -xzf.
Skills nao aparecem — Saia e reabra o Claude Code (ele rele skills no startup).
Atras de proxy/firewall — Configure GOPROXY ou HTTPS_PROXY antes do go install.

💡 Dica de validacao no agente

Abra o Claude Code e pergunte: "Quais jogos da NBA tem hoje?". Se o agente invocar a skill pp-espn, sua instalacao esta perfeita.

✅ Resumo do Modulo

✓

Pre-requisitos validados — Go 1.26.3, Node 18+, Claude Code 2.0+, git.

✓

Go no PATH — incluindo $HOME/go/bin, onde caem todos os CLIs.

✓

Binario factory instalado — printing-press --version responde.

✓

Skills do Claude Code — via clone do repo ou npx skills add.

✓

Starter-pack ativo — 4 CLIs prontas (espn, flight-goat, movie-goat, recipe-goat).

Proximo Modulo:

1.3 — Primeiros passos com o starter-pack

← Modulo anterior Proximo Modulo →