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.

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.

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