Skip to Content
Início RápidoInstalar CLI

Instalar CLI

Configure a CLI do SpecForge, autentique e conecte seu repositório ao seu projeto.

A CLI faz a ponte entre seu ambiente local e a plataforma SpecForge. Ela conecta o projeto que você criou na webapp (ou no terminal) com o agente de código que você usa no dia a dia.

Instalar

Execute diretamente com npx — sem necessidade de instalação global:

npx @specforge/cli@latest

✅ Crie um alias no shell para conveniência: alias specforge="npx @specforge/cli@latest"

Autenticar

specforge login

Isso abre seu navegador para autenticação. Uma vez autorizado, as credenciais são armazenadas localmente.

Trabalhando em um servidor remoto sem navegador? Use sua chave de API diretamente:

specforge login --api-key sf_live_...

Inicializar Seu Projeto

Execute specforge init na raiz do seu repositório:

specforge init

O setup interativo guia você pela seleção de projeto e especificação. Mas o valor real está no que ele gera.

O SpecForge detecta quais ferramentas de código você tem instaladas e gera a configuração certa para cada uma.

Para Claude Code, ele gera:

  • .mcp.json — registra o servidor MCP do SpecForge (22 ferramentas disponíveis)
  • CLAUDE.md — ancora o contexto do projeto para que o Claude Code saiba qual projeto e especificação do SpecForge ele está trabalhando
  • .claude/skills/ — skills operacionais que ensinam o Claude Code a usar as ferramentas MCP do SpecForge para planejamento, implementação e validação
  • .claude/agents/ — definições de agentes especializados para implementação paralela orquestrada via Agent Teams

Para Cursor e VS Code com Copilot:

  • .mcp.json — mesmo registro de servidor MCP
  • AGENTS.md — instruções de agente adaptadas para o modo agente do editor

Para Gemini CLI, Codex CLI, OpenCode:

  • Seus formatos nativos de configuração (.gemini/settings.json, .codex/config.toml, opencode.json)
  • AGENTS.md — instruções universais de agente

Um comando. Todas as ferramentas configuradas. Seu agente de código ganha acesso ao toolkit completo do SpecForge sem aprender nada novo.

💡 Já tem um .mcp.json com outros servidores? O specforge init faz o merge da entrada do SpecForge sem tocar na sua configuração existente.

Terminal simulado mostrando specforge init detectando Claude Code e gerando arquivos do projeto

Verificar

specforge doctor

Uma execução limpa fica assim:

SpecForge Doctor
  API Key         ✓ authenticated
  MCP Server      ✓ registered in .mcp.json
  Project         ✓ proj_abc123 accessible
  Specification   ✓ spec_xyz789 loaded (3 epics, 14 tickets)
  Agent Config    ✓ CLAUDE.md present
  Git             ✓ clean working tree

All checks passed.

📖 Para a lista completa de comandos e flags da CLI, veja Referência de Comandos CLI. Para opções detalhadas de configuração, veja Schema de Configuração.

Terminal simulado mostrando specforge doctor com todas as verificações passando

Próximos Passos

Seu terminal está conectado. Agora deixe seu agente de código implementar a especificação de forma autônoma.

Próximo: Implementação Autônoma →

Primeira EspecificaçãoImplementação Autônoma