[{"data":1,"prerenderedAt":463},["ShallowReactive",2],{"navigation_docs":3,"-harnesses-hermes":124,"-harnesses-hermes-surround":460},[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-lucide-book-open",{"title":49,"path":50,"stem":51,"children":52,"icon":123},"Harnesses","\u002Fharnesses","2.harnesses\u002F00.index",[53,55,59,63,67,71,75,79,83,87,91,95,99,103,107,111,115,119],{"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",{"title":104,"path":105,"stem":106},"Prime Agent","\u002Fharnesses\u002Fprime-agent","2.harnesses\u002F13.prime-agent",{"title":108,"path":109,"stem":110},"OpenBot","\u002Fharnesses\u002Fopenbot","2.harnesses\u002F14.openbot",{"title":112,"path":113,"stem":114},"Kilo","\u002Fharnesses\u002Fkilo","2.harnesses\u002F15.kilo",{"title":116,"path":117,"stem":118},"Mistral Vibe","\u002Fharnesses\u002Fvibe","2.harnesses\u002F16.vibe",{"title":120,"path":121,"stem":122},"Hermes Agent","\u002Fharnesses\u002Fhermes","2.harnesses\u002F17.hermes","i-lucide-library",{"id":125,"title":120,"body":126,"description":453,"extension":454,"links":455,"meta":456,"navigation":457,"path":121,"seo":458,"stem":122,"__hash__":459},"docs\u002F2.harnesses\u002F17.hermes.md",{"type":127,"value":128,"toc":449},"minimark",[129,133,145,160,194,205,224,237,253,275,289,300,314,329,348,363,397,408,414,417,446],[130,131],"harness-facts",{"id":132},"hermes",[134,135,136,137,140,141,144],"p",{},"Hermes Agent is Nous Research's agent CLI, written in Python. The binary is ",[138,139,132],"code",{},", and ",[138,142,143],{},"hermes --version"," says which one you have.",[134,146,147,148,151,152,155,156,159],{},"Where does it keep everything? On Linux and macOS, it's ",[138,149,150],{},"~\u002F.hermes\u002F",". On Windows, it's ",[138,153,154],{},"%LOCALAPPDATA%\u002Fhermes",". Set ",[138,157,158],{},"HERMES_HOME"," to move the whole home.",[134,161,162,163,166,167,170,171,174,175,178,179,182,183,178,186,189,190,193],{},"Inside, ",[138,164,165],{},"config.yaml"," holds the model, toolsets, MCP servers and shell hooks. API keys go in ",[138,168,169],{},".env",". OAuth logins, including Nous Portal, go in ",[138,172,173],{},"auth.json",". Plugins live in ",[138,176,177],{},"plugins\u002F",", each with ",[138,180,181],{},"plugin.yaml"," and Python code. Gateway hooks live in ",[138,184,185],{},"hooks\u002F",[138,187,188],{},"HOOK.yaml"," and ",[138,191,192],{},"handler.py",".",[134,195,196,197,200,201,204],{},"Sessions share one SQLite database, ",[138,198,199],{},"state.db",", with full message history and an FTS5 search index. The ",[138,202,203],{},"sessions\u002F"," folder beside it holds gateway session JSON files and request dumps.",[134,206,207,208,211,212,215,216,219,220,223],{},"Which project instructions win? Hermes picks one file type per session. It checks ",[138,209,210],{},".hermes.md"," or ",[138,213,214],{},"HERMES.md"," first, up to the git root. Next comes ",[138,217,218],{},"AGENTS.override.md",", which replaces the ",[138,221,222],{},"AGENTS.md"," beside it.",[134,225,226,227,229,230,233,234,193],{},"Then comes ",[138,228,222],{},". Inside git, Hermes reads each one from the root down to the working directory. The deepest comes last. Outside git, it reads only the working directory's file. Finally, it checks ",[138,231,232],{},"CLAUDE.md",", then ",[138,235,236],{},".cursorrules",[134,238,239,242,243,245,246,140,249,252],{},[138,240,241],{},"SOUL.md"," in the home is the identity slot, and it always loads. An ",[138,244,222],{}," in the home, though? Hermes doesn't read one. So there's no ",[138,247,248],{},"agentsFile",[138,250,251],{},"agents sync"," skips Hermes.",[134,254,255,256,259,260,263,264,189,267,270,271,274],{},"Skills live in ",[138,257,258],{},"~\u002F.hermes\u002Fskills\u002F",". Config can add folders through ",[138,261,262],{},"skills.external_dirs",". Project skills in ",[138,265,266],{},".hermes\u002Fskills\u002F",[138,268,269],{},".agents\u002Fskills\u002F"," need ",[138,272,273],{},"hermes skills trust"," first.",[134,276,277,278,280,281,284,285,288],{},"Skills sync owns ",[138,279,258],{},". It also writes an empty ",[138,282,283],{},".no-bundled-skills"," into the Hermes home when it's missing. The report names the marker when it writes one. With ",[138,286,287],{},"--check",", it names the marker without writing.",[134,290,291,292,295,296,299],{},"That marker matters more than it looks. Without it, ",[138,293,294],{},"hermes update"," copies the whole bundled catalog into the folder, and after a sync that folder is your shared agntn skills folder. With it, Hermes seeds only its own ",[138,297,298],{},"hermes-agent"," skill. One skill moves in, not the whole library.",[134,301,302,303,306,307,309,310,313],{},"MCP servers sit under ",[138,304,305],{},"mcp_servers"," in ",[138,308,165],{},". The library has no YAML editor yet, so the registry lists no MCP config for Hermes, and ",[138,311,312],{},"mcp-servers sync"," skips it.",[134,315,316,317,320,321,324,325,328],{},"How does a run work? ",[138,318,319],{},"hermes --oneshot=\u003Cprompt>"," prints only the final answer. The prompt stays glued to ",[138,322,323],{},"--oneshot=",", so one that starts with a dash isn't read as a flag. For structured output, ",[138,326,327],{},"hermes chat --query=\u003Cprompt> --oneshot --format stream-json"," emits JSONL. Expect an init line, text deltas and a result with session ID and token counts.",[134,330,331,332,335,336,338,339,341,342,344,345,347],{},"Every library run adds ",[138,333,334],{},"--ignore-rules",". That leaves ",[138,337,222],{},", ",[138,340,241],{},", memory and preloaded skills out of the prompt. A live check planted a secret word in ",[138,343,222],{},", and it stayed out of the answer, ",[138,346,241],{}," too. The tools can still open those files from disk. It's a prompt boundary, not a wall.",[134,349,350,353,354,356,357,189,360,193],{},[138,351,352],{},"--ignore-user-config"," stays off on purpose. It drops the model from ",[138,355,165],{},", and then Hermes refuses to start without both ",[138,358,359],{},"--provider",[138,361,362],{},"--model",[134,364,365,366,369,370,373,374,377,378,381,382,385,386,389,390,393,394,193],{},"The library sends ",[138,367,368],{},"model"," through ",[138,371,372],{},"-m",". It accepts ",[138,375,376],{},"provider:model",", such as ",[138,379,380],{},"openrouter:anthropic\u002Fclaude-sonnet-4",". A bare id goes to the configured provider. There's no model listing to run, so ",[138,383,384],{},"listModels"," refuses with that hint instead. ",[138,387,388],{},"effort"," goes to ",[138,391,392],{},"--reasoning",". Unknown values fail with ",[138,395,396],{},"invalid_params",[134,398,399,400,403,404,407],{},"One-shot runs skip approval prompts. That's the full agent, with every tool. There's no read-only or advisor mode. ",[138,401,402],{},"-t none"," fails, and a single toolset doesn't help, because tool search still reaches the rest. The library refuses ",[138,405,406],{},"readOnly"," and advisor requests before spawning.",[134,409,410,411,413],{},"What happens at a deadline? Less than you'd hope. The ",[138,412,132],{}," process the library spawns is only a client. Each one-shot goes through the profile's gateway, which Hermes starts on demand. Killing the client detaches it, and the turn keeps running.",[134,415,416],{},"Fitting for a messenger. It drops the message off and doesn't wait for the reply. In a live check, a turn slept for 25 seconds and then wrote a file, though its client was killed at 12. Your environment variables reach the client too, not the tools the turn runs.",[134,418,419,420,189,423,426,427,430,431,434,435,338,438,189,440,442,443,193],{},"Hermes exports ",[138,421,422],{},"HERMES_AGENT=true",[138,424,425],{},"AI_AGENT=hermes-agent"," to commands it runs. ",[138,428,429],{},"detectHarness"," reads ",[138,432,433],{},"HERMES_AGENT",", and it checks Hermes near the end, so Claude running inside Hermes is still Claude. Project markers are ",[138,436,437],{},".hermes",[138,439,210],{},[138,441,214],{},". Audio and video aren't verified, so both are ",[138,444,445],{},"false",[447,448],"harness-sheet",{"id":132},{"title":450,"searchDepth":451,"depth":451,"links":452},"",2,[],"Nous Research's agent. Everything under ~\u002F.hermes, sessions in one SQLite database. And one-shots that outlive their deadline.","md",null,{},true,{"title":120,"description":453},"8MaHcQobgk52T8uDFYLcyIWYHfvjVbBj2ybVQiDoVFE",[461,455],{"title":116,"path":117,"stem":118,"description":462,"children":-1},"Mistral's CLI. Everything under ~\u002F.vibe and trust per folder. MCP servers as TOML tables and a read-only mode down to read_file.",1795201608496]