Início Rápido

Planu é um plugin para sua ferramenta de IA que ajuda a planejar, acompanhar e verificar funcionalidades de software. Em vez de se repetir em cada chat, você cria uma spec (um plano curto com uma lista do que significa "pronto") e sua IA a segue automaticamente.

Funciona com qualquer linguagem, qualquer framework, e a maioria das ferramentas de IA — incluindo as que não suportam MCP.

Instalar

npm install -g @planu/cli

Em seguida, configure todas as suas ferramentas de IA em um comando:

planu install --global

Só isso. Planu escaneia sua máquina, detecta cada ferramenta de IA instalada e configura cada uma automaticamente.

$ planu install --global

Procurando ferramentas de IA...
  Claude Code   encontrado  → ~/.claude/claude.json atualizado
  Cursor        encontrado  → ~/.cursor/mcp.json atualizado
  Windsurf      encontrado  → ~/.windsurf/mcp.json atualizado
  OpenCode      encontrado  → ~/.config/opencode/config.json atualizado
  Codex         encontrado  → AGENTS.md atualizado

Reinicie suas ferramentas de IA. O Planu está pronto.

Sem editar JSON. Sem conhecer MCP. Sem arquivos de configuração para aprender.

Sem npm instalado?

Use npx sem instalação global:

npx @planu/cli@latest install --global

Ferramentas de IA compatíveis

Ferramentas compatíveis com MCP (plug-and-play)

Planu conecta-se como servidor MCP — o padrão aberto para plugins de IA:

Ferramenta de IA	Auto-detectada
Claude Code	✓
Cursor	✓
Windsurf	✓
OpenCode	✓
Zed	✓
Cline (VS Code)	✓
Continue (VS Code)	✓
Claude Desktop	Config manual
Gemini CLI	Config manual

Ferramentas sem MCP (CLI + HTTP)

Para ferramentas de IA sem suporte nativo a MCP, Planu funciona de duas formas:

Codex / estilo AGENTS.md — planu install --codex injeta instruções CLI do Planu no AGENTS.md. O Codex e qualquer LLM que leia arquivos de instrução de agente usará o Planu automaticamente.

HTTP / OpenAI function calling — inicie o servidor HTTP e qualquer LLM com HTTP tool use (GPT-4, Gemini, Kimi, Claude API) pode chamar os tools do Planu diretamente:

planu serve --http --port 7823
# Tools disponíveis em: POST http://localhost:7823/v1/tools/call
# Lista de tools em:    GET  http://localhost:7823/v1/tools

Pular prompts de permissão (recomendado)

Por padrão, sua ferramenta de IA pedirá aprovação toda vez que o Planu usar um tool. Para auto-aprovar todos os tools do Planu (seguro — o Planu só lê e escreve arquivos locais de specs):

Claude Code

claude settings add permissions.allow "mcp__planu__*"

Ou adicione manualmente ao ~/.claude/settings.json:

{
  "permissions": {
    "allow": ["mcp__planu__*"]
  }
}

Cursor

Nas configurações do Cursor → Features → MCP → ative Auto-approve para o servidor Planu.

Windsurf / OpenCode

Auto-aprovam tools MCP por padrão — nenhuma configuração extra necessária.

Por que é seguro?

O Planu só lê e escreve arquivos dentro da pasta planu/ do seu projeto. Nunca executa código, acessa a internet ou modifica seus arquivos fonte.

Instalação manual (para ferramentas não suportadas ou configurações personalizadas)

{
  "mcpServers": {
    "planu": {
      "command": "npx",
      "args": ["--prefer-online", "-y", "@planu/cli@latest"]
    }
  }
}

Claude Code:

claude mcp add planu -- npx -y @planu/cli@latest

Cursor: Abra ou crie ~/.cursor/mcp.json e cole o bloco de configuração.

Windsurf: Abra ou crie ~/.windsurf/mcp.json e cole o bloco de configuração.

OpenCode: Abra ou crie ~/.config/opencode/config.json e cole:

{
  "mcp": {
    "planu": { "type": "local", "command": ["planu", "serve"], "enabled": true }
  }
}

Gemini CLI: Abra ou crie ~/.gemini/settings.json e cole o bloco de configuração.

Codex / AGENTS.md:

planu install --codex     # injeta instruções no AGENTS.md

Seu Primeiro Projeto

Depois de instalado, é só começar uma conversa com seu assistente de IA. Sem comandos para memorizar.

Exemplo: "Quero adicionar login com Google no meu app"

É só isso. Diga o que você quer. O Planu vai automaticamente:

1. Analisar seu projeto — detecta seu stack tecnológico, código existente e estrutura
2. Criar um plano detalhado — uma spec com critérios de aceite, estimativa de esforço e abordagem técnica
3. Pedir sua aprovação — você revisa o plano e aprova, solicita alterações ou rejeita
4. Implementar seguindo o plano — o código é escrito de acordo com a spec aprovada
5. Validar o resultado — verifica se a implementação corresponde ao plano

Mais exemplos do que você pode dizer

• "Cria um sistema de pagamentos com Stripe"
• "Adiciona um toggle de modo escuro na página de configurações"
• "Corrige o bug onde usuários não conseguem fazer upload de arquivos grandes"
• "Refatora o módulo de autenticação para usar JWT"
• "Preciso de um endpoint de API para perfis de usuário"

Você sempre tem o controle

• Aprove ou rejeite qualquer plano antes do código ser escrito
• Solicite alterações — "deixa mais simples" ou "adiciona rate limiting"
• Pule o fluxo — "só adiciona um console.log" também funciona
• Acompanhe o progresso — o Planu registra o que está feito e o que está pendente

Esse é o tutorial completo. Instale, converse, construa. O Planu cuida do resto.

Seu Ecossistema de IA — Configuração automática para cada ferramenta

ai_ecosystem_status — Health check para cada ferramenta de IA

Prompt: "What is the health of my AI ecosystem?"

sync_ai_configs — Corrija tudo de uma vez

Prompt: "Sync my AI configs"

Uma instalação, zero esforço de configuração

Execute sync_ai_configs uma vez após instalar o Planu. Cada ferramenta de IA que você usa será instantaneamente configurada para o desenvolvimento spec-driven.

Próximos Passos

• Entenda o fluxo de trabalho SDD completo →
• Explore todos os tools do Planu →
• Veja receitas do mundo real →