P1 Critical (19)

Issues labeled P1 by the maintainers, mostly known issues without a fix yet. Sourced from the official GitHub repo; status derived from official labels; every entry links back to its source with a last-checked date.

#58327 Fixed P1 comp/agent

[Bug]: Context compression breaks tool message chain, causing "role 'tool' must be a response to a preceding message with 'tool_calls'" on strict providers

Context compression could orphan tool messages by dropping their assistant tool_calls message, causing HTTP 400 on strict providers like DeepSeek. Closed.

#58270 Fixed P1 comp/gateway

fix(telegram): updater.stop() in reconnect ladder hangs on CLOSE-WAIT sockets — heartbeat loop stuck for hours

The Telegram reconnect handler's updater.stop() call has no timeout, so when the underlying TCP socket is stuck in CLOSE-WAIT the polling task never wakes up, permanently blocking reconnect attempts and silently dropping messages for hours until a manual restart.

#58236 Fixed P1 comp/gateway

Gateway hangs indefinitely on Telegram connect (attempt 1/8) — asyncio.wait_for never fires under s6 supervision

The Telegram gateway adapter hangs indefinitely at connect attempt 1/8 with the 30s asyncio.wait_for timeout never firing, but only under s6-overlay supervision per the reporter's diagnostics.

#58168 Fixed P1 comp/agent

Bug: Context compaction produces invalid message sequences (orphaned tool messages), breaking sessions permanently

The trajectory compressor produces invalid message sequences with orphaned tool messages after context compaction, permanently breaking long-running sessions with a DeepSeek API 400 error.

#58010 Fixed P1 comp/gateway

AsyncSessionDB breaks /resume — missing await in slash_commands.py

AsyncSessionDB wraps SessionDB methods as async coroutines, but slash_commands.py calls them without await, causing /resume to crash with a TypeError. This issue is now closed.

#48534 Fixed P1 comp/agent

Anthropic Max OAuth fails: token exchange 404s because Anthropic now blocks the claude-cli/ User-Agent

The built-in Anthropic OAuth token exchange fails with HTTP 404 because Anthropic now blocks any request carrying a claude-cli/ User-Agent prefix regardless of version, confirmed by testing multiple User-Agent strings.

#47917 Fixed P1 comp/cli

[Bug] Desktop build fails after update - electronDist does not exist (cache invalidated)

This closed issue reported that Hermes Desktop builds fail again after code updates with an 'electronDist does not exist' error, because the update process clears the Electron binary cache, indicating the fix in PR #47276 was incomplete.

#38855 Fixed P1 comp/cli

Desktop Working Directory setting does not override stale remembered workspace cwd

In Hermes Desktop, updating the Working Directory setting does not take effect for new sessions if the renderer's localStorage already has a remembered workspace cwd, so new sessions keep starting in the old directory despite config.yaml being updated correctly.

#34821 No fix yet P1 comp/cli

install.ps1 line 2284 throws 'Cannot use -Ensure and -Stage simultaneously' on bare invocation

The Windows installer script has a parameter conflict on bare invocation. Labeled P1, meaning it blocks installation with no official workaround yet.

#34071 Fixed P1

[Bug] v0.15.0 Docker image: stage2-hook.sh, main-wrapper.sh missing; container_boot module removed

The official v0.15.0 Docker image fails to start with exit code 127: two init scripts (stage2-hook.sh, main-wrapper.sh) present in source but missing from the built image, plus a reference to the hermes_cli.container_boot module that was removed in the v0.15.0 refactor. Issue is closed as fixed.

#33932 Fixed P1 comp/agent

OpenAI Codex provider crashes with "'NoneType' object is not iterable" (HTTP None)

Switching to gpt-5.5 via the OpenAI Codex provider (subscription OAuth) crashes on the first user message with "Non-retryable error (HTTP None): 'NoneType' object is not iterable," though fallback then takes over.

#27282 Fixed P1 comp/gateway

[--tui] gateway exits mid-turn with stdin EOF (TUI closed the command pipe) — NOT byterover-related

On macOS in --tui mode, the gateway repeatedly exits mid-conversation with "stdin EOF (TUI closed the command pipe)" even with only built-in memory enabled (no byterover), which the reporter notes is distinct from a similar SIGPIPE issue (#14036) caused by the byterover memory plugin.

#25495 Fixed P1 comp/gateway

[Bug]: Matrix / synapse broken in the official docker image

The Matrix/Synapse gateway in the official Docker image breaks after a certain build, with startup logs stalling at 'fixing ownership :1000'; the bot can still send messages but does not respond to channel prompts. Issue is closed as fixed.

#24140 Fixed P1 comp/agent

All models rejected with "context window below minimum 64,000 tokens" — Telegram completely down

All calls to MiniMax-M2.7 and kimi-k2.6 (32,768 token context) were rejected by Hermes Agent's 64K minimum context check, taking down the Telegram bot and cron jobs even though the models previously worked without any config changes.

#22714 Fixed P1 comp/gateway

Matrix gateway: no in-band channel to drive per-message LLM orchestration in a downstream dispatcher

The reporter describes a Matrix gateway deployment fronting a custom LLM dispatcher that routes requests between local and cloud models per rule, and reports there is no in-band channel for per-message routing decisions (like a user's /model command) to reach that downstream dispatcher.

#15080 Fixed P1

[Bug]: On a Claude Max 20x subscription with a valid OAuth access token from ~/.claude/.credentials.json, every Hermes request to native Anthropic (provider: anthropic, https://api.anthropic.com/v1/messages) is rejected with HTTP 400

With a valid Claude Max 20x OAuth access token, every Hermes request to the native Anthropic provider fails with HTTP 400, reporting that extra usage has been exhausted. Issue is closed as fixed.

#12058 Fixed P1 comp/cli

[Bug]: OpenAI Codex OAuth works in CLI, but Telegram gateway replies No Codex credentials stored

OpenAI Codex OAuth works via CLI, but the Telegram gateway reports 'No Codex credentials stored' despite the same credentials being valid, in a Docker/Coolify deployment. This issue is now closed.

#8270 Fixed P1

HTTP 400 on all OpenRouter models - curl works fine

On a fresh Hermes install (WSL2 Ubuntu), all OpenRouter model calls return HTTP 400 and hermes doctor reports the same, even though curl with the identical API key gets a valid response.

#5884 Fixed P1 comp/cli

[Setup]: OSError: [Errno 22] Invalid argument:[prompt_toolkit crash]

Starting hermes chat prints a welcome message and a notice that the tirith security scanner is unavailable, then immediately crashes with a traceback showing an asyncio selector KeyError followed by an unhandled exception in main.py. Issue is closed as fixed.

Other categories

Back to curated issues . School solution cards . Troubleshooting