Hermes plugin: injects output-location guidance into subagent prompts so files go to /tmp/ when no path is specified
  • Python 95.2%
  • Just 4.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
xlion-bot-renovate[bot] dce667bd0b
chore(deps): update taiki-e/install-action action to v2.90.3 (#97)
Co-authored-by: xlion-bot-renovate[bot] <218815870+xlion-bot-renovate[bot]@users.noreply.github.com>
2026-11-11 13:07:14 +00:00
.github chore(deps): update taiki-e/install-action action to v2.90.3 (#97) 2026-11-11 13:07:14 +00:00
tests fix: scope output guidance to text reports 2026-09-02 15:05:15 +08:00
.gitignore fix: make cascade cleanup recursive (BFS walk) 2026-07-01 22:24:18 +08:00
.vulture_whitelist.py refactor: change _child_sessions from set[str] to dict[str, ChildInfo] with cascade cleanup 2026-07-01 22:24:17 +08:00
__init__.py fix: scope output guidance to text reports 2026-09-02 15:05:15 +08:00
AGENTS.md fix: scope output guidance to text reports 2026-09-02 15:05:15 +08:00
CONTRIBUTING.md style: fix line wrapping in CONTRIBUTING.md 2026-06-25 23:25:14 +08:00
justfile feat: add bandit, vulture, just clean recipe, full english 2026-06-25 21:39:48 +08:00
LICENSE fix: sync LICENSE with SPDX MIT template (exact line wrapping) 2026-06-25 23:13:59 +08:00
plugin.yaml fix: scope output guidance to text reports 2026-09-02 15:05:15 +08:00
pyproject.toml chore: align plugin dependency metadata with Hermes PM 2026-09-27 06:06:50 +08:00
README.md fix: scope output guidance to text reports 2026-09-02 15:05:15 +08:00
uv.lock chore: align plugin dependency metadata with Hermes PM 2026-09-27 06:06:50 +08:00

hermes-subagent-output-guide

A Hermes user plugin that guides subagents to keep concise text reports in the response and save long reports to a specified location or /tmp/.

Forgets to tell the subagent where to put the report? This plugin has your back.

Injected guidance

On every subagent's first LLM call, the following block is appended to its user message:

<subagent-output-guide>

## Text Report Delivery

This guidance applies only to text reports. It does not apply to source
code, tests, project documentation, scripts, data, logs, build outputs,
or any other non-report files.

Follow any explicit delivery instructions in the delegated task.

- For a concise report, respond directly unless the task requests a file.
- If the report would make the final response long, proactively save the
  detailed report to a text file instead of placing most of it in the
  final response.
- Use the report location specified by the delegated task. If none is
  specified, save the report under ``/tmp/``.
- When a report file is created, keep the final response concise and include
  the key findings, decisions, or next steps together with the report's
  absolute path.

</subagent-output-guide>

Installation

Clone to the Hermes user plugins directory:

git clone https://github.com/xlionjuan/hermes-subagent-output-guide.git \
    ~/.hermes/plugins/hermes-subagent-output-guide

Enable

hermes plugins enable hermes-subagent-output-guide

Takes effect after a gateway restart (/restart or restart the Hermes gateway service).

Using in other profiles

To make this plugin available in another Hermes profile, create a symlink under that profile's plugins/ directory:

mkdir -p ~/.hermes/profiles/<profile>/plugins
ln -s ../../../plugins/hermes-subagent-output-guide \
    ~/.hermes/profiles/<profile>/plugins/hermes-subagent-output-guide

Then enable it from that profile:

hermes plugins --profile <profile> enable hermes-subagent-output-guide

Note: The symlink target ../../../plugins/hermes-subagent-output-guide is relative and resolves from ~/.hermes/profiles/<profile>/plugins/ back to the canonical install at ~/.hermes/plugins/. This keeps a single copy of the plugin shared across profiles.