First configuration

Initialize Palabre

palabre init

This command creates a global configuration at:

~/.palabre/palabre.config.json

It also detects locally available tools: Codex, Claude, Gemini, OpenCode, and Ollama.

Verify the installation

palabre doctor

doctor does not launch any AI agent. It checks the configuration, available commands, Ollama, and declared local models.

View declared agents

palabre agents

or:

palabre -a

This command displays the agents present in your configuration and indicates whether they are detected on your machine.

Choose default agents

The simplest way is to use the assistant:

palabre config

You can also set default agents directly:

palabre config --set-defaults codex claude --summary-agent claude -t 4

Here:

• codex responds first;
• claude responds second;
• claude produces the final summary;
• -t 4 requests four turns in total.

Add agents detected later

If you install OpenCode, Gemini, or Ollama after creating the configuration:

palabre config --sync-agents

This command adds missing detected agents without overwriting your existing settings.

Next step

You can now start your first debate.