[{"data":1,"prerenderedAt":639},["ShallowReactive",2],{"navigation_docs":3,"-guide-cli":104,"-guide-cli-surround":634},[4,48],{"title":5,"path":6,"stem":7,"children":8,"icon":47},"Guide","\u002Fguide","1.guide\u002F01.index",[9,11,15,19,23,27,31,35,39,43],{"title":10,"path":6,"stem":7},"Getting Started",{"title":12,"path":13,"stem":14},"Registry and paths","\u002Fguide\u002Fregistry","1.guide\u002F02.registry",{"title":16,"path":17,"stem":18},"Running another harness","\u002Fguide\u002Finvoke","1.guide\u002F03.invoke",{"title":20,"path":21,"stem":22},"MCP servers","\u002Fguide\u002Fmcp-servers","1.guide\u002F04.mcp-servers",{"title":24,"path":25,"stem":26},"Instructions files","\u002Fguide\u002Fagents-sync","1.guide\u002F05.agents-sync",{"title":28,"path":29,"stem":30},"CLI","\u002Fguide\u002Fcli","1.guide\u002F06.cli",{"title":32,"path":33,"stem":34},"Agents","\u002Fguide\u002Fagents","1.guide\u002F07.agents",{"title":36,"path":37,"stem":38},"Sessions","\u002Fguide\u002Fsessions","1.guide\u002F08.sessions",{"title":40,"path":41,"stem":42},"Custom harnesses","\u002Fguide\u002Fcustom","1.guide\u002F09.custom",{"title":44,"path":45,"stem":46},"Explorer","\u002Fguide\u002Fexplorer","1.guide\u002F10.explorer","i-solar-book-2-linear",{"title":49,"path":50,"stem":51,"children":52,"icon":103},"Harnesses","\u002Fharnesses","2.harnesses\u002F00.index",[53,55,59,63,67,71,75,79,83,87,91,95,99],{"title":54,"path":50,"stem":51},"Overview",{"title":56,"path":57,"stem":58},"Claude Code","\u002Fharnesses\u002Fclaude","2.harnesses\u002F01.claude",{"title":60,"path":61,"stem":62},"Codex CLI","\u002Fharnesses\u002Fcodex","2.harnesses\u002F02.codex",{"title":64,"path":65,"stem":66},"Gemini CLI","\u002Fharnesses\u002Fgemini","2.harnesses\u002F03.gemini",{"title":68,"path":69,"stem":70},"Antigravity CLI","\u002Fharnesses\u002Fantigravity","2.harnesses\u002F04.antigravity",{"title":72,"path":73,"stem":74},"Grok CLI","\u002Fharnesses\u002Fgrok","2.harnesses\u002F05.grok",{"title":76,"path":77,"stem":78},"OpenCode","\u002Fharnesses\u002Fopencode","2.harnesses\u002F06.opencode",{"title":80,"path":81,"stem":82},"Pi","\u002Fharnesses\u002Fpi","2.harnesses\u002F07.pi",{"title":84,"path":85,"stem":86},"OMP","\u002Fharnesses\u002Fomp","2.harnesses\u002F08.omp",{"title":88,"path":89,"stem":90},"Cursor","\u002Fharnesses\u002Fcursor","2.harnesses\u002F09.cursor",{"title":92,"path":93,"stem":94},"GitHub Copilot","\u002Fharnesses\u002Fgithub-copilot","2.harnesses\u002F10.github-copilot",{"title":96,"path":97,"stem":98},"Mastra Code","\u002Fharnesses\u002Fmastracode","2.harnesses\u002F11.mastracode",{"title":100,"path":101,"stem":102},"Freebuff","\u002Fharnesses\u002Ffreebuff","2.harnesses\u002F12.freebuff","i-solar-library-linear",{"id":105,"title":28,"body":106,"description":626,"extension":627,"links":628,"meta":629,"navigation":631,"path":29,"seo":632,"stem":30,"__hash__":633},"docs\u002F1.guide\u002F06.cli.md",{"type":107,"value":108,"toc":620},"minimark",[109,114,153,173,283,287,568,571,602,605,609,616],[110,111,113],"h2",{"id":112},"run-it","Run it",[115,116,121],"pre",{"className":117,"code":118,"language":119,"meta":120,"style":120},"language-bash shiki shiki-themes github-light github-light poimandres","pnpm add -g @agntn\u002Fharnesses\nharnesses detect\n","bash","",[122,123,124,144],"code",{"__ignoreMap":120},[125,126,129,133,137,141],"span",{"class":127,"line":128},"line",1,[125,130,132],{"class":131},"sseY5","pnpm",[125,134,136],{"class":135},"sX7Zv"," add",[125,138,140],{"class":139},"sqT1Y"," -g",[125,142,143],{"class":135}," @agntn\u002Fharnesses\n",[125,145,147,150],{"class":127,"line":146},2,[125,148,149],{"class":131},"harnesses",[125,151,152],{"class":135}," detect\n",[154,155,156,157,160,161,164,165,172],"p",{},"Every command that prints data takes ",[122,158,159],{},"--json",", and ",[122,162,163],{},"--toon"," for the ",[166,167,171],"a",{"href":168,"rel":169},"https:\u002F\u002Fgithub.com\u002Ftoon-format\u002Ftoon",[170],"nofollow","TOON"," encoding that fits a model context better. Without either you get a coloured listing.",[174,175,176,189],"table",{},[177,178,179],"thead",{},[180,181,182,186],"tr",{},[183,184,185],"th",{},"Command",[183,187,188],{},"Description",[190,191,192,203,213,223,233,243,253,263,273],"tbody",{},[180,193,194,200],{},[195,196,197],"td",{},[122,198,199],{},"harnesses list",[195,201,202],{},"Every known harness, id and name",[180,204,205,210],{},[195,206,207],{},[122,208,209],{},"harnesses detect",[195,211,212],{},"Which ones are installed, with versions",[180,214,215,220],{},[195,216,217],{},[122,218,219],{},"harnesses info \u003Cid>",[195,221,222],{},"The registry entry: capabilities, modes, every path with scope and level",[180,224,225,230],{},[195,226,227],{},[122,228,229],{},"harnesses paths \u003Cid>",[195,231,232],{},"Paths resolved for this platform and home directory",[180,234,235,240],{},[195,236,237],{},[122,238,239],{},"harnesses models \u003Cid> [search]",[195,241,242],{},"Models the harness can use, through its native listing",[180,244,245,250],{},[195,246,247],{},[122,248,249],{},"harnesses run \u003Cid> \u003Cprompt>",[195,251,252],{},"One prompt through the harness's headless mode",[180,254,255,260],{},[195,256,257],{},[122,258,259],{},"harnesses mcp-servers list|add|remove|sync",[195,261,262],{},"MCP servers across the config dialects",[180,264,265,270],{},[195,266,267],{},[122,268,269],{},"harnesses agents sync [--check]",[195,271,272],{},"Link global instructions files to one master",[180,274,275,280],{},[195,276,277],{},[122,278,279],{},"harnesses mcp",[195,281,282],{},"The MCP server over stdio",[110,284,286],{"id":285},"examples","Examples",[115,288,290],{"className":117,"code":289,"language":119,"meta":120,"style":120},"harnesses info claude                      # metadata, including supported invocation modes\nharnesses info codex --json\nharnesses paths gemini --toon\nharnesses models pi                        # what Pi has credentials for\nharnesses models pi gpt-5.4 --json\nharnesses run claude \"review this design\"  # advisor without tools, the default\nharnesses run pi --model openai-codex\u002Fgpt-5.4 \"review this design\"\nharnesses run claude --tools \"fix lint\"    # full agent\nharnesses run codex --read-only \"review\"   # tools inside a native read-only sandbox\nharnesses run omp --json \"summarize\"       # structured output\nharnesses mcp-servers list\nharnesses mcp-servers add omp probe --command node --args \"srv.mjs mcp\" --env \"DEBUG=1\"\nharnesses mcp-servers remove omp probe --scope project\nharnesses mcp-servers sync\nharnesses agents sync --check\n",[122,291,292,306,318,332,346,360,384,406,428,450,473,484,524,544,554],{"__ignoreMap":120},[125,293,294,296,299,302],{"class":127,"line":128},[125,295,149],{"class":131},[125,297,298],{"class":135}," info",[125,300,301],{"class":135}," claude",[125,303,305],{"class":304},"sjhu3","                      # metadata, including supported invocation modes\n",[125,307,308,310,312,315],{"class":127,"line":146},[125,309,149],{"class":131},[125,311,298],{"class":135},[125,313,314],{"class":135}," codex",[125,316,317],{"class":139}," --json\n",[125,319,321,323,326,329],{"class":127,"line":320},3,[125,322,149],{"class":131},[125,324,325],{"class":135}," paths",[125,327,328],{"class":135}," gemini",[125,330,331],{"class":139}," --toon\n",[125,333,335,337,340,343],{"class":127,"line":334},4,[125,336,149],{"class":131},[125,338,339],{"class":135}," models",[125,341,342],{"class":135}," pi",[125,344,345],{"class":304},"                        # what Pi has credentials for\n",[125,347,349,351,353,355,358],{"class":127,"line":348},5,[125,350,149],{"class":131},[125,352,339],{"class":135},[125,354,342],{"class":135},[125,356,357],{"class":135}," gpt-5.4",[125,359,317],{"class":139},[125,361,363,365,368,370,374,378,381],{"class":127,"line":362},6,[125,364,149],{"class":131},[125,366,367],{"class":135}," run",[125,369,301],{"class":135},[125,371,373],{"class":372},"scVjq"," \"",[125,375,377],{"class":376},"sQ7BG","review this design",[125,379,380],{"class":372},"\"",[125,382,383],{"class":304},"  # advisor without tools, the default\n",[125,385,387,389,391,393,396,399,401,403],{"class":127,"line":386},7,[125,388,149],{"class":131},[125,390,367],{"class":135},[125,392,342],{"class":135},[125,394,395],{"class":139}," --model",[125,397,398],{"class":135}," openai-codex\u002Fgpt-5.4",[125,400,373],{"class":372},[125,402,377],{"class":376},[125,404,405],{"class":372},"\"\n",[125,407,409,411,413,415,418,420,423,425],{"class":127,"line":408},8,[125,410,149],{"class":131},[125,412,367],{"class":135},[125,414,301],{"class":135},[125,416,417],{"class":139}," --tools",[125,419,373],{"class":372},[125,421,422],{"class":376},"fix lint",[125,424,380],{"class":372},[125,426,427],{"class":304},"    # full agent\n",[125,429,431,433,435,437,440,442,445,447],{"class":127,"line":430},9,[125,432,149],{"class":131},[125,434,367],{"class":135},[125,436,314],{"class":135},[125,438,439],{"class":139}," --read-only",[125,441,373],{"class":372},[125,443,444],{"class":376},"review",[125,446,380],{"class":372},[125,448,449],{"class":304},"   # tools inside a native read-only sandbox\n",[125,451,453,455,457,460,463,465,468,470],{"class":127,"line":452},10,[125,454,149],{"class":131},[125,456,367],{"class":135},[125,458,459],{"class":135}," omp",[125,461,462],{"class":139}," --json",[125,464,373],{"class":372},[125,466,467],{"class":376},"summarize",[125,469,380],{"class":372},[125,471,472],{"class":304},"       # structured output\n",[125,474,476,478,481],{"class":127,"line":475},11,[125,477,149],{"class":131},[125,479,480],{"class":135}," mcp-servers",[125,482,483],{"class":135}," list\n",[125,485,487,489,491,493,495,498,501,504,507,509,512,514,517,519,522],{"class":127,"line":486},12,[125,488,149],{"class":131},[125,490,480],{"class":135},[125,492,136],{"class":135},[125,494,459],{"class":135},[125,496,497],{"class":135}," probe",[125,499,500],{"class":139}," --command",[125,502,503],{"class":135}," node",[125,505,506],{"class":139}," --args",[125,508,373],{"class":372},[125,510,511],{"class":376},"srv.mjs mcp",[125,513,380],{"class":372},[125,515,516],{"class":139}," --env",[125,518,373],{"class":372},[125,520,521],{"class":376},"DEBUG=1",[125,523,405],{"class":372},[125,525,527,529,531,534,536,538,541],{"class":127,"line":526},13,[125,528,149],{"class":131},[125,530,480],{"class":135},[125,532,533],{"class":135}," remove",[125,535,459],{"class":135},[125,537,497],{"class":135},[125,539,540],{"class":139}," --scope",[125,542,543],{"class":135}," project\n",[125,545,547,549,551],{"class":127,"line":546},14,[125,548,149],{"class":131},[125,550,480],{"class":135},[125,552,553],{"class":135}," sync\n",[125,555,557,559,562,565],{"class":127,"line":556},15,[125,558,149],{"class":131},[125,560,561],{"class":135}," agents",[125,563,564],{"class":135}," sync",[125,566,567],{"class":139}," --check\n",[110,569,570],{"id":570},"run",[154,572,573,576,577,580,581,583,584,587,588,591,592,595,596,598,599,601],{},[122,574,575],{},"--tools"," and ",[122,578,579],{},"--read-only"," pick the mode, ",[122,582,159],{}," asks for the harness's structured output, ",[122,585,586],{},"--model"," a model id in the harness's own format, ",[122,589,590],{},"--cwd"," the working directory, ",[122,593,594],{},"--timeout"," a budget in seconds. ",[122,597,579],{}," implies ",[122,600,575],{},". A mode the harness cannot provide is rejected before anything runs, with the same message the library gives.",[154,603,604],{},"The harness's stdout and stderr pass through. Exit code is the harness's own; a timeout exits 124.",[110,606,608],{"id":607},"exit-codes","Exit codes",[154,610,611,612,615],{},"Unknown harness id, unsupported mode, invalid timeout: message on stderr, exit 1, no stack trace. A failed ",[122,613,614],{},"models"," call exits 1 with the harness's error. Everything else exits 0 with data.",[617,618,619],"style",{},"html pre.shiki code .sseY5, html code.shiki .sseY5{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#91B4D5}html pre.shiki code .sX7Zv, html code.shiki .sX7Zv{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#ADD7FF}html pre.shiki code .sqT1Y, html code.shiki .sqT1Y{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#ADD7FF}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 .sjhu3, html code.shiki .sjhu3{--shiki-light:#6A737D;--shiki-light-font-style:inherit;--shiki-default:#6A737D;--shiki-default-font-style:inherit;--shiki-dark:#767C9DB0;--shiki-dark-font-style:italic}html pre.shiki code .scVjq, html code.shiki .scVjq{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#A6ACCD}html pre.shiki code .sQ7BG, html code.shiki .sQ7BG{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#5DE4C7}",{"title":120,"searchDepth":146,"depth":146,"links":621},[622,623,624,625],{"id":112,"depth":146,"text":113},{"id":285,"depth":146,"text":286},{"id":570,"depth":146,"text":570},{"id":607,"depth":146,"text":608},"The harnesses command, nine subcommands, JSON and TOON output on all the read ones.","md",null,{"icon":630},"i-solar-code-square-linear",true,{"title":28,"description":626},"aSGhpuqE7eTsJdLXwgLQR3K2lt5E4946qxmo28kBKGk",[635,637],{"title":24,"path":25,"stem":26,"description":636,"children":-1},"One AGENTS.md behind every harness's global CLAUDE.md, GEMINI.md and AGENTS.md, as symlinks, with a doctor mode.",{"title":32,"path":33,"stem":34,"description":638,"children":-1},"The same nine tools over MCP, the Pi extension and the OMP extension. What they read, what they run, what they write.",1788622198893]