Skip to content

JuReyms/Palabre

Repository files navigation

PALABRE

Version Downloads License Documentation

PALABRE

Français | English

Français

PALABRE est un orchestrateur CLI qui fait dialoguer plusieurs agents IA installés sur votre machine : Claude Code, Codex CLI, Gemini CLI, Antigravity CLI, OpenCode et Ollama.

Il ne remplace pas vos outils : il les pilote. Vous gardez vos abonnements, vos modèles par défaut, vos habitudes de terminal et vos fichiers en local. PALABRE exporte ensuite le débat en Markdown.

Documentation

Pages utiles : Installation, Configuration, Premier débat, Référence CLI, Dépannage, Roadmap.

Installation

Prérequis : Node.js 20 ou plus, et au moins deux agents déjà installés/authentifiés si vous voulez les faire débattre.

npm install -g palabre
palabre --version
palabre --help

Démarrage rapide

palabre init
palabre doctor
palabre new

Exemples directs :

palabre codex-claude "Critique ce plan" -t 4
palabre -s "Compare ces deux approches" -t 2
palabre codex-claude "Relis cette architecture" --context src docs
palabre claude-ollama "Critique ce fichier" --files README.md
palabre codex-claude "Preview" --context src --show-prompt
palabre context scan src docs --json

Agents supportés

  • Claude Code via claude --print
  • Codex CLI via codex exec
  • Gemini CLI via gemini --prompt -
  • Antigravity CLI via agy --print en pseudo-terminal
  • OpenCode via opencode run
  • Ollama via l'API locale HTTP

PALABRE ne liste pas les modèles : ils changent souvent et dépendent de chaque CLI ou compte utilisateur. --model-a, --model-b et --summary-model transmettent simplement la valeur brute à l'agent concerné.

Intégrations

PALABRE expose des sorties JSON versionnées pour les clients externes :

  • palabre presets --json pour lire les paires d'agents disponibles ;
  • palabre context scan --json pour prévisualiser le contexte que --context retiendrait ;
  • --renderer ndjson ou --json pour suivre un débat événement par événement.

Le flux NDJSON v1 est traité comme une API publique d'intégration. Les ajouts compatibles se font sans casser v1 ; les changements cassants doivent changer le champ v.

Skill pour agents IA

PALABRE fournit un skill prêt à l'emploi qui apprend à un agent IA quand et comment lancer un débat. Il suit le standard ouvert agentskills.io : il est donc portable entre Hermes Agent, Claude, Codex, Gemini CLI et tout agent compatible skills.

Installation dans Hermes Agent :

hermes skills install JuReyms/Palabre/skills/palabre

Pour les autres agents (Claude desktop, Claude Code…), voir la doc : Skill Palabre.

Le skill est versionné dans skills/palabre.

Confidentialité

PALABRE tourne localement et n'envoie aucune donnée à un serveur appartenant à PALABRE. Les données envoyées aux agents dépendent des outils que vous utilisez : vérifiez les politiques de confidentialité de Claude Code, Codex CLI, Gemini CLI, Antigravity CLI, OpenCode, Ollama ou de tout autre agent configuré.

Si un agent échoue pendant le débat ou la synthèse, PALABRE conserve l'export Markdown partiel avec une section d'interruption quand c'est possible.

Développement local

git clone https://github.com/JuReyms/Palabre.git
cd Palabre
pnpm install
pnpm build
pnpm link --global
palabre --version

Commandes utiles : pnpm check, pnpm test, pnpm build.

Avant une publication, pnpm smoke:real-presets -- --keep-going lance des débats réels sur les presets prioritaires disponibles afin de vérifier le flux complet agent → NDJSON → export. Ce smoke test appelle de vraies CLIs IA et peut consommer des quotas ; il n'est donc pas lancé par pnpm test.

Roadmap publique : docs/guide/fr/roadmap.md. Changements : CHANGELOG.md. Guide agents/contributeurs : AGENTS.md.

Licence

MIT. Voir LICENSE.

English

PALABRE is a CLI orchestrator that lets multiple AI agents installed on your machine talk to each other: Claude Code, Codex CLI, Gemini CLI, Antigravity CLI, OpenCode, and Ollama.

It does not replace your tools: it drives them. You keep your subscriptions, default models, terminal habits, and local files. PALABRE then exports the debate as Markdown.

Documentation

Useful pages: Installation, Configuration, First debate, CLI reference, Troubleshooting, Roadmap.

Installation

Requirements: Node.js 20 or newer, and at least two already installed/authenticated agents if you want them to debate.

npm install -g palabre
palabre --version
palabre --help

Quick Start

palabre init
palabre doctor
palabre new

Direct examples:

palabre codex-claude "Review this plan" -t 4
palabre -s "Compare these two approaches" -t 2
palabre codex-claude "Review this architecture" --context src docs
palabre claude-ollama "Review this file" --files README.md
palabre codex-claude "Preview" --context src --show-prompt
palabre context scan src docs --json

Supported Agents

  • Claude Code via claude --print
  • Codex CLI via codex exec
  • Gemini CLI via gemini --prompt -
  • Antigravity CLI via agy --print in a pseudo-terminal
  • OpenCode via opencode run
  • Ollama via the local HTTP API

PALABRE does not list models: they change often and depend on each CLI or user account. --model-a, --model-b, and --summary-model simply pass the raw value to the selected agent.

Integrations

PALABRE exposes versioned JSON outputs for external clients:

  • palabre presets --json to read available agent pairs;
  • palabre context scan --json to preview the context --context would retain;
  • --renderer ndjson or --json to follow a debate event by event.

The NDJSON v1 stream is treated as a public integration API. Compatible additions do not break v1; breaking changes must change the v field.

Skill for AI agents

PALABRE ships a ready-to-use skill that teaches an AI agent when and how to run a debate. It follows the open agentskills.io standard, so it is portable across Hermes Agent, Claude, Codex, Gemini CLI, and any skills-compatible agent.

Install it in Hermes Agent:

hermes skills install JuReyms/Palabre/skills/palabre

For other agents (Claude desktop, Claude Code…), see the docs: Palabre skill.

The skill is versioned under skills/palabre.

Privacy

PALABRE runs locally and does not send data to a PALABRE-owned server. Data sent to agents depends on the tools you use: check the privacy policies of Claude Code, Codex CLI, Gemini CLI, Antigravity CLI, OpenCode, Ollama, or any custom agent you configure.

If an agent fails during the debate or final summary, PALABRE keeps the partial Markdown export with an interruption section whenever possible.

Local Development

git clone https://github.com/JuReyms/Palabre.git
cd Palabre
pnpm install
pnpm build
pnpm link --global
palabre --version

Useful commands: pnpm check, pnpm test, pnpm build.

Before publishing, pnpm smoke:real-presets -- --keep-going runs real debates for the available priority presets to validate the full agent → NDJSON → export flow. This smoke test calls real AI CLIs and may consume quota, so it is not part of pnpm test.

Public roadmap: docs/guide/fr/roadmap.md. Changes: CHANGELOG.md. Agent/contributor guide: AGENTS.md.

License

MIT. See LICENSE.

About

PALABRE is a CLI orchestrator that lets multiple AI agents installed on your machine talk to each other: Claude Code, Codex, Gemini, OpenCode, and Ollama.

Resources

License

Stars

Watchers

Forks

Contributors