EN
Référence

Référence des commandes

Référence des commandes et options disponibles dans la CLI Palabre.

Cette page liste les commandes principales de Palabre.

Commandes de démarrage

CommandeDescription
palabreOuvre l'accueil TUI, crée la configuration globale au premier lancement et rafraîchit les agents connus détectés.
palabre initCrée explicitement la configuration globale et détecte les agents.
palabre init --localCrée une configuration dans le dossier courant.
palabre doctorAffiche un diagnostic par sections : configuration, outils locaux, agents et points à vérifier.
palabre agentsListe les agents déclarés et leur détection locale.
palabre -aRaccourci de palabre agents.
palabre history, palabre historiqueListe les derniers exports Markdown Palabre.
palabre sessionsListe les checkpoints de reprise du dossier courant.
palabre context scan --jsonPrévisualise le contexte projet que Palabre retiendrait.

Configuration

L'accueil TUI applique la même synchronisation prudente des agents connus que palabre config --sync-agents : il ajoute les agents connus nouvellement détectés et rafraîchit leurs commandes sans toucher aux agents custom ni aux defaults utilisateur. Si le fichier de configuration a été modifié depuis son chargement, rien n'est écrit : un avertissement l'indique et l'accueil continue avec la configuration chargée, sans plus enregistrer aucun réglage pendant cette session ; relancez palabre pour recharger le fichier. palabre config --sync-agents et l'assistant palabre config s'arrêtent de même, sans écrire.

CommandeDescription
palabre configOuvre l'assistant de configuration.
palabre config --set-defaults codex claudeDéfinit les agents par défaut.
palabre agent-role claude criticDéfinit durablement le rôle d'un agent.
palabre config -t 4Définit le nombre de tours par défaut.
palabre config --summary-agent claudeDéfinit l'agent de synthèse par défaut.
palabre config --summary-agent noneRetire l'agent de synthèse par défaut.
palabre config --ask-summary-agent opencodeDéfinit l'agent de synthèse par défaut du mode ask.
palabre config --mode chatDéfinit le mode par défaut (chat, debate ou ask).
palabre config --ask-agents codex claude opencodeDéfinit les agents par défaut du mode ask, 4 maximum.
palabre config --interface tuiDéfinit l'interface par défaut (tui ou terminal).
palabre config --language enDéfinit la langue de Palabre et des prompts agents.
palabre config --clear-defaultsSupprime les paramètres par défaut.
palabre config --sync-agentsAjoute les agents détectés manquants et rafraîchit les commandes connues.
palabre config --ollama-models --jsonListe les modèles Ollama installés et l'état du modèle configuré.
palabre config --set-ollama-model <modele>Définit le modèle de l'agent ollama-local.
palabre config --sync-ollama-modelRemplace le modèle Ollama configuré s'il n'est plus installé.

Débats

CommandeDescription
palabre newCompose une session Chat, Débat ou Ask, affiche son récapitulatif puis permet de la lancer ou de personnaliser ses options.
palabre -s "Sujet" -t 4Lance avec les agents par défaut.
palabre codex-claude "Sujet" -t 4Lance avec un preset.
palabre run --subject "Sujet" --agent-a codex --agent-b claudeLance avec des agents explicites.
palabre run --subject "Sujet" --agent-a codex --agent-b claude --role-a architect --role-b criticLance avec des rôles temporaires.
palabre ask "Sujet" --agents codex claudeLance une demande avec des réponses indépendantes.
palabre result --reference <référence> --jsonRelit sans renvoi la réponse d'une demande OpenCode dont l'attente a expiré ; la référence vient de l'erreur de délai et garde la configuration approuvée de l'envoi.
palabre chat --agent-a codexOuvre une conversation suivie avec un seul agent.

Reprendre une session

Ajoutez --checkpoint à un Débat ou à une demande Ask pour enregistrer son état atomique sous .palabre/sessions/. Palabre affiche alors l'identifiant et la commande de reprise correspondante.

palabre codex-claude "Comparer deux options" --checkpoint
palabre sessions
palabre resume <session-id>
palabre sessions delete <session-id>

La reprise conserve les réponses complètes et relance uniquement le prochain tour, les agents Ask restants ou la synthèse. Avant tout appel, Palabre vérifie que la configuration est toujours approuvée et inchangée, puis compare les empreintes des fichiers de contexte. Une différence bloque la reprise afin de ne pas modifier silencieusement la décision. Le terminal demande confirmation ; utilisez --yes pour un lancement non interactif. Une session déjà terminée ne peut pas être reprise.

palabre sessions affiche les 20 checkpoints les plus récents par défaut, avec leur état, mode, nombre de réponses et prochaine phase. --limit <1-100> borne la liste. Un JSON corrompu est signalé comme invalide sans empêcher l'affichage des autres. La suppression montre le fichier exact et demande confirmation ; en mode non interactif, --yes est obligatoire. Elle ne supprime jamais les exports Markdown ni les autres checkpoints.

Relay

Pour retrouver un échange sans envoyer ni ouvrir : palabre relay recent [--limit 1-100] [--json] [--config <chemin>] [--language fr|en]. Date, objet et outil à confirmer avant reprise ; les exports sont des métadonnées non authentifiées. Retrouver un échange.

CommandeDescription
palabre relay --from <agent>:<uuid> --to <agent>:<uuid> "Message"Conversation fermée Codex ou Claude Code, reprise en lecture seule.
palabre relay --open --from <agent>:<uuid> --to codex:<uuid> "Message"Conversation Codex ouverte, pilote Windows/macOS/Linux (python3 sur POSIX) ; outils et permissions propres à la cible.
palabre relay --from <agent>:<uuid> --to <agent>:<uuid> --task review --pr https://github.com/proprietaire/depot/pull/123Rédige et publie une revue COMMENT si autorisée.
palabre relay allow-repo proprietaire/depotAutorise la tâche review après confirmation au clavier par le propriétaire.

Options : --message-file <chemin>, --subject "<objet>" (une ligne, 200 caractères), --timeout <secondes> (10–3600, défaut 600), --json, --no-export, --config, --trust-config (refusé avec review), --language. L’historique peut être modifié ; aucun renvoi automatique. Délivrance, diagnostics et limites : Relay.

L’option Mission de Relay garde plusieurs étapes en lecture seule dans un cadre et un budget fixés ; ce n’est pas un mode supplémentaire.

Option Mission (palabre mission)

CommandeDescription
palabre mission start --from <chef-de-mission>:<uuid> --to <equipier>:<uuid> --criteria "…" "Objectif"Conserve le cadre fixé avec l'humain, sans appeler d'agent.
palabre mission step <id> "Demande" [--timeout <secondes>]Au plus un appel à l'équipier fermé, en lecture seule ; tâche consult par défaut.
palabre mission step <id> "Revue" --task review --pr https://github.com/owner/repo/pull/123Réutilise la tâche de revue et sa politique Relay déjà approuvée.
palabre mission status <id> --jsonRelit le cadre et les résultats, sans appel d'agent.
palabre mission stop <id> --reason "…"Arrête définitivement la suite et demande au mieux l'annulation de l'appel.

Options de start : --tasks "consult,review" (consult par défaut), --max-steps (1–100, défaut 10), --max-duration (10–86400 secondes, défaut 3600), --timeout (10–3600 secondes, défaut 600), --config, --language fr|en. step peut surcharger le délai ; --json est disponible partout. Cadre et export .mission.md sous .palabre/missions/<id>/ ; aucun renvoi automatique après coupure ou délivrance inconnue. Voir Mission et Relay.

Conversation avec un agent

palabre chat --agent-a <agent> ouvre une conversation dans le terminal. Le premier message devient son contexte initial ; "Sujet" reste accepté en option pour préremplir ce contexte. À chaque message, Palabre lance un nouvel appel à la CLI sélectionnée et lui réinjecte l'historique déjà accumulé. Le résultat reste donc cohérent dans la session courante, sans dépendre d'une session interactive persistante chez Codex, Claude ou un autre outil.

Contrairement à Ask, qui recueille une ou plusieurs réponses indépendantes à une question unique avant une éventuelle synthèse, Chat entretient une conversation multi-tours avec un agent actif.

Utilisez /agents pour afficher les agents disponibles. /end enregistre la conversation dans .palabre/, affiche le fichier et le dossier puis revient à l'accueil ; /home revient sans enregistrer. /consult <agent> demande explicitement un second avis sur les six derniers messages retenus ; cet avis est ajouté à la conversation. /use <agent> bascule ensuite l'agent actif, ou vous pouvez continuer avec l'agent initial. --role-a, --model-a, --language, --files et --context restent disponibles. Si aucun --agent-a n'est donné, Palabre utilise l'agent A configuré par défaut.

Chat ne garde pas de session fournisseur persistante. Le contexte envoyé à chaque appel est borné aux six messages les plus récents ; Palabre signale lorsque des messages plus anciens ne sont plus transmis. La consultation reste explicite : l'agent peut la proposer, mais l'utilisateur garde l'initiative.

Après un débat ou un Ask terminé dans la TUI, /chat ouvre directement une conversation dont le contexte indique sa provenance et reprend le sujet avec la synthèse finale, ou les six échanges récents si aucune synthèse n'est disponible.

Commandes TUI

Ces commandes sont disponibles dans l'accueil TUI ou dans /config selon le contexte.

CommandeDescription
/Affiche la liste contextuelle des commandes canoniques ; les flèches, Tab ou → complètent la sélection.
/newOuvre le parcours guidé de composition d'une session Chat, Débat ou Ask.
/chatOuvre une conversation avec l'agent A par défaut. /home ou /exit revient à l'accueil.
/askPasse l'accueil TUI en mode Ask.
/debatPasse l'accueil TUI en mode débat.
/agentsAffiche les agents disponibles ou modifie les agents actifs si des noms sont fournis.
/rolesAffiche les rôles disponibles ou modifie les rôles actifs si des rôles sont fournis. En mode Ask, un seul rôle comme /roles critic s'applique à tous les agents Ask.
/configOuvre les réglages TUI.
/historyAffiche les derniers exports Markdown. Alias : /historique.
/updateOuvre l'écran de mise à jour adapté au canal d'installation détecté.
/ollamaAffiche le modèle Ollama configuré et les modèles installés depuis /config.
`/ollama-url <urldefault>`
/ollama-model <modele>Change le modèle configuré de ollama-local depuis /config.
/ollama-syncRemplace le modèle Ollama configuré par un modèle installé quand le modèle courant est absent.
/language fr, /language enChange la langue depuis /config. Alias : /lang, /langue.
/interface tui, /interface terminalChange l'interface par défaut depuis /config.
/homeRevient à l’accueil TUI.
/quitQuitte la TUI.
/backRevient à l’écran précédent.
/retryRelance la dernière session, explicitement.
/consult <agent>, /use <agent>, /endCommandes Chat ; voir le guide Chat.

Intégrations

Une intégration qui lance Palabre peut déclarer son identité dans l'environnement du processus enfant :

PALABRE_CLIENT=palabre-vscode
PALABRE_CLIENT_VERSION=1.7.1

Palabre inscrit ces informations, ainsi que sa propre version, dans les exports .debate.md, .chat.md et .ask.md. Le nom du client est libre afin de supporter de futures intégrations. Sans déclaration, la source indiquée est direct-cli.

CommandeDescription
palabre agents --jsonListe les agents configurés, leur rôle, leur type et leur disponibilité au format JSON v1.
palabre presets --jsonListe les presets et leur disponibilité locale.
palabre history --jsonListe les 10 derniers exports Markdown au format JSON v1.
palabre history --json --limit 30Liste jusqu'à 30 exports (maximum : 100).
palabre sessions --jsonListe jusqu'à 20 checkpoints au format JSON v1, valides ou invalides.
palabre sessions --json --limit 30Liste jusqu'à 30 checkpoints (maximum : 100).
palabre sessions delete <session-id> --yes --jsonSupprime exactement un checkpoint et confirme son identifiant au format JSON v1.
palabre relay --from <agent>:<session> --to <agent>:<session> "…" --jsonRelaie un message vers une conversation fermée ou Codex ouverte avec --open et renvoie un objet JSON v1 relay-result, quelle que soit l'issue.
palabre config --ollama-models --jsonRenvoie l'état Ollama local au format JSON v1 pour les intégrations.
palabre context scan [paths...] --jsonRenvoie les dossiers, fichiers et avertissements du scan --context au format JSON v1.

Options générales

OptionDescription
-h, --helpAffiche l'aide.
-v, --versionAffiche la version.
--config <path>Utilise un fichier de configuration explicite.
--trust-configEnregistre l’approbation de la configuration résolue, locale ou globale, après relecture humaine ; jamais pour accorder des droits à un agent.
--language <fr|en>, --lang <fr|en>Force la langue de Palabre et des prompts agents pour la commande.
--tuiForce l'interface TUI, même si la configuration demande le rendu terminal.
--terminal, --no-tuiUtilise un rendu terminal brut. Aussi utile avec palabre doctor pour les logs.
--plainAlias historique de --terminal.
--jsonDemande la sortie JSON des commandes qui la proposent, ou l'objet résolu de dry-run.
--renderer <auto|pretty|plain|tui|ndjson>Choisit le renderer terminal ou intégration. tui active l'interface terminal plein écran.

Options de débat

OptionDescription
-s, --subject <text>Sujet de la session.
--topic <text>Alias compatible de --subject.
--preset <name>Choisit une paire d'agents.
--agent-a <name>Premier agent.
--agent-b <name>Second agent.
--role-a <role>Rôle temporaire du premier agent, sans modifier la config.
--role-b <role>Rôle temporaire du second agent, sans modifier la config.
--ask-role <role>Rôle commun temporaire appliqué à tous les agents Ask.
--mode <debate|ask|chat>Choisit le mode d'orchestration.
--agents <names...>Agents du mode ask, 4 maximum.
-t, --turns <number>Nombre total de réponses, entre 1 et 20.
--no-early-stopDésactive l'arrêt anticipé.
--model-a <model>Modèle transmis à l'agent A.
--model-b <model>Modèle transmis à l'agent B.
--ollama-url <url>Surcharge l'adresse de tous les agents Ollama pour cette session.
--pull-modelsAutorise Ollama à télécharger un modèle manquant.
--checkpointConserve un état machine versionné sous .palabre/sessions/ pour une future reprise.
--yesConfirme explicitement palabre resume ou une suppression de checkpoint en mode non interactif.
--summary-agent <name>Agent de synthèse.
--summary-model <model>Modèle de synthèse.
--no-summaryDésactive la synthèse finale.
--files <paths...>Injecte des fichiers précis.
--context <paths...>Scanne fichiers ou dossiers texte.
--show-promptAffiche le prompt du premier tour sans appeler d'agent.
--dry-runPrévisualise la session Débat ou Ask résolue sans appeler d'agent ni écrire d'export. Refusé en Chat.

Mise à jour

CommandeDescription
palabre updateAffiche le plan puis demande une confirmation TTY avant une mise à jour sûre.
palabre update --checkVérifie la version et le canal sans modifier la machine.
palabre update --dry-runAffiche les étapes exactes sans les lancer.
palabre update --yesApplique un plan sûr sans confirmation interactive.
palabre update --applyAlias compatible de --yes.
palabre skillCompare les copies du skill avec le paquet exécuté, sans écrire ni contacter le réseau.
palabre skill --syncAffiche les copies à rafraîchir et demande confirmation ; sauvegardes hors des dossiers de skills et jonctions conservées.
palabre skill --install codexInstalle le skill de cette CLI dans ~/.agents/skills/palabre, après confirmation. Utiliser --install claude pour Claude Code.
palabre skill --sync --dry-runAperçu sans écriture ; --check est aussi sans effet de bord.

Après installation par palabre update, Palabre vérifie automatiquement la version que la commande palabre lance dans son environnement avant de rafraîchir le skill. Si une ancienne installation reste prioritaire ou si la vérification échoue, il explique quoi faire et termine en erreur sans annoncer une mise à jour complète. Les copies du skill restent intactes à cette étape ; aucune réinstallation n'est tentée. Ce contrôle ne couvre pas les alias ou caches d'un autre terminal et ne s'applique pas à une installation lancée directement avec npm/pnpm/Yarn/Bun.

La confirmation unique de palabre update couvre aussi les copies du skill détectées, rafraîchies depuis le paquet nouvellement installé. Voir Skill Palabre pour les personnalisations, sauvegardes et le rechargement dans l'agent.

palabre mission status <id> --json rend un objet mission-result v1 sans appel d’agent. Les exports Relay indiquent la version de PALABRE, mais ne portent pas les champs de provenance PALABRE_CLIENT des exports Débat, Ask et Chat.

Sous Windows, cette vérification lance directement un exécutable ou un lanceur npm/pnpm strictement reconnu. Un lanceur inconnu reste non vérifié, sans essayer une autre installation. Les lanceurs réels de Yarn et Bun sous Windows n’ont pas été qualifiés dans ce lot.