Primeros Pasos

Planu es un plugin para tu herramienta de IA que te ayuda a planificar, rastrear y verificar funciones de software. En lugar de repetirte en cada chat, creas una spec (un plan corto con una lista de verificación de "listo") y tu IA la sigue automáticamente.

Funciona con cualquier lenguaje de programación, cualquier framework y la mayoría de herramientas de IA — incluyendo las que no soportan MCP.

Instalar

npm install -g @planu/cli

Luego configura todas tus herramientas de IA en un comando:

planu install --global

Eso es todo. Planu escanea tu máquina, detecta cada herramienta de IA que tienes instalada y configura cada una automáticamente.

$ planu install --global

Buscando herramientas de IA...
  Claude Code   encontrado  → ~/.claude/claude.json actualizado
  Cursor        encontrado  → ~/.cursor/mcp.json actualizado
  Windsurf      encontrado  → ~/.windsurf/mcp.json actualizado
  OpenCode      encontrado  → ~/.config/opencode/config.json actualizado
  Codex         encontrado  → AGENTS.md actualizado

Reinicia tus herramientas de IA. Planu está listo.

Sin editar JSON. Sin conocer MCP. Sin archivos de config que aprender.

¿No tienes npm instalado?

Usa npx sin instalación global:

npx @planu/cli@latest install --global

Herramientas de IA compatibles

Herramientas compatibles con MCP (plug-and-play)

Planu se conecta como servidor MCP — el estándar abierto para plugins de IA:

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

Herramientas sin MCP (CLI + HTTP)

Para herramientas de IA que no soportan MCP nativamente, Planu funciona de dos formas:

Codex / estilo AGENTS.md — planu install --codex inyecta instrucciones CLI de Planu en AGENTS.md. Codex y cualquier LLM que lea archivos de instrucciones de agente usará Planu automáticamente.

HTTP / OpenAI function calling — inicia el servidor HTTP y cualquier LLM con HTTP tool use (GPT-4, Gemini, Kimi, Claude API) puede llamar las tools de Planu directamente:

planu serve --http --port 7823
# Tools disponibles en: POST http://localhost:7823/v1/tools/call
# Lista de tools en:    GET  http://localhost:7823/v1/tools

Evitar permisos repetitivos (recomendado)

Por defecto, tu herramienta de IA te pedirá aprobación cada vez que Planu use un tool. Para auto-aprobar todos los tools de Planu (seguro — Planu solo lee y escribe archivos locales de specs):

Claude Code

claude settings add permissions.allow "mcp__planu__*"

O agrega manualmente a ~/.claude/settings.json:

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

Cursor

En la configuración de Cursor → Features → MCP → activa Auto-approve para el servidor Planu.

Windsurf / OpenCode

Auto-aprueban tools MCP por defecto — no necesitas configuración extra.

¿Por qué es seguro?

Planu solo lee y escribe archivos dentro de la carpeta planu/ de tu proyecto. Nunca ejecuta código, accede a internet ni modifica tus archivos fuente.

Instalación manual (para herramientas no soportadas o configuraciones personalizadas)

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

Claude Code:

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

Cursor: Abre o crea ~/.cursor/mcp.json y pega el bloque de configuración.

Windsurf: Abre o crea ~/.windsurf/mcp.json y pega el bloque de configuración.

OpenCode: Abre o crea ~/.config/opencode/config.json y pega:

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

Gemini CLI: Abre o crea ~/.gemini/settings.json y pega el bloque de configuración.

Codex / AGENTS.md:

planu install --codex     # inyecta instrucciones en AGENTS.md

ChatGPT Desktop:

• Mac: ~/Library/Application Support/ChatGPT/config.json
• Windows: %APPDATA%\ChatGPT\config.json

Tu Primer Proyecto

Una vez instalado, simplemente inicia una conversación con tu asistente de IA. Sin comandos que memorizar.

Si estás empezando desde una carpeta padre y quieres que Planu cree una app nueva, lee primero Flujos de Inicialización. Explica por qué Planu debe crear o confirmar la carpeta de la app antes de ejecutar init_project.

Ejemplo: "Quiero agregar login con Google a mi app"

Eso es todo. Di lo que quieres. Planu automáticamente:

1. Analiza tu proyecto — detecta tu stack tecnológico, código existente y estructura
2. Crea un plan detallado — una spec con criterios de aceptación, estimación de esfuerzo y enfoque técnico
3. Pide tu aprobación — revisas el plan y apruebas, solicitas cambios o rechazas
4. Implementa siguiendo el plan — el código se escribe según la spec aprobada
5. Valida el resultado — verifica que la implementación coincida con el plan

Más ejemplos de lo que puedes decir

• "Construye un sistema de pagos con Stripe"
• "Agrega un toggle de modo oscuro a la página de configuración"
• "Corrige el bug donde los usuarios no pueden subir archivos grandes"
• "Refactoriza el módulo de autenticación para usar JWT"
• "Necesito un endpoint de API para perfiles de usuario"

Siempre tienes el control

• Aprueba o rechaza cualquier plan antes de que se escriba código
• Solicita cambios — "hazlo más simple" o "agrega rate limiting"
• Saltea el flujo — "solo agrega un console.log" también funciona
• Rastrea el progreso — Planu lleva registro de qué está hecho y qué está pendiente

Ese es el tutorial completo. Instala, habla, construye. Planu se encarga del resto.

Tu Ecosistema de IA — Configuración automática para cada herramienta

Si usas más de una herramienta de IA, Planu tiene dos comandos que te ahorrarán horas de trabajo de configuración.

ai_ecosystem_status — Health check para cada herramienta de IA

Planu escanea tu máquina en busca de herramientas de IA instaladas y devuelve una puntuación de salud (0-100) para cada una, mostrando exactamente qué está mal configurado, faltante o subóptimo.

Prompt: "¿Cuál es el estado de mi ecosistema de IA?"

Ejemplo de salida:

Claude Code    82/100   Stop hook: OK, PreCompact: OK, UserPromptSubmit: faltante
Gemini CLI     41/100   7 hooks sin configurar, motor de políticas no configurado
Codex CLI       0/100   No inicializado — sin AGENTS.md, sin config
Cursor         95/100   .cursorrules: OK, servidor MCP: OK
Windsurf       70/100   .windsurfrules presente, sin contexto de flujo SDD

Herramientas soportadas: Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, GitHub Copilot, Continue.dev, Aider.

sync_ai_configs — Arregla todo de una vez

Una vez que sabes qué falta, sync_ai_configs genera la configuración correcta para cada herramienta que Planu detectó — simultáneamente.

Prompt: "Sincroniza mis configs de IA"

Lo que Planu genera por herramienta:

• Claude Code — Stop hook, PreCompact, UserPromptSubmit, 14 comandos personalizados, niveles de esfuerzo, perfiles
• Codex CLI — AGENTS.md + .codex/config.toml + 3 roles de agente (spec-writer, implementer, reviewer)
• Gemini CLI — GEMINI.md + .gemini/settings.json + 11 hooks + motor de políticas TOML + extensiones recomendadas
• Cursor / Windsurf — .cursorrules / .windsurfrules con contexto de flujo SDD y conciencia de specs
• Aider — .aider.conf.yml ajustado para desarrollo guiado por specs y validado

Una instalación, cero esfuerzo de configuración

Ejecuta sync_ai_configs una vez después de instalar Planu. A partir de ese momento, cada herramienta de IA que uses está configurada para el desarrollo guiado por specs.

Próximos Pasos

• Entender el Workflow SDD completo →
• Explorar todas las tools de Planu →
• Ver recetas del mundo real →