[{"data":1,"prerenderedAt":770},["ShallowReactive",2],{"navigation-en":3,"\u002Fen\u002Fagents\u002Foverview":203,"\u002Fen\u002Fagents\u002Foverview-surround":765},[4,8,47,80,130,151,173,191,195,199],{"title":5,"path":6,"stem":7},"","\u002Fen","en\u002Findex",{"title":9,"icon":10,"path":11,"stem":12,"children":13,"page":46},"Get Started","i-lucide-rocket","\u002Fen\u002Fget-started","en\u002F1.get-started",[14,18,22,26,30,34,38,42],{"title":15,"path":16,"stem":17},"Introduction","\u002Fen\u002Fget-started\u002Fintroduction","en\u002F1.get-started\u002F1.introduction",{"title":19,"path":20,"stem":21},"Installation","\u002Fen\u002Fget-started\u002Finstallation","en\u002F1.get-started\u002F2.installation",{"title":23,"path":24,"stem":25},"Run your first session","\u002Fen\u002Fget-started\u002Ffirst-debate","en\u002F1.get-started\u002F3.first-debate",{"title":27,"path":28,"stem":29},"Your first Relay","\u002Fen\u002Fget-started\u002Ffirst-relay","en\u002F1.get-started\u002F4.first-relay",{"title":31,"path":32,"stem":33},"First configuration","\u002Fen\u002Fget-started\u002Fconfiguration","en\u002F1.get-started\u002F5.configuration",{"title":35,"path":36,"stem":37},"VS Code extension","\u002Fen\u002Fget-started\u002Fvscode-extension","en\u002F1.get-started\u002F6.vscode-extension",{"title":39,"path":40,"stem":41},"Palabre skill","\u002Fen\u002Fget-started\u002Fskill","en\u002F1.get-started\u002F7.skill",{"title":43,"path":44,"stem":45},"Change machines","\u002Fen\u002Fget-started\u002Fchange-machine","en\u002F1.get-started\u002F8.change-machine",false,{"title":48,"icon":49,"path":50,"stem":51,"children":52,"page":46},"Agents","i-lucide-bot","\u002Fen\u002Fagents","en\u002F2.agents",[53,56,60,64,68,72,76],{"title":48,"path":54,"stem":55},"\u002Fen\u002Fagents\u002Foverview","en\u002F2.agents\u002F1.overview",{"title":57,"path":58,"stem":59},"Claude Code","\u002Fen\u002Fagents\u002Fclaude-code","en\u002F2.agents\u002F2.claude-code",{"title":61,"path":62,"stem":63},"Codex","\u002Fen\u002Fagents\u002Fcodex","en\u002F2.agents\u002F3.codex",{"title":65,"path":66,"stem":67},"Antigravity","\u002Fen\u002Fagents\u002Fantigravity","en\u002F2.agents\u002F5.antigravity",{"title":69,"path":70,"stem":71},"OpenCode","\u002Fen\u002Fagents\u002Fopencode","en\u002F2.agents\u002F6.opencode",{"title":73,"path":74,"stem":75},"Ollama","\u002Fen\u002Fagents\u002Follama","en\u002F2.agents\u002F7.ollama",{"title":77,"path":78,"stem":79},"Mistral Vibe","\u002Fen\u002Fagents\u002Fvibe","en\u002F2.agents\u002F8.vibe",{"title":81,"icon":82,"path":83,"stem":84,"children":85,"page":46},"Usage","i-lucide-terminal","\u002Fen\u002Fusage","en\u002F3.usage",[86,90,94,98,102,106,110,114,118,122,126],{"title":87,"path":88,"stem":89},"Choose a mode","\u002Fen\u002Fusage\u002Frunning-a-debate","en\u002F3.usage\u002F01.running-a-debate",{"title":91,"path":92,"stem":93},"Debate mode","\u002Fen\u002Fusage\u002Fdebate","en\u002F3.usage\u002F02.debate",{"title":95,"path":96,"stem":97},"Relay mode","\u002Fen\u002Fusage\u002Frelay","en\u002F3.usage\u002F03.relay",{"title":99,"path":100,"stem":101},"Ask mode","\u002Fen\u002Fusage\u002Fask","en\u002F3.usage\u002F04.ask",{"title":103,"path":104,"stem":105},"Chat mode","\u002Fen\u002Fusage\u002Fchat","en\u002F3.usage\u002F05.chat",{"title":107,"path":108,"stem":109},"Use the TUI","\u002Fen\u002Fusage\u002Ftui","en\u002F3.usage\u002F06.tui",{"title":111,"path":112,"stem":113},"Context and files","\u002Fen\u002Fusage\u002Fcontext-and-files","en\u002F3.usage\u002F07.context-and-files",{"title":115,"path":116,"stem":117},"Summaries","\u002Fen\u002Fusage\u002Fsummaries","en\u002F3.usage\u002F08.summaries",{"title":119,"path":120,"stem":121},"Exports","\u002Fen\u002Fusage\u002Fexports","en\u002F3.usage\u002F09.exports",{"title":123,"path":124,"stem":125},"Use multiple AI agents from the terminal","\u002Fen\u002Fusage\u002Fmulti-agent-cli","en\u002F3.usage\u002F10.multi-agent-cli",{"title":127,"path":128,"stem":129},"Run a Codex and Claude Code debate","\u002Fen\u002Fusage\u002Fcodex-claude-debate","en\u002F3.usage\u002F11.codex-claude-debate",{"title":131,"icon":132,"path":133,"stem":134,"children":135,"page":46},"Configuration","i-lucide-settings","\u002Fen\u002Fconfiguration","en\u002F4.configuration",[136,139,143,147],{"title":131,"path":137,"stem":138},"\u002Fen\u002Fconfiguration\u002Foverview","en\u002F4.configuration\u002F1.overview",{"title":140,"path":141,"stem":142},"Default settings","\u002Fen\u002Fconfiguration\u002Fdefaults","en\u002F4.configuration\u002F2.defaults",{"title":144,"path":145,"stem":146},"Local vs global configuration","\u002Fen\u002Fconfiguration\u002Flocal-vs-global","en\u002F4.configuration\u002F3.local-vs-global",{"title":148,"path":149,"stem":150},"Advanced JSON","\u002Fen\u002Fconfiguration\u002Fadvanced-json","en\u002F4.configuration\u002F4.advanced-json",{"title":152,"icon":153,"path":154,"stem":155,"children":156,"page":46},"Integrations","i-lucide-blocks","\u002Fen\u002Fintegrations","en\u002F5.integrations",[157,161,165,169],{"title":158,"path":159,"stem":160},"Integrate Palabre","\u002Fen\u002Fintegrations\u002Foverview","en\u002F5.integrations\u002F1.overview",{"title":162,"path":163,"stem":164},"JSON catalogs","\u002Fen\u002Fintegrations\u002Fjson-contracts","en\u002F5.integrations\u002F2.json-contracts",{"title":166,"path":167,"stem":168},"NDJSON v1 stream","\u002Fen\u002Fintegrations\u002Fndjson","en\u002F5.integrations\u002F3.ndjson",{"title":170,"path":171,"stem":172},"Lifecycle, errors, and identity","\u002Fen\u002Fintegrations\u002Fclient-lifecycle","en\u002F5.integrations\u002F4.client-lifecycle",{"title":174,"icon":175,"path":176,"stem":177,"children":178,"page":46},"Reference","i-lucide-book","\u002Fen\u002Freference","en\u002F6.reference",[179,183,187],{"title":180,"path":181,"stem":182},"Command reference","\u002Fen\u002Freference\u002Fcli","en\u002F6.reference\u002F1.cli",{"title":184,"path":185,"stem":186},"Configuration file reference","\u002Fen\u002Freference\u002Fconfig-file","en\u002F6.reference\u002F2.config-file",{"title":188,"path":189,"stem":190},"Presets","\u002Fen\u002Freference\u002Fpresets","en\u002F6.reference\u002F3.presets",{"title":192,"path":193,"stem":194},"Troubleshooting","\u002Fen\u002Ftroubleshooting","en\u002F7.troubleshooting",{"title":196,"path":197,"stem":198},"Roadmap","\u002Fen\u002Froadmap","en\u002F8.roadmap",{"title":200,"path":201,"stem":202},"Changelog","\u002Fen\u002Fchangelog","en\u002F9.changelog",{"id":204,"title":48,"body":205,"description":756,"extension":757,"links":758,"meta":759,"navigation":760,"path":54,"seo":761,"stem":55,"__hash__":764},"docs\u002Fen\u002F2.agents\u002F1.overview.md",{"type":206,"value":207,"toc":746},"minimark",[208,212,215,225,230,233,236,239,243,246,258,262,294,297,312,316,319,398,401,405,428,431,438,611,614,640,643,653,657,671,675,690,714,718,729,742],[209,210,211],"p",{},"A Palabre agent is a configuration entry that describes how to call an AI.",[209,213,214],{},"Palabre supports two agent families:",[216,217,218,222],"ul",{},[219,220,221],"li",{},"CLI agents, such as Claude Code, Codex CLI, Antigravity CLI, OpenCode, or Mistral Vibe;",[219,223,224],{},"local agents, such as Ollama via its HTTP API.",[226,227,229],"h2",{"id":228},"cli-agents","CLI agents",[209,231,232],{},"A CLI agent is launched as a terminal command. Palabre sends it a prompt, retrieves its output, then closes the process.",[209,234,235],{},"Each CLI keeps its own rules: authentication, default model, subscription, usage limits, and configuration options. Some CLIs can work with a free tier, a subscription, a local provider, or a cloud provider; in all cases, quotas and rate limit errors come from the agent being used, not from Palabre.",[209,237,238],{},"If a CLI exits with an error without writing to stderr, Palabre shows a sanitized, bounded stdout excerpt to help diagnose the failure, for example an authentication error. The session still fails: this excerpt is never accepted as a response. Fix authentication or configuration in the affected CLI first, then run Palabre again.",[226,240,242],{"id":241},"local-agents","Local agents",[209,244,245],{},"A local agent like Ollama uses a model installed on your machine. This is useful for critic, exploration, or lightweight summary roles. If you configure Ollama with a cloud offer or a paid service, the associated limits remain those of Ollama or the chosen provider.",[209,247,248,249,253,254,257],{},"Ollama does not read your files directly. To give it context, use ",[250,251,252],"code",{},"--files"," or ",[250,255,256],{},"--context",".",[226,259,261],{"id":260},"view-available-agents","View available agents",[263,264,268],"pre",{"className":265,"code":266,"language":267,"meta":5,"style":5},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","palabre agents\npalabre agents --json\n","bash",[250,269,270,283],{"__ignoreMap":5},[271,272,275,279],"span",{"class":273,"line":274},"line",1,[271,276,278],{"class":277},"sBMFI","palabre",[271,280,282],{"class":281},"sfazB"," agents\n",[271,284,286,288,291],{"class":273,"line":285},2,[271,287,278],{"class":277},[271,289,290],{"class":281}," agents",[271,292,293],{"class":281}," --json\n",[209,295,296],{},"If an installed CLI does not appear in the configuration:",[263,298,300],{"className":265,"code":299,"language":267,"meta":5,"style":5},"palabre config --sync-agents\n",[250,301,302],{"__ignoreMap":5},[271,303,304,306,309],{"class":273,"line":274},[271,305,278],{"class":277},[271,307,308],{"class":281}," config",[271,310,311],{"class":281}," --sync-agents\n",[226,313,315],{"id":314},"roles","Roles",[209,317,318],{},"Each agent has a role that influences the prompt:",[320,321,322,334],"table",{},[323,324,325],"thead",{},[326,327,328,332],"tr",{},[329,330,331],"th",{},"Role",[329,333,81],{},[335,336,337,348,358,368,378,388],"tbody",{},[326,338,339,345],{},[340,341,342],"td",{},[250,343,344],{},"implementer",[340,346,347],{},"Propose a concrete solution.",[326,349,350,355],{},[340,351,352],{},[250,353,354],{},"reviewer",[340,356,357],{},"Look for risks, regressions, and missing tests.",[326,359,360,365],{},[340,361,362],{},[250,363,364],{},"critic",[340,366,367],{},"Challenge assumptions.",[326,369,370,375],{},[340,371,372],{},[250,373,374],{},"architect",[340,376,377],{},"Structure technical options.",[326,379,380,385],{},[340,381,382],{},[250,383,384],{},"scout",[340,386,387],{},"Quickly explore a topic.",[326,389,390,395],{},[340,391,392],{},[250,393,394],{},"summarizer",[340,396,397],{},"Produce a faithful summary.",[209,399,400],{},"Roles do not change the model used. They change the instruction sent in the prompt.",[226,402,404],{"id":403},"using-a-role","Using a role",[209,406,407,408,411,412,415,416,419,420,423,424,427],{},"A persistent role is configured in ",[250,409,410],{},"palabre.config.json",", in the agent entry, or with ",[250,413,414],{},"palabre agent-role \u003Cagent> \u003Crole>",". For a one-off run, use ",[250,417,418],{},"--role-a",", ",[250,421,422],{},"--role-b"," in debate mode, or ",[250,425,426],{},"--ask-role"," to apply one shared role to Ask agents.",[209,429,430],{},"Example:",[209,432,433,434,437],{},"Excerpt from the ",[250,435,436],{},"agents"," block:",[263,439,443],{"className":440,"code":441,"language":442,"meta":5,"style":5},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\"codex\": {\n  \"type\": \"cli\",\n  \"command\": \"codex\",\n  \"role\": \"implementer\"\n},\n\"claude\": {\n  \"type\": \"cli\",\n  \"command\": \"claude.exe\",\n  \"role\": \"reviewer\"\n}\n","json",[250,444,445,463,488,508,527,535,549,568,588,605],{"__ignoreMap":5},[271,446,447,451,454,456,460],{"class":273,"line":274},[271,448,450],{"class":449},"sMK4o","\"",[271,452,453],{"class":281},"codex",[271,455,450],{"class":449},[271,457,459],{"class":458},"sTEyZ",": ",[271,461,462],{"class":449},"{\n",[271,464,465,468,472,474,477,480,483,485],{"class":273,"line":285},[271,466,467],{"class":449},"  \"",[271,469,471],{"class":470},"spNyl","type",[271,473,450],{"class":449},[271,475,476],{"class":449},":",[271,478,479],{"class":449}," \"",[271,481,482],{"class":281},"cli",[271,484,450],{"class":449},[271,486,487],{"class":449},",\n",[271,489,491,493,496,498,500,502,504,506],{"class":273,"line":490},3,[271,492,467],{"class":449},[271,494,495],{"class":470},"command",[271,497,450],{"class":449},[271,499,476],{"class":449},[271,501,479],{"class":449},[271,503,453],{"class":281},[271,505,450],{"class":449},[271,507,487],{"class":449},[271,509,511,513,516,518,520,522,524],{"class":273,"line":510},4,[271,512,467],{"class":449},[271,514,515],{"class":470},"role",[271,517,450],{"class":449},[271,519,476],{"class":449},[271,521,479],{"class":449},[271,523,344],{"class":281},[271,525,526],{"class":449},"\"\n",[271,528,530,533],{"class":273,"line":529},5,[271,531,532],{"class":449},"}",[271,534,487],{"class":458},[271,536,538,540,543,545,547],{"class":273,"line":537},6,[271,539,450],{"class":449},[271,541,542],{"class":281},"claude",[271,544,450],{"class":449},[271,546,459],{"class":458},[271,548,462],{"class":449},[271,550,552,554,556,558,560,562,564,566],{"class":273,"line":551},7,[271,553,467],{"class":449},[271,555,471],{"class":470},[271,557,450],{"class":449},[271,559,476],{"class":449},[271,561,479],{"class":449},[271,563,482],{"class":281},[271,565,450],{"class":449},[271,567,487],{"class":449},[271,569,571,573,575,577,579,581,584,586],{"class":273,"line":570},8,[271,572,467],{"class":449},[271,574,495],{"class":470},[271,576,450],{"class":449},[271,578,476],{"class":449},[271,580,479],{"class":449},[271,582,583],{"class":281},"claude.exe",[271,585,450],{"class":449},[271,587,487],{"class":449},[271,589,591,593,595,597,599,601,603],{"class":273,"line":590},9,[271,592,467],{"class":449},[271,594,515],{"class":470},[271,596,450],{"class":449},[271,598,476],{"class":449},[271,600,479],{"class":449},[271,602,354],{"class":281},[271,604,526],{"class":449},[271,606,608],{"class":273,"line":607},10,[271,609,610],{"class":449},"}\n",[209,612,613],{},"With this configuration:",[263,615,617],{"className":265,"code":616,"language":267,"meta":5,"style":5},"palabre codex-claude \"Critique this plan\" -t 4\n",[250,618,619],{"__ignoreMap":5},[271,620,621,623,626,628,631,633,636],{"class":273,"line":274},[271,622,278],{"class":277},[271,624,625],{"class":281}," codex-claude",[271,627,479],{"class":449},[271,629,630],{"class":281},"Critique this plan",[271,632,450],{"class":449},[271,634,635],{"class":281}," -t",[271,637,639],{"class":638},"sbssI"," 4\n",[209,641,642],{},"Codex receives a concrete proposal instruction, while Claude receives a critical review instruction.",[209,644,645,646,649,650,257],{},"To use two different behaviors with the same CLI, create two distinct agents in the configuration, for example ",[250,647,648],{},"claude-reviewer"," and ",[250,651,652],{},"claude-summarizer",[226,654,656],{"id":655},"models-passed-as-arguments","Models passed as arguments",[209,658,659,660,419,663,666,667,670],{},"When you use ",[250,661,662],{},"--model-a",[250,664,665],{},"--model-b",", or ",[250,668,669],{},"--summary-model",", Palabre does not verify the list of models available at the provider. The value is passed to the relevant CLI via its configured model option. If the model does not exist or is not authorized by your account, the CLI will return the error.",[226,672,674],{"id":673},"agents-and-relay","Agents and Relay",[209,676,677,681,682,685,686,689],{},[678,679,680],"a",{"href":96},"Relay"," targets Codex or Claude Code conversations: closed by default; ",[250,683,684],{},"--open"," targets only Codex on Windows, macOS, or Linux (pilot, with ",[250,687,688],{},"python3"," required on POSIX). Mission, a Relay option, uses closed conversations. Antigravity, OpenCode, Mistral Vibe and Ollama participate in Debate, Ask and Chat, not as Relay targets.",[209,691,692,693,696,697,700,701,704,705,709,710,713],{},"CLI agents run from the current directory. Defaults request read-only tools where available: Claude ",[250,694,695],{},"Read,Glob,Grep",", Codex ",[250,698,699],{},"--sandbox read-only",", Vibe ",[250,702,703],{},"read,grep",". OpenCode keeps its usual environment: configured plugins, MCP servers and permissions stay active, ",[706,707,708],"strong",{},"with no read-only access or neutralization promised",". Custom arguments remain under your control; migrations replace only exact old defaults. A recognized limit gives ",[250,711,712],{},"usage-limit",", without automatic resend.",[226,715,717],{"id":716},"windows","Windows",[209,719,720,721,724,725,728],{},"Adapters prefer a native executable, then a recognized npm or pnpm shim launched directly (Node + JavaScript script, or the native npm variant). For pnpm, the shim's ",[250,722,723],{},"NODE_PATH"," is passed through. Other shims may use PowerShell; remaining shell wrappers are refused for an argument prompt. ",[250,726,727],{},"shell: true"," in generated configuration enables this conservative resolution; do not remove it to force a wrapper launch. Relay accepts only direct executables and the npm Node + script form.",[209,730,731,734,735,253,738,741],{},[250,732,733],{},"tier"," (",[250,736,737],{},"primary",[250,739,740],{},"local",") classifies the configured agent; it does not change its role instruction.",[743,744,745],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":5,"searchDepth":274,"depth":285,"links":747},[748,749,750,751,752,753,754,755],{"id":228,"depth":285,"text":229},{"id":241,"depth":285,"text":242},{"id":260,"depth":285,"text":261},{"id":314,"depth":285,"text":315},{"id":403,"depth":285,"text":404},{"id":655,"depth":285,"text":656},{"id":673,"depth":285,"text":674},{"id":716,"depth":285,"text":717},"Understand Palabre agents, their roles, their models, and the difference between external CLIs and local agents.","md",null,{},true,{"title":762,"description":763},"Supported AI agents and how roles work","Claude Code, Codex, OpenCode, Mistral Vibe, Antigravity, and Ollama can all join a session. Compare CLI agents and local agents.","rmY5zaUb8wmUQxAnMHXgdbykWj3Vam6xsydkDowdLq8",[766,768],{"title":43,"path":44,"stem":45,"description":767,"children":-1},"Resume a project with Relay on another machine, including a previously used one, without transferring approvals or local conversations.",{"title":57,"path":58,"stem":59,"description":769,"children":-1},"Configure Claude Code in Palabre and understand what Palabre passes to the Claude CLI.",1793816474516]