Démarrage rapide

Planu est un plugin pour votre outil IA qui vous aide à planifier, suivre et vérifier les fonctionnalités logicielles. Au lieu de vous répéter dans chaque chat, vous créez une spec (un plan court avec une liste "prêt") et votre IA la suit automatiquement.

Fonctionne avec n'importe quel langage, n'importe quel framework, et la plupart des outils IA — y compris ceux qui ne supportent pas MCP.

Installer

npm install -g @planu/cli

Configurez ensuite tous vos outils IA en une seule commande :

planu install --global

C'est tout. Planu scanne votre machine, détecte chaque outil IA installé et configure chacun automatiquement.

$ planu install --global

Recherche des outils IA...
  Claude Code   trouvé  → ~/.claude/claude.json mis à jour
  Cursor        trouvé  → ~/.cursor/mcp.json mis à jour
  Windsurf      trouvé  → ~/.windsurf/mcp.json mis à jour
  OpenCode      trouvé  → ~/.config/opencode/config.json mis à jour
  Codex         trouvé  → AGENTS.md mis à jour

Redémarrez vos outils IA. Planu est prêt.

Sans éditer de JSON. Sans connaître MCP. Sans apprendre de fichiers de config.

npm non installé ?

Utilisez npx sans installation globale :

npx @planu/cli@latest install --global

Outils IA compatibles

Outils compatibles MCP (plug-and-play)

Planu se connecte comme serveur MCP — le standard ouvert pour les plugins IA :

Outil IA	Auto-détecté
Claude Code	✓
Cursor	✓
Windsurf	✓
OpenCode	✓
Zed	✓
Cline (VS Code)	✓
Continue (VS Code)	✓
Claude Desktop	Config manuelle
Gemini CLI	Config manuelle

Outils sans MCP (CLI + HTTP)

Pour les outils IA qui ne supportent pas MCP nativement, Planu fonctionne de deux façons :

Codex / style AGENTS.md — planu install --codex injecte des instructions CLI Planu dans AGENTS.md. Codex et tout LLM qui lit les fichiers d'instructions d'agent utilisera Planu automatiquement.

HTTP / OpenAI function calling — démarrez le serveur HTTP et tout LLM avec HTTP tool use (GPT-4, Gemini, Kimi, Claude API) peut appeler les outils Planu directement :

planu serve --http --port 7823
# Outils disponibles sur : POST http://localhost:7823/v1/tools/call
# Liste des outils sur :   GET  http://localhost:7823/v1/tools

Éviter les demandes de permission (recommandé)

Par défaut, votre outil IA demandera une approbation à chaque fois que Planu utilise un outil. Pour auto-approuver tous les outils Planu (sûr — Planu ne lit et n'écrit que des fichiers locaux de specs) :

Claude Code

claude settings add permissions.allow "mcp__planu__*"

Ou ajoutez manuellement à ~/.claude/settings.json :

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

Cursor

Dans les paramètres Cursor → Features → MCP → activez Auto-approve pour le serveur Planu.

Windsurf / OpenCode

Auto-approuvent les outils MCP par défaut — aucune configuration supplémentaire nécessaire.

Pourquoi est-ce sûr ?

Planu ne lit et n'écrit que des fichiers dans le dossier planu/ de votre projet. Il n'exécute jamais de code, n'accède pas à internet et ne modifie pas vos fichiers source.

Installation manuelle (pour outils non supportés ou configurations personnalisées)

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

Claude Code :

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

Cursor : Ouvrez ou créez ~/.cursor/mcp.json et collez le bloc de config.

Windsurf : Ouvrez ou créez ~/.windsurf/mcp.json et collez le bloc de config.

OpenCode : Ouvrez ou créez ~/.config/opencode/config.json et collez :

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

Gemini CLI : Ouvrez ou créez ~/.gemini/settings.json et collez le bloc de config.

Codex / AGENTS.md :

planu install --codex     # injecte les instructions dans AGENTS.md

Votre premier projet

Une fois installé, commencez simplement une conversation avec votre assistant IA. Aucune commande à mémoriser.

Exemple : "Je veux ajouter la connexion Google à mon app"

C'est tout. Dites ce que vous voulez. Planu va automatiquement :

1. Analyser votre projet — détecte votre stack, le code existant et la structure
2. Créer un plan détaillé — une spec avec des critères d'acceptance, une estimation d'effort et l'approche technique
3. Demander votre validation — vous examinez le plan et approuvez, demandez des modifications ou rejetez
4. Implémenter selon le plan — le code est écrit selon la spec approuvée
5. Valider le résultat — vérifie que l'implémentation correspond au plan

Autres exemples

• "Construis-moi un système de paiement avec Stripe"
• "Ajoute un bouton mode sombre sur la page des paramètres"
• "Corrige le bug où les utilisateurs ne peuvent pas télécharger de gros fichiers"
• "Refactorise le module d'authentification pour utiliser JWT"
• "J'ai besoin d'un endpoint API pour les profils utilisateurs"

Vous gardez toujours le contrôle

• Approuvez ou rejetez tout plan avant que le code soit écrit
• Demandez des modifications — "rends ça plus simple" ou "ajoute du rate limiting"
• Court-circuitez le workflow — "ajoute juste un console.log" fonctionne aussi
• Suivez l'avancement — Planu garde la trace de ce qui est fait et de ce qui reste

C'est tout le tutoriel. Installez, discutez, construisez. Planu s'occupe du reste.

Votre écosystème IA — Configuration automatique pour chaque outil

ai_ecosystem_status — Bilan de santé pour chaque outil IA

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

sync_ai_configs — Tout corriger en une fois

Prompt: "Sync my AI configs"

Une installation, zéro effort de configuration

Exécutez sync_ai_configs une fois après avoir installé Planu. Chaque outil IA que vous utilisez sera instantanément configuré pour le développement spec-driven.

Étapes suivantes

• Comprendre le flux de travail SDD complet →
• Explorer tous les outils Planu →
• Voir des recettes concrètes →