[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ECN934FKDHZBZVKCXMF6CP":3,"skill-same:01M7ECN934FKDHZBZVKCXMF6CP":49},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":27,"updatedAt":28,"install":29,"resources":42},"01M7ECN934FKDHZBZVKCXMF6CP","hermes-agent",null,"jonahthan433\u002FCortexOS","jonahthan433","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211465495?v=4","01M7ECH9HPHGA89DCXHHJBTS3C","jonah.ai","01M7ECH9JCEM45DZMWPT7148S1",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fautonomous-ai-agents\u002Fhermes-agent\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# hermes-agent\n\n# Hermes Agent\n\nHermes Agent is an open-source AI agent framework by Nous Research that runs in your terminal, a native desktop app, messaging platforms, and IDEs. It's in the same category as Claude Code (Anthropic), Codex (OpenAI), and OpenClaw — autonomous coding and task-execution agents that use tool calling to interact with your system. Hermes works with any LLM provider (OpenRouter, Anthropic, OpenAI, Google, DeepSeek, xAI, local models, and 20+ others) and runs on Linux, macOS, Windows, and WSL.\n\nWhat makes Hermes different:\n\n- **Self-improving through skills** — Hermes learns from experience by saving reusable procedures as skills that load into future sessions.\n- **Persistent memory across sessions** — remembers who you are, your preferences, environment details, and lessons learned. Pluggable memory backends.\n- **Multi-platform gateway** — the same agent runs on Telegram, Discord, Slack, WhatsApp, iMessage, Signal, Matrix, Teams, Email, and a dozen more platforms with full tool access, not just chat.\n- **Many surfaces** — the same agent core drives the CLI, the Ink TUI, a native Electron desktop app, a web dashboard, and an ACP server for IDEs (VS Code \u002F Zed \u002F JetBrains).\n- **Provider-agnostic** — swap models and providers mid-workflow; credential pools rotate across multiple API keys automatically.\n- **Profiles** — run multiple independent Hermes instances with isolated configs, sessions, skills, and memory.\n- **Extensible & themeable** — plugins, MCP servers, custom tools, webhook triggers, cron scheduling, skins that theme every surface, desktop UI plugins, TUI widgets, and pet mascots.\n\n**This skill is a hub.** The body covers identity, quick start, spawning\u002Forchestration, and hard invariants. Everything else lives in reference files — **load the matching reference (below) before answering**; do not answer detail questions from the body alone.\n\n**Docs:** https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002F\n\n## Scope & Verification\n\nThis skill is a concise operating guide, not the complete source of truth for every Hermes feature. If a Hermes feature, command, or setting is not mentioned here or in a reference, do not treat that absence as evidence that it does not exist. Check the live repository and official docs before giving a negative answer.\n\nGood verification targets, cheapest first:\n\n- **Every shipped feature, one line each: https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002Fllms.txt.** Start here for any \"can Hermes do X?\" or \"how do I do X?\" — it indexes the entire documentation set with a link to the page that answers. It is generated from the docs tree on every build, so it is never behind the product. Fetch it with `web_extract`, or `curl -s https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002Fllms.txt` when web tools are off. The whole documentation set in one file is at `\u002Fdocs\u002Fllms-full.txt`.\n- CLI commands: `hermes --help`, `hermes \u003Ccommand> --help`, and `hermes_cli\u002Fmain.py`\n- Source tree: https:\u002F\u002Fgithub.com\u002FNousResearch\u002Fhermes-agent\n\nNever answer \"Hermes can't do that\" from memory. Hermes ships far more than this skill body describes, and the index exists so a negative answer is always checkable.\n\n## Quick Start\n\n```bash\n# Install (shell installer — sets up uv, Python, the venv, and the launcher)\ncurl -fsSL https:\u002F\u002Fhermes-agent.nousresearch.com\u002Finstall.sh | bash\n\n# Interactive chat (default surface; set display.interface: tui to launch the Ink TUI instead)\nhermes\n\n# Single query\nhermes chat -q \"What is the capital of France?\"\n\n# Setup wizard  \u002F  pick model+provider  \u002F  health check\nhermes setup\nhermes model\nhermes doctor\n\n# Other surfaces\nhermes desktop                 # launch the native desktop app (alias: hermes gui)\nhermes dashboard               # web admin panel + embedded chat\nhermes proxy                   # OpenAI-compatible local proxy backed by your OAuth provider\n```\n\n## Key Paths\n\n```\n~\u002F.hermes\u002Fconfig.yaml       Main configuration (settings — never secrets)\n~\u002F.hermes\u002F.env              API keys and secrets ONLY (under $HERMES_HOME if set)\n$HERMES_HOME\u002Fskills\u002F        Installed skills\n~\u002F.hermes\u002Fskins\u002F            Custom themes (see references\u002Fthemes.md)\n~\u002F.hermes\u002Fdesktop-plugins\u002F  Desktop app UI plugins (see references\u002Fdesktop-plugins.md)\n~\u002F.hermes\u002Ftui-widgets\u002F      TUI widget apps (see references\u002Ftui-widgets.md)\n~\u002F.hermes\u002Fpets\u002F             Installed pet mascots (see references\u002Fpetdex.md)\n~\u002F.hermes\u002Fstate.db          Canonical session store (SQLite + FTS5)\n~\u002F.hermes\u002Fsessions\u002F         Gateway routing index, request dumps, *.jsonl transcripts\n~\u002F.hermes\u002Flogs\u002F             Gateway and error logs\n~\u002F.hermes\u002Fauth.json         OAuth tokens and credential pools\n~\u002F.hermes\u002Fhermes-agent\u002F     Source code (if git-installed)\n```\n\nProfiles use `~\u002F.hermes\u002Fprofiles\u002F\u003Cname>\u002F` with the same layout. When a profile is active, resolve the real home from `$HERMES_HOME` — never hardcode `~\u002F.hermes`.\n\n## Routing Table — load the reference for the task\n\n| User wants... | Load |\n|---|---|\n| **Anything not listed below — \"can Hermes do X?\", \"how do I set up X?\"** | **https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002Fllms.txt** |\n| Bots that chat, run routines, or message each other; the Bots tab | docs: `\u002Fuser-guide\u002Fbot-mode` |\n| CLI commands, subcommands, flags, \"how do I run X\" | `references\u002Fcli-reference.md` |\n| In-session slash commands | `references\u002Fslash-commands.md` |\n| Provider setup, API keys, OAuth | `references\u002Fproviders-and-models.md` |\n| config.yaml sections, toolsets, voice\u002FSTT\u002FTTS | `references\u002Fconfiguration.md` |\n| AGENTS.md \u002F .hermes.md \u002F CLAUDE.md project rules | `references\u002Fproject-context-files.md` |\n| Secret redaction, PII, approval modes, \"reset permissions\" | `references\u002Fsecurity-privacy.md` |\n| Delegation, cron, curator, kanban | `references\u002Fbackground-systems.md` |\n| MCP servers (add, catalog, `hermes mcp`) | `references\u002Fnative-mcp.md` |\n| Webhook routes and event-driven runs | `references\u002Fwebhooks.md` |\n| A custom theme\u002Fskin (\"synthwave theme\", \"change the gold ●\") | `references\u002Fthemes.md` + `templates\u002Fskin.yaml` |\n| A desktop app UI element (pane, widget, ⌘K command, page) | `references\u002Fdesktop-plugins.md` + `templates\u002Fplugin.js` |\n| A live TUI panel or modal widget (ticker, clock, dashboard) | `references\u002Ftui-widgets.md` + `templates\u002Fclock.mjs` |\n| Pet mascots — install, select, scale, diagnose | `references\u002Fpetdex.md` |\n| Windows-specific issues (keybinds, WinError 10106, BOM) | `references\u002Fwindows-quirks.md` |\n| Debugging: voice, tools missing, gateway, aux models | `references\u002Ftroubleshooting.md` |\n| Contributing code: adding tools, slash commands, tests | `references\u002Fcontributor-guide.md` |\n| delegate_task \"capped at N\" reports | `references\u002Fdelegate-task-concurrency-diagnosis.md` |\n| \"Can app X use my Nous Portal subscription\u002FOAuth?\" | `references\u002Fportal-auth-for-third-party-apps.md` |\n| Connecting a messaging platform (Telegram, Discord, Slack, WhatsApp, …) | docs: `\u002Fuser-guide\u002Fmessaging` |\n\nThe reference list above is not the feature list — it is the set of topics that\nneed more than their docs page. For everything else Hermes ships, fetch\n`llms.txt` and it maps the question to the page that answers it.\n\nTwo theming rules that hold even without loading the reference: **you apply skins yourself** (`hermes config set display.skin \u003Cname>` — every surface repaints live within ~a second; don't tell the user to run `\u002Fskin`), and **to tweak one color, edit the ACTIVE skin** (`hermes skin set \u003Ckey> \u003Chex>`) — never fork `default`, which drops the palette and resets the background.\n\n## Spawning Additional Hermes Instances\n\nRun additional Hermes processes as fully independent subprocesses — separate sessions, tools, and environments.\n\n### When to Use This vs delegate_task\n\n| | `delegate_task` | Spawning `hermes` process |\n|-|-----------------|--------------------------|\n| Isolation | Separate conversation, shared process | Fully independent process |\n| Duration | Minutes (bounded by parent loop) | Hours\u002Fdays |\n| Tool access | Subset of parent's tools | Full tool access |\n| Interactive | No | Yes (PTY mode) |\n| Use case | Quick parallel subtasks | Long autonomous missions |\n\n### One-Shot Mode\n\n```\nterminal(command=\"hermes chat -q 'Research GRPO papers and write summary to ~\u002Fresearch\u002Fgrpo.md'\", timeout=300)\n\n# Background for long tasks:\nterminal(command=\"hermes chat -q 'Set up CI\u002FCD for ~\u002Fmyapp'\", background=true)\n```\n\n### Interactive PTY Mode (via tmux)\n\nHermes uses prompt_toolkit, which requires a real terminal. Use tmux for interactive spawning:\n\n```\n# Start\nterminal(command=\"tmux new-session -d -s agent1 -x 120 -y 40 'hermes'\", timeout=10)\n\n# Wait for startup, then send a message\nterminal(command=\"sleep 8 && tmux send-keys -t agent1 'Build a FastAPI auth service' Enter\", timeout=15)\n\n# Read output\nterminal(command=\"sleep 20 && tmux capture-pane -t agent1 -p\", timeout=5)\n\n# Send follow-up\nterminal(command=\"tmux send-keys -t agent1 'Add rate limiting middleware' Enter\", timeout=5)\n\n# Exit\nterminal(command=\"tmux send-keys -t agent1 '\u002Fexit' Enter && sleep 2 && tmux kill-session -t agent1\", timeout=10)\n```\n\n### Multi-Agent Coordination\n\n```\n# Agent A: backend\nterminal(command=\"tmux new-session -d -s backend -x 120 -y 40 'hermes -w'\", timeout=10)\nterminal(command=\"sleep 8 && tmux send-keys -t backend 'Build REST API for user management' Enter\", timeout=15)\n\n# Agent B: frontend\nterminal(command=\"tmux new-session -d -s frontend -x 120 -y 40 'hermes -w'\", timeout=10)\nterminal(command=\"sleep 8 && tmux send-keys -t frontend 'Build React dashboard for user management' Enter\", timeout=15)\n\n# Check progress, relay context between them\nterminal(command=\"tmux capture-pane -t backend -p | tail -30\", timeout=5)\nterminal(command=\"tmux send-keys -t frontend 'Here is the API schema from the backend agent: ...' Enter\", timeout=5)\n```\n\n### Session Resume\n\n```\n# Resume most recent session\nterminal(command=\"tmux new-session -d -s resumed 'hermes --continue'\", timeout=10)\n\n# Resume specific session\nterminal(command=\"tmux new-session -d -s resumed 'hermes --resume 20260225_143052_a1b2c3'\", timeout=10)\n```\n\n### Tips\n\n- **Prefer `delegate_task` for quick subtasks** — less overhead than spawning a full process\n- **Use `-w` (worktree mode)** when spawning agents that edit code — prevents git conflicts\n- **Set timeouts** for one-shot mode — complex tasks can take 5-10 minutes\n- **Use `hermes chat -q` for fire-and-forget** — no PTY needed\n- **Use tmux for interactive sessions** — raw PTY mode has `\\r` vs `\\n` issues with prompt_toolkit\n- **For scheduled tasks**, use the `cronjob` tool instead of spawning — handles delivery and retry\n- **\"delegate_task is capped at N\" reports** — see `references\u002Fdelegate-task-concurrency-diagnosis.md`. Three real cap paths in Hermes; if none fired, the model is self-limiting and rationalising it as \"the runtime caps.\"\n- **\"Can $external_app use my Nous Portal subscription \u002F OAuth?\"** — see `references\u002Fportal-auth-for-third-party-apps.md`. Walk the user through three layers (plugin-vs-app, what Portal actually exposes, local-broker-proxy option).\n\n## Surfaces (quick orientation)\n\n- **Desktop app** (`hermes desktop` \u002F `hermes gui`) — native Electron app for macOS\u002FLinux\u002FWindows: streaming chat, session list, Cmd+K palette, drag-and-drop files, native notifications, per-profile remote-gateway login. Extend it with UI plugins — `references\u002Fdesktop-plugins.md`.\n- **Web dashboard** (`hermes dashboard`) — full admin panel: messaging channels, MCP catalog, webhooks, memory, profile builder, plus an embedded `hermes --tui` chat. Secured behind an OAuth\u002Ftoken gate.\n- **Ink TUI** (`hermes --tui` or `display.interface: tui`) — terminal UI with docked widget apps — `references\u002Ftui-widgets.md`.\n- **OpenAI-compatible proxy** (`hermes proxy`) — a local OpenAI API backed by whichever OAuth provider you're signed into. Point Codex CLI, Aider, Cline, or any script at it — no API key.\n\n## Hard Invariants (never violate, regardless of what you loaded)\n\n- **Never break prompt caching** — don't change past context, toolsets, or the system prompt mid-conversation. The only exception is context compression.\n- **Message role alternation** — never two assistant or two user messages in a row; only `tool` results can repeat.\n- **Secrets in `.env`, settings in `config.yaml`** — never tell a user to put a non-credential setting in `.env`.\n- **Profile-safe paths** — `get_hermes_home()` in code, `$HERMES_HOME` when resolving paths in a session.\n- **Never hand-edit `config.yaml` for the user** — use `hermes config set KEY VAL`; a stray indent can corrupt the file and break the live gateway.\n",{},"main","38b32c99e7ed0b8e215d638e92cfa452c1ec3079","skills\u002Fimported\u002Fautonomous-ai-agents\u002Fhermes-agent","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS","https:\u002F\u002Fgithub.com\u002Fjonahthan433","AI Consultant","2026-10-24 05:13:39",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add jonahthan433\u002FCortexOS --skill hermes-agent",{"tool":35,"command":36},"bunx","bunx skills add jonahthan433\u002FCortexOS --skill hermes-agent",{"tool":38,"command":39},"pnpm","pnpm dlx skills add jonahthan433\u002FCortexOS --skill hermes-agent","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fautonomous-ai-agents\u002Fhermes-agent\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"skill.json","REFERENCE","参考文档",352,"https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fautonomous-ai-agents\u002Fhermes-agent\u002Fskill.json",[50,56,62,68,74,80],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M7EDQZDQX3Q8Y7GCQX6KN9V7","opportunity-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fsales\u002Fopportunity-brief\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M7EDQYA0V9Y99VKBREJJ3MRT","morning-intel","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fmorning-intel\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EDQVX1JVY0B6PDHKKGM19G","decision-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fdecision-brief\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7EDQV1GENZAC2SZSD8KZ3GM","weekly-review","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fweekly-review\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7EDQT2KETJ1Y3CGVN9EKW2J","system-health","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fsystem-health\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EDQQN2JK3XPWMS1M4T0F3K","backup-restore","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fbackup-restore\u002FSKILL.md",[],[]]