hermes - 💡(How to fix) Fix Bug: hermes -z one-shot flag availability inconsistent across versions [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
NousResearch/hermes-agent#25121Fetched 2026-05-14 03:48:42
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Timeline (top)
labeled ×3commented ×1

The hermes -z flag (for one-shot queries without entering interactive mode) is available in some Hermes versions but not others. Some versions require hermes chat -q instead. This inconsistency causes scripts and helpers that rely on one-shot invocation to break depending on the installed Hermes version.

Error Message

  • On other versions: hermes -z produces unrecognized arguments error

Root Cause

The hermes -z flag (for one-shot queries without entering interactive mode) is available in some Hermes versions but not others. Some versions require hermes chat -q instead. This inconsistency causes scripts and helpers that rely on one-shot invocation to break depending on the installed Hermes version.

RAW_BUFFERClick to expand / collapse

Bug Report: hermes -z one-shot flag availability is inconsistent across Hermes versions

Description

The hermes -z flag (for one-shot queries without entering interactive mode) is available in some Hermes versions but not others. Some versions require hermes chat -q instead. This inconsistency causes scripts and helpers that rely on one-shot invocation to break depending on the installed Hermes version.

Observed Behavior

  • On some versions: hermes -z "prompt" works
  • On other versions: hermes -z produces unrecognized arguments error
  • hermes chat -q "prompt" is more consistently available across versions

Impact

  • Scripts must include version-detection logic before every one-shot invocation
  • The second_opinion.py helper and other tooling had to implement fallback logic to detect which syntax works
  • New users following documentation with the wrong version get confusing errors
  • The --timeout flag also has inconsistent support (accepted by some subcommands but not hermes chat -q)

Suggested Fix

Option A — Unify: Make hermes -z and hermes chat -q both accept equivalent flags across all versions, or deprecate one in favor of the other.

Option B — Document: Add a prominent note in hermes --help and the Hermes documentation about which one-shot invocation syntax is supported in the current version, and what the recommended cross-version approach is.

Option C — CLI helper: Add a hermes detect-invocation command that prints the correct one-shot syntax for the current version, so scripts can auto-detect without string-parsing --help output.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING