[{"data":1,"prerenderedAt":568},["ShallowReactive",2],{"navigation-en":3,"\u002Fen\u002Fusage\u002Fcontext-and-files":203,"\u002Fen\u002Fusage\u002Fcontext-and-files-surround":563},[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":111,"body":205,"description":554,"extension":555,"links":556,"meta":557,"navigation":558,"path":112,"seo":559,"stem":113,"__hash__":562},"docs\u002Fen\u002F3.usage\u002F07.context-and-files.md",{"type":206,"value":207,"toc":543},"minimark",[208,212,217,257,265,269,309,315,319,346,363,367,370,378,391,395,418,424,428,431,434,458,462,487,490,494,519,526,539],[209,210,211],"p",{},"Palabre can send project context to agents. This is essential for requesting a critique of code, architecture, or documentation.",[213,214,216],"h2",{"id":215},"two-modes","Two modes",[218,219,220,232],"table",{},[221,222,223],"thead",{},[224,225,226,230],"tr",{},[227,228,229],"th",{},"Option",[227,231,81],{},[233,234,235,247],"tbody",{},[224,236,237,244],{},[238,239,240],"td",{},[241,242,243],"code",{},"--files",[238,245,246],{},"You explicitly choose the files. An invalid path stops the command.",[224,248,249,254],{},[238,250,251],{},[241,252,253],{},"--context",[238,255,256],{},"Palabre scans text files or folders with limits and exclusions.",[209,258,259,261,262,264],{},[241,260,243],{}," is strict: a binary file, folder, or invalid path stops the session. ",[241,263,253],{}," is tolerant: it walks folders, ignores files it cannot retain, and reports warnings without cancelling the session. Both options share the limits described under “Scope and exclusions”.",[213,266,268],{"id":267},"explicit-files","Explicit files",[270,271,275],"pre",{"className":272,"code":273,"language":274,"meta":5,"style":5},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","palabre codex-claude \"Review this module\" --files src\u002Fauth.ts README.md\n","bash",[241,276,277],{"__ignoreMap":5},[278,279,282,286,290,294,297,300,303,306],"span",{"class":280,"line":281},"line",1,[278,283,285],{"class":284},"sBMFI","palabre",[278,287,289],{"class":288},"sfazB"," codex-claude",[278,291,293],{"class":292},"sMK4o"," \"",[278,295,296],{"class":288},"Review this module",[278,298,299],{"class":292},"\"",[278,301,302],{"class":288}," --files",[278,304,305],{"class":288}," src\u002Fauth.ts",[278,307,308],{"class":288}," README.md\n",[209,310,311,312,314],{},"Use ",[241,313,243],{}," when you know exactly which files should be sent.",[213,316,318],{"id":317},"context-scan","Context scan",[270,320,322],{"className":272,"code":321,"language":274,"meta":5,"style":5},"palabre codex-claude \"Critique this architecture\" --context src docs\n",[241,323,324],{"__ignoreMap":5},[278,325,326,328,330,332,335,337,340,343],{"class":280,"line":281},[278,327,285],{"class":284},[278,329,289],{"class":288},[278,331,293],{"class":292},[278,333,334],{"class":288},"Critique this architecture",[278,336,299],{"class":292},[278,338,339],{"class":288}," --context",[278,341,342],{"class":288}," src",[278,344,345],{"class":288}," docs\n",[209,347,348,350,351,354,355,358,359,362],{},[241,349,253],{}," ignores common technical folders such as ",[241,352,353],{},".git",", ",[241,356,357],{},"node_modules",", and ",[241,360,361],{},"dist",". It keeps known text files and displays warnings for ignored files, unsupported extensions, oversized files, and missing paths. These warnings do not stop the session.",[213,364,366],{"id":365},"from-the-tui-home","From the TUI home",[209,368,369],{},"The same options work directly in the home composer, at the end of the subject:",[270,371,376],{"className":372,"code":374,"language":375,"meta":5},[373],"language-text","Critique this architecture --context src docs\n","text",[241,377,374],{"__ignoreMap":5},[209,379,380,381,383,384,386,387,390],{},"Palabre strips ",[241,382,253],{}," and ",[241,385,243],{}," from the subject and injects the matching files. Paths containing spaces are not supported in this inline syntax: use the regular command line in that case. The session header confirms the number of injected files on the ",[241,388,389],{},"Context"," line.",[213,392,394],{"id":393},"preview-the-scan-as-json","Preview the scan as JSON",[270,396,398],{"className":272,"code":397,"language":274,"meta":5,"style":5},"palabre context scan src docs --json\n",[241,399,400],{"__ignoreMap":5},[278,401,402,404,407,410,412,415],{"class":280,"line":281},[278,403,285],{"class":284},[278,405,406],{"class":288}," context",[278,408,409],{"class":288}," scan",[278,411,342],{"class":288},[278,413,414],{"class":288}," docs",[278,416,417],{"class":288}," --json\n",[209,419,420,421,423],{},"This command exposes the same scan as ",[241,422,253],{},", without starting a session. It returns versioned JSON with the scanned root, requested paths, retained folders and files, and warnings. Integrations such as the VS Code extension should use this command instead of reimplementing exclusion or limit rules.",[213,425,427],{"id":426},"ollama-and-files","Ollama and files",[209,429,430],{},"Ollama does not read the filesystem on its own. It only receives the prompt built by Palabre.",[209,432,433],{},"If an Ollama agent takes part in a session about your project, explicitly add context:",[270,435,437],{"className":272,"code":436,"language":274,"meta":5,"style":5},"palabre codex-ollama \"Critique this module\" --context src\n",[241,438,439],{"__ignoreMap":5},[278,440,441,443,446,448,451,453,455],{"class":280,"line":281},[278,442,285],{"class":284},[278,444,445],{"class":288}," codex-ollama",[278,447,293],{"class":292},[278,449,450],{"class":288},"Critique this module",[278,452,299],{"class":292},[278,454,339],{"class":288},[278,456,457],{"class":288}," src\n",[213,459,461],{"id":460},"view-the-prompt-being-sent","View the prompt being sent",[270,463,465],{"className":272,"code":464,"language":274,"meta":5,"style":5},"palabre codex-claude \"Subject\" --context src --show-prompt\n",[241,466,467],{"__ignoreMap":5},[278,468,469,471,473,475,478,480,482,484],{"class":280,"line":281},[278,470,285],{"class":284},[278,472,289],{"class":288},[278,474,293],{"class":292},[278,476,477],{"class":288},"Subject",[278,479,299],{"class":292},[278,481,339],{"class":288},[278,483,342],{"class":288},[278,485,486],{"class":288}," --show-prompt\n",[209,488,489],{},"This command does not launch any agent. It lets you verify what Palabre will send on the first turn.",[213,491,493],{"id":492},"scope-and-exclusions","Scope and exclusions",[209,495,496,383,498,500,501,503,504,383,507,510,511,514,515,518],{},[241,497,243],{},[241,499,253],{}," share a 64 KiB per-file and 192 KiB total budget; explicit files load first. ",[241,502,253],{}," skips oversized, binary or over-budget files with a warning. Scanning also excludes ",[241,505,506],{},".tmp",[241,508,509],{},".pnpm-store"," and reads simple root ",[241,512,513],{},".gitignore"," rules; ",[241,516,517],{},"!"," negations are unsupported.",[209,520,521,522,525],{},"CLI agents run from the current directory and may read the project with their own tools, according to their configuration. Injected files are marked as untrusted data; these limits are not confinement. Ollama does not read files itself; PALABRE warns if it participates without context. In Ask, ",[241,523,524],{},"--show-prompt"," shows the first agent’s prompt.",[209,527,528,529,531,532,534,535,538],{},"Relay accepts neither ",[241,530,243],{}," nor ",[241,533,253],{},": the target retains its context. Use ",[241,536,537],{},"--message-file"," for a long message.",[540,541,542],"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 pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}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);}",{"title":5,"searchDepth":281,"depth":544,"links":545},2,[546,547,548,549,550,551,552,553],{"id":215,"depth":544,"text":216},{"id":267,"depth":544,"text":268},{"id":317,"depth":544,"text":318},{"id":365,"depth":544,"text":366},{"id":393,"depth":544,"text":394},{"id":426,"depth":544,"text":427},{"id":460,"depth":544,"text":461},{"id":492,"depth":544,"text":493},"Add context to a session with --files or --context while keeping control over the data transmitted.","md",null,{},true,{"title":560,"description":561},"Feed your codebase to the agents","Pass source files to a session with --files or --context, and keep control over exactly what gets transmitted.","N9-XDqdOKg2sILf0-0cYFOpAM-uNwZEOZMuVeeK9cjY",[564,566],{"title":107,"path":108,"stem":109,"description":565,"children":-1},"Understand the TUI home screen, choose modes, and configure a session without memorizing CLI options.",{"title":115,"path":116,"stem":117,"description":567,"children":-1},"Understand the final summary, choose the summary agent, and disable the summary if needed.",1793816476853]