Palabre for VS Code

Run Palabre debates from VS Code and watch local AI agents challenge each other in a chat-style side panel.

Status: functional alpha. Palabre for VS Code is a graphical client for the local palabre CLI; it does not bundle or reimplement the Palabre engine.

What can I use it for?

Palabre is useful when you want more than one AI opinion before changing code. Instead of asking a single assistant, you can put two local agents in conversation and keep the resulting debate as a Markdown file in your workspace.

Good use cases:

ask Codex and Claude to review a refactor plan before implementation;
compare two architecture options and surface trade-offs;
have one agent propose fixes while another critiques risks and regressions;
ask a local Ollama model to act as critic or scout alongside a remote CLI agent;
summarize disagreements after a long technical discussion.

Example subjects:

Analyze this extension and list the highest-priority UX fixes before release.
Compare these two approaches for handling agent crashes and partial exports.
Review my workspace context and propose safe improvements without broad refactors.

Features

Activity bar view with a debate composer.
Commands Palabre: Show Status, Palabre: Run Doctor, and Palabre: New Debate.
Streaming debate UI powered by palabre run --renderer ndjson.
Agent 1 / Agent 2 selectors derived from palabre presets --json, with unavailable pairs hidden from CLI-provided availability and a swap button for reversed pairs.
Workspace context picker powered by palabre context scan --json, then passed back to the CLI via --context.
Actionable error card with buttons to open the Palabre Output channel or run palabre doctor.
UI language follows VS Code: French when VS Code is in French, English otherwise. The same language is passed to Palabre CLI with --language.
Webview settings button for the current CLI path, default preset, language, and turn count.
Markdown export button at the end of a debate.

Supported agents

The extension uses the agents configured in Palabre CLI. Current Palabre presets support:

Codex CLI
Claude Code
Gemini CLI
Antigravity CLI
OpenCode
Ollama local models

The extension does not authenticate these tools for you. Install and sign in to the CLIs you want to use, then run palabre init or palabre config --sync-agents.

Requirements

VS Code 1.86 or newer.
Node.js 20 or newer for the local Palabre CLI.
Palabre CLI installed on your machine:

npm install -g palabre

Palabre CLI 0.6.0 or newer is required. The extension uses the CLI as the source of truth for presets, local availability, NDJSON streaming, context scanning, structured errors, and exports.

You also need at least two Palabre-compatible agents configured, such as Codex CLI, Claude Code, Gemini CLI, OpenCode, or Ollama.

Usage

Open the Palabre view from the activity bar.
Enter a concrete debate subject.
Choose Agent 1 / Agent 2 and the number of turns.
Optionally add workspace files or folders as context.
Start the debate and follow the streamed answers.
Open the exported .debate.md file when the debate is done.

Use Palabre: Show Status if the extension cannot find the CLI, or Palabre: Run Doctor to run palabre doctor from VS Code.

Settings

palabre.binaryPath: custom path to the palabre binary. Empty means auto-detect from the VS Code process PATH and common global package manager folders.
palabre.defaultTurns: preselected number of debate turns.
palabre.defaultPreset: favorite preset shown first when it exists in palabre presets --json. Empty means no favorite is inferred by the extension.
palabre.language: auto, fr, or en. auto follows VS Code's display language.

The settings button in the Palabre view shows the currently resolved CLI path and lets you choose the default preset from the live CLI preset list.

Architecture

The extension is intentionally thin:

VS Code extension: UI, commands, webview lifecycle, CLI spawn, NDJSON display.
Palabre CLI: orchestration, agents, presets, context scanning, limits, exports.

If behavior should be identical outside VS Code, it belongs in the CLI.

Known Limitations

A full VS Code window reload does not resume a running Palabre process.
Full debate execution depends on the external agent CLIs and their quotas.
Rich history/replay is not implemented yet; the extension can open recent .debate.md exports from the current workspace.

License

MIT.

Palabre

JuReyms