Skip to content

docs: fix documentation inconsistencies across reference and user guides#1995

Merged
teknium1 merged 1 commit intomainfrom
hermes/hermes-9dc2e46c
Mar 18, 2026
Merged

docs: fix documentation inconsistencies across reference and user guides#1995
teknium1 merged 1 commit intomainfrom
hermes/hermes-9dc2e46c

Conversation

@teknium1
Copy link
Copy Markdown
Contributor

Summary

Systematic review of all documentation against the actual codebase. Fixes inconsistencies across 7 doc files.

Changes

toolsets-reference.md

  • Add browser_console to browser toolset and all platform toolsets (was missing)
  • Add missing hermes-acp toolset (exists in code, missing from docs)
  • Add missing hermes-sms toolset (exists in code, missing from docs)
  • Add missing messaging toolset (exists in code, missing from docs)
  • Correct hermes-gateway as composite type (union of platform toolsets, not a platform itself)
  • Deduplicate platform toolset listings (all share _HERMES_CORE_TOOLS)

tools-reference.md

  • Add missing vision toolset section with vision_analyze tool
  • Add missing web toolset section with web_search and web_extract tools

slash-commands.md

  • Fix /new + /reset: in code, reset is an alias for new, not a separate command with different behavior
  • Add /stop to CLI section (handled in both cli.py and gateway, was only listed under messaging)
  • Add /plugins command (exists in COMMAND_REGISTRY, missing from docs)
  • Fix Notes section: /stop is not messaging-only, /plugins is CLI-only

environment-variables.md

  • Fix HERMES_MAX_ITERATIONS default: code says 90, doc said 60
  • Add DEEPSEEK_API_KEY + DEEPSEEK_BASE_URL (in OPTIONAL_ENV_VARS)
  • Add OPENCODE_ZEN_API_KEY + OPENCODE_ZEN_BASE_URL (in OPTIONAL_ENV_VARS)
  • Add OPENCODE_GO_API_KEY + OPENCODE_GO_BASE_URL (in OPTIONAL_ENV_VARS)
  • Add TAVILY_API_KEY (in OPTIONAL_ENV_VARS, version 10 migration)
  • Add GITHUB_TOKEN (in OPTIONAL_ENV_VARS)
  • Add HERMES_EPHEMERAL_SYSTEM_PROMPT (in OPTIONAL_ENV_VARS)

configuration.md

  • Remove duplicate Alibaba Cloud row (appeared twice)
  • Add OpenCode Zen and OpenCode Go to provider table

cli-commands.md

  • Add missing providers to --provider list: opencode-zen, opencode-go, ai-gateway, kilocode, alibaba

quickstart.md

  • Add OpenCode Zen and OpenCode Go to provider table

Verification

All changes verified against actual source code: toolsets.py, hermes_cli/commands.py, hermes_cli/config.py, hermes_cli/main.py, tools/browser_tool.py, tools/vision_tools.py, tools/web_tools.py, cli.py, gateway/run.py.

- toolsets-reference: add browser_console to browser + all platform toolsets,
  add missing hermes-acp, hermes-sms, messaging toolsets, correct hermes-gateway
  as composite, deduplicate platform toolset listings
- tools-reference: add missing vision and web toolset sections
- slash-commands: fix /new+/reset as alias (not separate commands), add /stop to
  CLI section (available in both CLI and gateway), add /plugins command, fix Notes
  section about messaging-only vs CLI-only
- environment-variables: fix HERMES_MAX_ITERATIONS default (90 not 60), add
  DEEPSEEK_API_KEY/BASE_URL, OPENCODE_ZEN/GO keys, TAVILY_API_KEY,
  GITHUB_TOKEN, HERMES_EPHEMERAL_SYSTEM_PROMPT
- configuration: remove duplicate Alibaba Cloud row, add OpenCode Zen/Go providers
- cli-commands: add missing providers to --provider list (opencode-zen,
  opencode-go, ai-gateway, kilocode, alibaba)
- quickstart: add OpenCode Zen and OpenCode Go to provider table
@teknium1 teknium1 force-pushed the hermes/hermes-9dc2e46c branch from e2436de to e8286cc Compare March 18, 2026 23:26
@teknium1 teknium1 merged commit e648863 into main Mar 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant