mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-05-02 00:41:43 +08:00

Files

Teknium 289cc47631 docs: resync reference, user-guide, developer-guide, and messaging pages against code (#17738 )

Broad drift audit against origin/main (b52b63396).

Reference pages (most user-visible drift):
- slash-commands: add /busy, /curator, /footer, /indicator, /redraw, /steer
  that were missing; drop non-existent /terminal-setup; fix /q footnote
  (resolves to /queue, not /quit); extend CLI-only list with all 24
  CLI-only commands in the registry
- cli-commands: add dedicated sections for hermes curator / fallback /
  hooks (new subcommands not previously documented); remove stale
  hermes honcho standalone section (the plugin registers dynamically
  via hermes memory); list curator/fallback/hooks in top-level table;
  fix completion to include fish
- toolsets-reference: document the real 52-toolset count; split browser
  vs browser-cdp; add discord / discord_admin / spotify / yuanbao;
  correct hermes-cli tool count from 36 to 38; fix misleading claim
  that hermes-homeassistant adds tools (it's identical to hermes-cli)
- tools-reference: bump tool count 55 -> 68; add 7 Spotify, 5 Yuanbao,
  2 Discord toolsets; move browser_cdp/browser_dialog to their own
  browser-cdp toolset section
- environment-variables: add 40+ user-facing HERMES_* vars that were
  undocumented (--yolo, --accept-hooks, --ignore-*, inference model
  override, agent/stream/checkpoint timeouts, OAuth trace, per-platform
  batch tuning for Telegram/Discord/Matrix/Feishu/WeCom, cron knobs,
  gateway restart/connect timeouts); dedupe the Cron Scheduler section;
  replace stale QQ_SANDBOX with QQ_PORTAL_HOST

User-guide (top level):
- cli.md: compression preserves last 20 turns, not 4 (protect_last_n: 20)
- configuration.md: display.platforms is the canonical per-platform
  override key; tool_progress_overrides is deprecated and auto-migrated
- profiles.md: model.default is the config key, not model.model
- sessions.md: CLI/TUI session IDs use 6-char hex, gateway uses 8
- checkpoints-and-rollback.md: destructive-command list now matches
  _DESTRUCTIVE_PATTERNS (adds rmdir, cp, install, dd)
- docker.md: the container runs as non-root hermes (UID 10000) via
  gosu; fix install command (uv pip); add missing --insecure on the
  dashboard compose example (required for non-loopback bind)
- security.md: systemctl danger pattern also matches 'restart'
- index.md: built-in tool count 47 -> 68
- integrations/index.md: 6 STT providers, 8 memory providers
- integrations/providers.md: drop fictional dashscope/qwen aliases

Features:
- overview.md: 9 image models (not 8), 9 TTS providers (not 5),
  8 memory providers (Supermemory was missing)
- tool-gateway.md: 9 image models
- tools.md: extend common-toolsets list with search / messaging /
  spotify / discord / debugging / safe
- fallback-providers.md: add 6 real providers from PROVIDER_REGISTRY
  (lmstudio, kimi-coding-cn, stepfun, alibaba-coding-plan,
  tencent-tokenhub, azure-foundry)
- plugins.md: Available Hooks table now includes on_session_finalize,
  on_session_reset, subagent_stop
- built-in-plugins.md: add the 7 bundled plugins the page didn't
  mention (spotify, google_meet, three image_gen providers, two
  dashboard examples)
- web-dashboard.md: add --insecure and --tui flags
- cron.md: hermes cron create takes positional schedule/prompt, not
  flags

Messaging:
- telegram.md: TELEGRAM_WEBHOOK_SECRET is now REQUIRED when
  TELEGRAM_WEBHOOK_URL is set (gateway refuses to start without it
  per GHSA-3vpc-7q5r-276h). Biggest user-visible drift in the batch.
- discord.md: HERMES_DISCORD_TEXT_BATCH_SPLIT_DELAY_SECONDS default
  is 2.0, not 0.1
- dingtalk.md: document DINGTALK_REQUIRE_MENTION /
  FREE_RESPONSE_CHATS / MENTION_PATTERNS / HOME_CHANNEL /
  ALLOW_ALL_USERS that the adapter supports
- bluebubbles.md: drop fictional BLUEBUBBLES_SEND_READ_RECEIPTS env
  var; the setting lives in platforms.bluebubbles.extra only
- qqbot.md: drop dead QQ_SANDBOX; add real QQ_PORTAL_HOST and
  QQ_GROUP_ALLOWED_USERS
- wecom-callback.md: replace 'hermes gateway start' (service-only)
  with 'hermes gateway' for first-time setup

Developer-guide:
- architecture.md: refresh tool/toolset counts (61/52), terminal
  backend count (7), line counts for run_agent.py (~13.7k), cli.py
  (~11.5k), main.py (~10.4k), setup.py (~3.5k), gateway/run.py
  (~12.2k), mcp_tool.py (~3.1k); add yuanbao adapter, bump platform
  adapter count 18 -> 20
- agent-loop.md: run_agent.py line count 10.7k -> 13.7k
- tools-runtime.md: add vercel_sandbox backend
- adding-tools.md: remove stale 'Discovery import added to
  model_tools.py' checklist item (registry auto-discovery)
- adding-platform-adapters.md: mark send_typing / get_chat_info as
  concrete base methods; only connect/disconnect/send are abstract
- acp-internals.md: ACP sessions now persist to SessionDB
  (~/.hermes/state.db); acp.run_agent call uses
  use_unstable_protocol=True
- cron-internals.md: gateway runs scheduler in a dedicated background
  thread via _start_cron_ticker, not on a maintenance cycle; locking
  is cross-process via fcntl.flock (Unix) / msvcrt.locking (Windows)
- gateway-internals.md: gateway/run.py ~12k lines
- provider-runtime.md: cron DOES support fallback (run_job reads
  fallback_providers from config)
- session-storage.md: SCHEMA_VERSION = 11 (not 9); add migrations
  10 and 11 (trigram FTS, inline-mode FTS5 re-index); add
  api_call_count column to Sessions DDL; document messages_fts_trigram
  and state_meta in the architecture tree
- context-compression-and-caching.md: remove the obsolete 'context
  pressure warnings' section (warnings were removed for causing
  models to give up early)
- context-engine-plugin.md: compress() signature now includes
  focus_topic param
- extending-the-cli.md: _build_tui_layout_children signature now
  includes model_picker_widget; add to default layout

Also fixed three pre-existing broken links/anchors the build warned
about (docker.md -> api-server.md, yuanbao.md -> cron-jobs.md and
tips#background-tasks, nix-setup.md -> #container-aware-cli).

Regenerated per-skill pages via website/scripts/generate-skill-docs.py
so catalog tables and sidebar are consistent with current SKILL.md
frontmatter.

docusaurus build: clean, no broken links or anchors.

2026-04-29 20:55:59 -07:00

18 KiB

Raw Blame History

sidebar_position, title, description

sidebar_position	title	description
5	Bundled Skills Catalog	Catalog of bundled skills that ship with Hermes Agent

Bundled Skills Catalog

Hermes ships with a large built-in skill library copied into ~/.hermes/skills/ on install. Each skill below links to a dedicated page with its full definition, setup, and usage.

If a skill is missing from this list but present in the repo, the catalog is regenerated by website/scripts/generate-skill-docs.py.

apple

Skill	Description	Path
`apple-notes`	Manage Apple Notes via memo CLI: create, search, edit.	`apple/apple-notes`
`apple-reminders`	Apple Reminders via remindctl: add, list, complete.	`apple/apple-reminders`
`findmy`	Track Apple devices/AirTags via FindMy.app on macOS.	`apple/findmy`
`imessage`	Send and receive iMessages/SMS via the imsg CLI on macOS.	`apple/imessage`

autonomous-ai-agents

Skill	Description	Path
`claude-code`	Delegate coding to Claude Code CLI (features, PRs).	`autonomous-ai-agents/claude-code`
`codex`	Delegate coding to OpenAI Codex CLI (features, PRs).	`autonomous-ai-agents/codex`
`hermes-agent`	Configure, extend, or contribute to Hermes Agent.	`autonomous-ai-agents/hermes-agent`
`opencode`	Delegate coding to OpenCode CLI (features, PR review).	`autonomous-ai-agents/opencode`

creative

Skill	Description	Path
`architecture-diagram`	Dark-themed SVG architecture/cloud/infra diagrams as HTML.	`creative/architecture-diagram`
`ascii-art`	ASCII art: pyfiglet, cowsay, boxes, image-to-ascii.	`creative/ascii-art`
`ascii-video`	ASCII video: convert video/audio to colored ASCII MP4/GIF.	`creative/ascii-video`
`baoyu-comic`	Knowledge comics (知识漫画): educational, biography, tutorial.	`creative/baoyu-comic`
`baoyu-infographic`	Infographics: 21 layouts x 21 styles (信息图, 可视化).	`creative/baoyu-infographic`
`claude-design`	Design one-off HTML artifacts (landing, deck, prototype).	`creative/claude-design`
`comfyui`	Generate images, video, and audio with ComfyUI — install, launch, manage nodes/models, run workflows with parameter injection. Uses the official comfy-cli for lifecycle and direct REST API for execution.	`creative/comfyui`
`ideation`	Generate project ideas via creative constraints.	`creative/creative-ideation`
`design-md`	Author/validate/export Google's DESIGN.md token spec files.	`creative/design-md`
`excalidraw`	Hand-drawn Excalidraw JSON diagrams (arch, flow, seq).	`creative/excalidraw`
`humanizer`	Humanize text: strip AI-isms and add real voice.	`creative/humanizer`
`manim-video`	Manim CE animations: 3Blue1Brown math/algo videos.	`creative/manim-video`
`p5js`	p5.js sketches: gen art, shaders, interactive, 3D.	`creative/p5js`
`pixel-art`	Pixel art w/ era palettes (NES, Game Boy, PICO-8).	`creative/pixel-art`
`popular-web-designs`	54 real design systems (Stripe, Linear, Vercel) as HTML/CSS.	`creative/popular-web-designs`
`pretext`	Use when building creative browser demos with @chenglou/pretext — DOM-free text layout for ASCII art, typographic flow around obstacles, text-as-geometry games, kinetic typography, and text-powered generative art. Produces single-file HT...	`creative/pretext`
`sketch`	Throwaway HTML mockups: 2-3 design variants to compare.	`creative/sketch`
`songwriting-and-ai-music`	Songwriting craft and Suno AI music prompts.	`creative/songwriting-and-ai-music`
`touchdesigner-mcp`	Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.	`creative/touchdesigner-mcp`

data-science

Skill	Description	Path
`jupyter-live-kernel`	Iterative Python via live Jupyter kernel (hamelnb).	`data-science/jupyter-live-kernel`

devops

Skill	Description	Path
`webhook-subscriptions`	Webhook subscriptions: event-driven agent runs.	`devops/webhook-subscriptions`

dogfood

Skill	Description	Path
`dogfood`	Exploratory QA of web apps: find bugs, evidence, reports.	`dogfood`

email

Skill	Description	Path
`himalaya`	Himalaya CLI: IMAP/SMTP email from terminal.	`email/himalaya`

gaming

Skill	Description	Path
`minecraft-modpack-server`	Host modded Minecraft servers (CurseForge, Modrinth).	`gaming/minecraft-modpack-server`
`pokemon-player`	Play Pokemon via headless emulator + RAM reads.	`gaming/pokemon-player`

github

Skill	Description	Path
`codebase-inspection`	Inspect codebases w/ pygount: LOC, languages, ratios.	`github/codebase-inspection`
`github-auth`	GitHub auth setup: HTTPS tokens, SSH keys, gh CLI login.	`github/github-auth`
`github-code-review`	Review PRs: diffs, inline comments via gh or REST.	`github/github-code-review`
`github-issues`	Create, triage, label, assign GitHub issues via gh or REST.	`github/github-issues`
`github-pr-workflow`	GitHub PR lifecycle: branch, commit, open, CI, merge.	`github/github-pr-workflow`
`github-repo-management`	Clone/create/fork repos; manage remotes, releases.	`github/github-repo-management`

mcp

Skill	Description	Path
`native-mcp`	MCP client: connect servers, register tools (stdio/HTTP).	`mcp/native-mcp`

media

Skill	Description	Path
`gif-search`	Search/download GIFs from Tenor via curl + jq.	`media/gif-search`
`heartmula`	HeartMuLa: Suno-like song generation from lyrics + tags.	`media/heartmula`
`songsee`	Audio spectrograms/features (mel, chroma, MFCC) via CLI.	`media/songsee`
`spotify`	Spotify: play, search, queue, manage playlists and devices.	`media/spotify`
`youtube-content`	YouTube transcripts to summaries, threads, blogs.	`media/youtube-content`

mlops

Skill	Description	Path
`audiocraft-audio-generation`	AudioCraft: MusicGen text-to-music, AudioGen text-to-sound.	`mlops/models/audiocraft`
`axolotl`	Axolotl: YAML LLM fine-tuning (LoRA, DPO, GRPO).	`mlops/training/axolotl`
`dspy`	DSPy: declarative LM programs, auto-optimize prompts, RAG.	`mlops/research/dspy`
`huggingface-hub`	HuggingFace hf CLI: search/download/upload models, datasets.	`mlops/huggingface-hub`
`llama-cpp`	llama.cpp local GGUF inference + HF Hub model discovery.	`mlops/inference/llama-cpp`
`evaluating-llms-harness`	lm-eval-harness: benchmark LLMs (MMLU, GSM8K, etc.).	`mlops/evaluation/lm-evaluation-harness`
`obliteratus`	OBLITERATUS: abliterate LLM refusals (diff-in-means).	`mlops/inference/obliteratus`
`outlines`	Outlines: structured JSON/regex/Pydantic LLM generation.	`mlops/inference/outlines`
`segment-anything-model`	SAM: zero-shot image segmentation via points, boxes, masks.	`mlops/models/segment-anything`
`fine-tuning-with-trl`	TRL: SFT, DPO, PPO, GRPO, reward modeling for LLM RLHF.	`mlops/training/trl-fine-tuning`
`unsloth`	Unsloth: 2-5x faster LoRA/QLoRA fine-tuning, less VRAM.	`mlops/training/unsloth`
`serving-llms-vllm`	vLLM: high-throughput LLM serving, OpenAI API, quantization.	`mlops/inference/vllm`
`weights-and-biases`	W&B: log ML experiments, sweeps, model registry, dashboards.	`mlops/evaluation/weights-and-biases`

note-taking

Skill	Description	Path
`obsidian`	Read, search, and create notes in the Obsidian vault.	`note-taking/obsidian`

productivity

Skill	Description	Path
`airtable`	Airtable REST API via curl. Records CRUD, filters, upserts.	`productivity/airtable`
`google-workspace`	Gmail, Calendar, Drive, Docs, Sheets via gws CLI or Python.	`productivity/google-workspace`
`linear`	Linear: manage issues, projects, teams via GraphQL + curl.	`productivity/linear`
`maps`	Geocode, POIs, routes, timezones via OpenStreetMap/OSRM.	`productivity/maps`
`nano-pdf`	Edit PDF text/typos/titles via nano-pdf CLI (NL prompts).	`productivity/nano-pdf`
`notion`	Notion API via curl: pages, databases, blocks, search.	`productivity/notion`
`ocr-and-documents`	Extract text from PDFs/scans (pymupdf, marker-pdf).	`productivity/ocr-and-documents`
`powerpoint`	Create, read, edit .pptx decks, slides, notes, templates.	`productivity/powerpoint`

red-teaming

Skill	Description	Path
`godmode`	Jailbreak LLMs: Parseltongue, GODMODE, ULTRAPLINIAN.	`red-teaming/godmode`

research

Skill	Description	Path
`arxiv`	Search arXiv papers by keyword, author, category, or ID.	`research/arxiv`
`blogwatcher`	Monitor blogs and RSS/Atom feeds via blogwatcher-cli tool.	`research/blogwatcher`
`llm-wiki`	Karpathy's LLM Wiki: build/query interlinked markdown KB.	`research/llm-wiki`
`polymarket`	Query Polymarket: markets, prices, orderbooks, history.	`research/polymarket`
`research-paper-writing`	Write ML papers for NeurIPS/ICML/ICLR: design→submit.	`research/research-paper-writing`

smart-home

Skill	Description	Path
`openhue`	Control Philips Hue lights, scenes, rooms via OpenHue CLI.	`smart-home/openhue`

Skill	Description	Path
`xurl`	X/Twitter via xurl CLI: post, search, DM, media, v2 API.	`social-media/xurl`

software-development

Skill	Description	Path
`debugging-hermes-tui-commands`	Debug Hermes TUI slash commands: Python, gateway, Ink UI.	`software-development/debugging-hermes-tui-commands`
`hermes-agent-skill-authoring`	Author in-repo SKILL.md: frontmatter, validator, structure.	`software-development/hermes-agent-skill-authoring`
`node-inspect-debugger`	Debug Node.js via --inspect + Chrome DevTools Protocol CLI.	`software-development/node-inspect-debugger`
`plan`	Plan mode: write markdown plan to .hermes/plans/, no exec.	`software-development/plan`
`python-debugpy`	Debug Python: pdb REPL + debugpy remote (DAP).	`software-development/python-debugpy`
`requesting-code-review`	Pre-commit review: security scan, quality gates, auto-fix.	`software-development/requesting-code-review`
`spike`	Throwaway experiments to validate an idea before build.	`software-development/spike`
`subagent-driven-development`	Execute plans via delegate_task subagents (2-stage review).	`software-development/subagent-driven-development`
`systematic-debugging`	4-phase root cause debugging: understand bugs before fixing.	`software-development/systematic-debugging`
`test-driven-development`	TDD: enforce RED-GREEN-REFACTOR, tests before code.	`software-development/test-driven-development`
`writing-plans`	Write implementation plans: bite-sized tasks, paths, code.	`software-development/writing-plans`

yuanbao

Skill	Description	Path
`yuanbao`	Yuanbao (元宝) groups: @mention users, query info/members.	`yuanbao`

18 KiB Raw Blame History