@gstack-vibehard/installer weekly downloads statistics

🚀 GStack VibeHard

🌐 Idiomas: Português (guia completo) · English (full guide)

Em uma frase

Proteja seu agente de IA antes dele mexer no seu projeto.

Você já usa uma IA para programar (Claude Code, Cursor, Codex, OpenCode…). O GStack é um capacete: você instala uma vez e continua usando sua IA exatamente como antes. Ele cria projetos, faz verificações antes de dizer "pronto", guarda a memória do que foi decidido — e tudo tem desfazer.

Instale apenas das fontes oficiais: npm @gstack-vibehard/installer · GitHub lucasdmarco/gstack-vibehard. O comando no terminal é gstack_vibehard (com underscore); o pacote npm usa hífen.

Comece sem medo

npx @gstack-vibehard/installer --help    # só mostra a ajuda — não escreve NADA
npx @gstack-vibehard/installer start     # assistente guiado: ele pergunta, você decide

O start conversa com você em passos: o que você quer construir → um plano → sua confirmação antes de qualquer coisa ser criada. Se se arrepender depois: gstack_vibehard uninstall desfaz o que foi instalado.

Se você é iniciante

Você não precisa entender os termos técnicos para começar. Os únicos comandos que valem decorar:

Quero…	Rode…	O que acontece
Só entender	npx @gstack-vibehard/installer --help	Nada é escrito
Criar guiado	npx @gstack-vibehard/installer start	Pergunta objetivo e confirma antes de agir
Criar direto	npx @gstack-vibehard/installer create meu-app	Cria só a pasta ./meu-app, nada global
Rodar o app	gstack_vibehard dev	Sobe o app local (parar: stop · ver: logs)
"Está pronto?"	gstack_vibehard proof	UMA resposta: pronto ou não, com o motivo
Desfazer	gstack_vibehard uninstall --dry-run	Mostra o plano de remoção antes de tocar em algo

Se o terminal reclamar de npm, não tente consertar na mão: gstack_vibehard doctor node diagnostica e diz o próximo passo.

Já tenho um projeto

npx @gstack-vibehard/installer consult "quero proteger este projeto"   # só recomenda, não escreve
npx @gstack-vibehard/installer install --audit-only                    # mostra o impacto SEM instalar

A instalação completa só acontece depois disso, com sua confirmação explícita.

O que o GStack nunca faz sem você pedir

• Não lê nem edita seus arquivos de senha/segredo (.env).
• Não altera as configurações globais das suas IAs no modo lite/projeto.
• Não envia seu código para uma nuvem própria — roda 100% na sua máquina.
• Não aceita mudança de IA sem verificação: uma IA nunca aprova o próprio trabalho.
• Não instala nada pesado sem mostrar o impacto antes (--audit-only).
• Não deixa você sem saída: o que o install escreve tem backup e desfazer.

Tradução sem jargão

Termo que você vai ver	O que significa de verdade
Quality gate	Checkpoint automático antes de dizer "pronto"
Harness	O app de IA que você usa (Claude Code, Cursor, Codex, OpenCode)
Worktree	Cópia isolada onde o agente trabalha sem bagunçar seu projeto
Memória / contexto	Caderno local com as decisões e o histórico do projeto
MCP	Ferramenta extra que o agente pode chamar (sempre com seu consentimento)
Proof	Laudo final que junta testes, verificações e estado do projeto

---

👩‍💻 Se você já é dev

A trilha completa em 6 comandos:

gstack_vibehard start                                  # objetivo → consult read-only → plano → execução confirmada
gstack_vibehard create meu-app && cd meu-app           # scaffold lite (project-scoped)
gstack_vibehard dev                                    # runtime supervisionado: logs + readiness + stop/open
gstack_vibehard context scout "como o auth funciona?" --json   # contexto local-first (índice offline)
gstack_vibehard verify --json                          # gates determinísticos por arquétipo
gstack_vibehard proof --json                           # veredito único: verify + audit + readiness + git

Lite ou Full?

Lite (default do create): só arquivos do projeto — nada global, nenhuma config de IA tocada, nenhuma dependência pesada. Full (install): a plataforma completa — com preflight obrigatório, backup + manifest, confirmação explícita e rollback real via uninstall. Não empilhe caminhos: o consult recomenda um e detecta empilhamento. Detalhes: caminhos de instalação.

Como saber se está pronto · como desfazer

proof --json responde com ready:true somente quando todos os gates determinísticos passam (nenhuma opinião de modelo decide). Para desfazer: uninstall --dry-run mostra o plano; uninstall restaura via manifest e preserva o que você editou — guia de reset.

---

🔧 Para engenheiros: o que existe por trás

Capacidades reais (cada uma com guia próprio — o README não tenta explicar tudo):…