feat(cli,gateway): add user-defined quick commands that bypass agent loop#746
Merged
teknium1 merged 1 commit intoNousResearch:mainfrom Mar 11, 2026
Merged
Conversation
…loop
Implements config-driven quick commands for both CLI and gateway that
execute locally without invoking the LLM.
Config example (~/.hermes/config.yaml):
quick_commands:
limits:
type: exec
command: /home/user/.local/bin/hermes-limits
dn:
type: exec
command: echo daily-note
Changes:
- hermes_cli/config.py: add quick_commands: {} default
- cli.py: check quick_commands before skill commands in process_command()
- gateway/run.py: check quick_commands before skill commands in _handle_message()
- tests/test_quick_commands.py: 11 tests covering exec, timeout, unsupported type, missing command, priority over skills
Closes NousResearch#744
teknium1
added a commit
that referenced
this pull request
Mar 11, 2026
Documents the quick_commands config feature from PR #746: - configuration.md: full section with examples (server status, disk, gpu, update), behavior notes (timeout, priority, works everywhere) - cli.md: brief section with config example + link to config guide
Contributor
|
Merged in 359352b with docs in c532129 — thanks @teyrebaz33! 🎉 This is especially useful for running quick server checks from Telegram/Discord without burning tokens. Added documentation to:
All 2975 tests pass. Appreciate the contribution! 🙏 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes #744
Adds config-driven quick commands for both CLI and gateway that execute locally without invoking the LLM — zero token usage, works even when the provider is rate-limited or unavailable.
Config
Behavior
/dnmatches before skill commands, runs the exec, prints output/dnmatches before skill commands, runs the exec, returns output as messageChanges
hermes_cli/config.py—quick_commands: {}defaultcli.py— quick command check before skill commands inprocess_command()gateway/run.py— quick command check before skill commands in_handle_message()tests/test_quick_commands.py— 11 testsNot implemented
Permissions/allowlisting (item 5) — marked optional in the issue, can be a follow-up.