Add hermes debug share instructions to all issue templates

- bug_report.yml: Add required Debug Report section with hermes debug share
  and /debug instructions, make OS/Python/Hermes version optional (covered
  by debug report), demote old logs field to optional supplementary
- setup_help.yml: Replace hermes doctor reference with hermes debug share,
  add Debug Report section with fallback chain (debug share -> --local -> doctor)
- feature_request.yml: Add optional Debug Report section for environment context

All templates now guide users to run hermes debug share (or /debug in chat)
and paste the resulting paste.rs links, giving maintainers system info,
config, and recent logs in one step.
This commit is contained in:
Teknium 2026-04-13 19:08:56 -07:00
parent f6626fccee
commit 8369bc9db2
No known key found for this signature in database
3 changed files with 52 additions and 10 deletions

View file

@ -11,6 +11,7 @@ body:
**Before submitting**, please: **Before submitting**, please:
- [ ] Search [existing issues](https://github.com/NousResearch/hermes-agent/issues) to avoid duplicates - [ ] Search [existing issues](https://github.com/NousResearch/hermes-agent/issues) to avoid duplicates
- [ ] Update to the latest version (`hermes update`) and confirm the bug still exists - [ ] Update to the latest version (`hermes update`) and confirm the bug still exists
- [ ] Run `hermes debug share` and paste the links below (see Debug Report section)
- type: textarea - type: textarea
id: description id: description
@ -82,6 +83,25 @@ body:
- Slack - Slack
- WhatsApp - WhatsApp
- type: textarea
id: debug-report
attributes:
label: Debug Report
description: |
Run `hermes debug share` from your terminal and paste the links it prints here.
This uploads your system info, config, and recent logs to a paste service automatically.
If you're in an interactive chat session, you can also use the `/debug` slash command — it does the same thing.
If the upload fails, run `hermes debug share --local` and paste the output directly.
placeholder: |
Report https://paste.rs/abc123
agent.log https://paste.rs/def456
gateway.log https://paste.rs/ghi789
render: shell
validations:
required: true
- type: input - type: input
id: os id: os
attributes: attributes:
@ -97,8 +117,6 @@ body:
label: Python Version label: Python Version
description: Output of `python --version` description: Output of `python --version`
placeholder: "3.11.9" placeholder: "3.11.9"
validations:
required: true
- type: input - type: input
id: hermes-version id: hermes-version
@ -106,14 +124,14 @@ body:
label: Hermes Version label: Hermes Version
description: Output of `hermes version` description: Output of `hermes version`
placeholder: "2.1.0" placeholder: "2.1.0"
validations:
required: true
- type: textarea - type: textarea
id: logs id: logs
attributes: attributes:
label: Relevant Logs / Traceback label: Additional Logs / Traceback (optional)
description: Paste any error output, traceback, or log messages. This will be auto-formatted as code. description: |
The debug report above covers most logs. Use this field for any extra error output,
tracebacks, or screenshots not captured by `hermes debug share`.
render: shell render: shell
- type: textarea - type: textarea

View file

@ -71,3 +71,15 @@ body:
label: Contribution label: Contribution
options: options:
- label: I'd like to implement this myself and submit a PR - label: I'd like to implement this myself and submit a PR
- type: textarea
id: debug-report
attributes:
label: Debug Report (optional)
description: |
If this feature request is related to a problem you're experiencing, run `hermes debug share` and paste the links here.
In an interactive chat session, you can use `/debug` instead.
This helps us understand your environment and any related logs.
placeholder: |
Report https://paste.rs/abc123
render: shell

View file

@ -9,7 +9,8 @@ body:
Sorry you're having trouble! Please fill out the details below so we can help. Sorry you're having trouble! Please fill out the details below so we can help.
**Quick checks first:** **Quick checks first:**
- Run `hermes doctor` and include the output below - Run `hermes debug share` and paste the links in the Debug Report section below
- If you're in a chat session, you can use `/debug` instead — it does the same thing
- Try `hermes update` to get the latest version - Try `hermes update` to get the latest version
- Check the [README troubleshooting section](https://github.com/NousResearch/hermes-agent#troubleshooting) - Check the [README troubleshooting section](https://github.com/NousResearch/hermes-agent#troubleshooting)
- For general questions, consider the [Nous Research Discord](https://discord.gg/NousResearch) for faster help - For general questions, consider the [Nous Research Discord](https://discord.gg/NousResearch) for faster help
@ -74,10 +75,21 @@ body:
placeholder: "2.1.0" placeholder: "2.1.0"
- type: textarea - type: textarea
id: doctor-output id: debug-report
attributes: attributes:
label: Output of `hermes doctor` label: Debug Report
description: Run `hermes doctor` and paste the full output. This will be auto-formatted. description: |
Run `hermes debug share` from your terminal and paste the links it prints here.
This uploads your system info, config, and recent logs to a paste service automatically.
If you're in an interactive chat session, you can also use the `/debug` slash command — it does the same thing.
If the upload fails or install didn't get that far, run `hermes debug share --local` and paste the output directly.
If even that doesn't work, run `hermes doctor` and paste that output instead.
placeholder: |
Report https://paste.rs/abc123
agent.log https://paste.rs/def456
gateway.log https://paste.rs/ghi789
render: shell render: shell
- type: textarea - type: textarea