hermes debug Command — Complete Reference & Examples

Overview

hermes debug provides diagnostic utilities for Hermes Agent. Use it to upload a debug report (system info + recent logs) to a paste service and get a shareable URL, or to delete a previously uploaded paste.

hermes debug {share,delete} ...

Subcommands

`share` — Upload a debug report

hermes debug share

Uploads a debug report containing system information and recent logs to a paste service and prints a shareable URL. You will be asked for confirmation unless --yes is provided.

Options

Option	Description
`-y`, `--yes`	Skip the confirmation prompt and upload immediately. Required in non-interactive contexts (scripts/CI); without it, the command refuses rather than upload silently when stdin is not a TTY.
`--lines LINES`	Number of log lines to include per log file. Default is `200`.
`--expire EXPIRE`	Paste expiry in days. Default is `7`.
`--local`	Print the report locally instead of uploading it.
`--no-redact`	Disable upload-time secret redaction. By default, logs are run through `agent.redact.redact_sensitive_text` with `force=True` before upload so credentials are not leaked into the public paste service.
`--nous`	Upload the debug bundle to private Nous-internal storage (AWS S3) instead of a public paste service. It is viewable only by Nous staff and allowlisted Discord mods, and auto-deletes after 14 days. Secrets are still redacted unless `--no-redact` is also passed.

`delete` — Remove an uploaded paste

hermes debug delete <url>

Deletes a paste that was previously uploaded with hermes debug share.

Common Scenarios

hermes debug share

Interactive upload; confirm the prompt to generate a shareable link.

Non-interactive upload in CI

hermes debug share --yes

Use --yes so the command does not hang waiting for input in scripts.

Include more log context

hermes debug share --lines 500

Useful when troubleshooting issues that span many log lines.

Private upload for Nous staff

hermes debug share --nous --yes

Uploads to Nous-internal storage instead of a public paste service.

Inspect the report locally

hermes debug share --local

Prints the full debug report to the terminal without uploading it.

Delete an old paste

hermes debug delete https://paste.example.com/abc123

Tips

Default redaction strips credential-like strings from the uploaded logs. Use --no-redact only when you deliberately need raw values and understand the risk.
--nous is the safest choice for sharing sensitive environments with the Hermes team.
Always prefer --yes over redirecting stdin when automating the upload.