Référence des commandes
Cette page liste les commandes principales de Palabre.
Commandes de démarrage
| Commande | Description |
|---|---|
palabre | Ouvre l'accueil TUI, crée la configuration globale au premier lancement et rafraîchit les agents connus détectés. |
palabre init | Crée explicitement la configuration globale et détecte les agents. |
palabre init --local | Crée une configuration dans le dossier courant. |
palabre doctor | Affiche un diagnostic par sections : configuration, outils locaux, agents et points à vérifier. |
palabre agents | Liste les agents déclarés et leur détection locale. |
palabre -a | Raccourci de palabre agents. |
palabre history, palabre historique | Liste les derniers exports Markdown Palabre. |
palabre sessions | Liste les checkpoints de reprise du dossier courant. |
palabre context scan --json | Pré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.
| Commande | Description |
|---|---|
palabre config | Ouvre l'assistant de configuration. |
palabre config --set-defaults codex claude | Définit les agents par défaut. |
palabre agent-role claude critic | Définit durablement le rôle d'un agent. |
palabre config -t 4 | Définit le nombre de tours par défaut. |
palabre config --summary-agent claude | Définit l'agent de synthèse par défaut. |
palabre config --summary-agent none | Retire l'agent de synthèse par défaut. |
palabre config --ask-summary-agent opencode | Définit l'agent de synthèse par défaut du mode ask. |
palabre config --mode chat | Définit le mode par défaut (chat, debate ou ask). |
palabre config --ask-agents codex claude opencode | Définit les agents par défaut du mode ask, 4 maximum. |
palabre config --interface tui | Définit l'interface par défaut (tui ou terminal). |
palabre config --language en | Définit la langue de Palabre et des prompts agents. |
palabre config --clear-defaults | Supprime les paramètres par défaut. |
palabre config --sync-agents | Ajoute les agents détectés manquants et rafraîchit les commandes connues. |
palabre config --ollama-models --json | Liste 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-model | Remplace le modèle Ollama configuré s'il n'est plus installé. |
Débats
| Commande | Description |
|---|---|
palabre new | Compose 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 4 | Lance avec les agents par défaut. |
palabre codex-claude "Sujet" -t 4 | Lance avec un preset. |
palabre run --subject "Sujet" --agent-a codex --agent-b claude | Lance avec des agents explicites. |
palabre run --subject "Sujet" --agent-a codex --agent-b claude --role-a architect --role-b critic | Lance avec des rôles temporaires. |
palabre ask "Sujet" --agents codex claude | Lance une demande avec des réponses indépendantes. |
palabre chat --agent-a codex | Ouvre 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.
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.
Cette première version reste stateless et n'exécute aucune action. 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.
| Commande | Description |
|---|---|
/ | Affiche la liste contextuelle des commandes canoniques ; les flèches, Tab ou → complètent la sélection. |
/new | Ouvre le parcours guidé de composition d'une session Chat, Débat ou Ask. |
/chat | Ouvre une conversation avec l'agent A par défaut. /home ou /exit revient à l'accueil. |
/ask | Passe l'accueil TUI en mode Ask. |
/debat | Passe l'accueil TUI en mode débat. |
/agents | Affiche les agents disponibles ou modifie les agents actifs si des noms sont fournis. |
/roles | Affiche 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. |
/config | Ouvre les réglages TUI. |
/history | Affiche les derniers exports Markdown. Alias : /historique. |
/update | Ouvre l'écran de mise à jour adapté au canal d'installation détecté. |
/ollama | Affiche le modèle Ollama configuré et les modèles installés depuis /config. |
| `/ollama-url <url | default>` |
/ollama-model <modele> | Change le modèle configuré de ollama-local depuis /config. |
/ollama-sync | Remplace le modèle Ollama configuré par un modèle installé quand le modèle courant est absent. |
/language fr, /language en | Change la langue depuis /config. Alias : /lang, /langue. |
/interface tui, /interface terminal | Change l'interface par défaut depuis /config. |
/home | Revient à l'accueil TUI. Alias : /back. |
/quit | Quitte la TUI. |
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.
| Commande | Description |
|---|---|
palabre agents --json | Liste les agents configurés, leur rôle, leur type et leur disponibilité au format JSON v1. |
palabre presets --json | Liste les presets et leur disponibilité locale. |
palabre history --json | Liste les 10 derniers exports Markdown au format JSON v1. |
palabre history --json --limit 30 | Liste jusqu'à 30 exports (maximum : 100). |
palabre sessions --json | Liste jusqu'à 20 checkpoints au format JSON v1, valides ou invalides. |
palabre sessions --json --limit 30 | Liste jusqu'à 30 checkpoints (maximum : 100). |
palabre sessions delete <session-id> --yes --json | Supprime exactement un checkpoint et confirme son identifiant au format JSON v1. |
palabre config --ollama-models --json | Renvoie l'état Ollama local au format JSON v1 pour les intégrations. |
palabre context scan [paths...] --json | Renvoie les dossiers, fichiers et avertissements du scan --context au format JSON v1. |
Options générales
| Option | Description |
|---|---|
-h, --help | Affiche l'aide. |
-v, --version | Affiche la version. |
--config <path> | Utilise un fichier de configuration explicite. |
--trust-config | Approuve l'empreinte de la configuration locale après vérification de son contenu. |
--language <fr|en>, --lang <fr|en> | Force la langue de Palabre et des prompts agents pour la commande. |
--tui | Force l'interface TUI, même si la configuration demande le rendu terminal. |
--terminal, --no-tui | Utilise un rendu terminal brut. Aussi utile avec palabre doctor pour les logs. |
--plain | Alias historique de --terminal. |
--json | Demande 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
| Option | Description |
|---|---|
-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> | 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-stop | Dé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-models | Autorise Ollama à télécharger un modèle manquant. |
--checkpoint | Conserve un état machine versionné sous .palabre/sessions/ pour une future reprise. |
--yes | Confirme 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-summary | Désactive la synthèse finale. |
--files <paths...> | Injecte des fichiers précis. |
--context <paths...> | Scanne fichiers ou dossiers texte. |
--show-prompt | Affiche le prompt du premier tour sans appeler d'agent. |
--dry-run | Prévisualise la session résolue sans appeler d'agent ni écrire d'export. |
Mise à jour
| Commande | Description |
|---|---|
palabre update | Affiche le plan puis demande une confirmation TTY avant une mise à jour sûre. |
palabre update --check | Vérifie la version et le canal sans modifier la machine. |
palabre update --dry-run | Affiche les étapes exactes sans les lancer. |
palabre update --yes | Applique un plan sûr sans confirmation interactive. |
palabre update --apply | Alias compatible de --yes. |