Official issues about the hermes command line tool. Sourced from the official GitHub repo; status derived from official labels; every entry links back to its source with a last-checked date.
#58290 Workaround P2 comp/cli [Bug]: using /model xxx --provider xxx will automaticlly change the config.yaml, and I never input the --global
Sending /model xxx --provider xxx via feishu changes the default model/provider in config.yaml even without the --global flag, when it should only affect the runtime session.
#58277 Workaround P2 comp/cli [Bug]: Empty YAML key (terminal:) in profile config.yaml crashes load_cli_config with TypeError
An empty terminal: key in a profile's config.yaml is parsed by YAML as None, which load_cli_config() fails to fall back to {} for, causing a TypeError that crashes the agent before the first conversation turn.
#58265 Workaround P2 comp/cli Config `provider`-key warning storms concurrent-log-handler on Windows → serve/gateway event-loop stall
On Windows, a benign unknown provider config key triggers a warning on every load_picker_context() call, and the resulting log volume deadlocks concurrent-log-handler's cross-process lock, stalling the asyncio event loop for ~14s at a time and dropping desktop/TUI WebSockets while /health stays green.
#58200 Workaround P2 comp/agent [Bug]: Trajectory files are not created in CLI / TUI / Gateway
Setting agent.save_trajectories: true in config.yml per the documentation does not produce any *.jsonl trajectory files, because the code never checks this config option.
#58198 Investigating P3 comp/cli [Feature]: The selected Model and provider label should appear at the top of the list for easy access
Users have to repeatedly scroll to find the currently selected model/provider in the picker list; the request asks for the selected entry to always appear at the top.
#58172 Workaround P2 comp/cli [Setup]: hermes update causes unbounded .git directory growth on long-running VPS
Every hermes update pull adds git objects without cleaning up old ones, causing unbounded .git directory growth (884MB after months) that can push a long-running VPS's disk usage to risky levels.
#58151 Investigating P3 comp/cli [Feature]: CLI commands and agent-assisted session archiving/organization
A power user with hundreds of accumulated sessions requests CLI commands and agent-assisted tools to archive, organize, tag, and export sessions, since none currently exist.
#58150 Workaround P2 comp/cli [Bug]: Hermes use window nodejs instead of its built-in node
Hermes on Windows uses the system's installed Node.js instead of its bundled version when the system Node.js is updated, causing version mismatches and terminal window flashing.
#58132 Investigating P3 comp/cli feat: 会话添加重要性/优先级标记 (Session Importance)
### 问题描述
Hermes 目前没有给会话（session）标记重要性或优先级的功能
### 建议方案
给每条会话增加一个「重要性/优先级」属性
**1. 设置重要性**
- CLI：`her
#58125 Investigating P3 comp/cli Feature Request: Live kanban task status in TUI/CLI
Requests live status indicators (spinners, watch mode, heartbeat display) for kanban tasks in the TUI/CLI, since current output is static and requires manual re-running to see progress.
#58100 Workaround P2 comp/cli [Bug]: get_env_value_prefer_dotenv returns None when get_secret returns None instead of falling through to os.environ
get_env_value_prefer_dotenv() returns None when get_secret() finds no match, instead of falling through to os.environ, preventing secrets injected via Bitwarden Secrets Manager from being resolved.
#57705 Investigating P3 comp/cli [Bug]How do I add this address model API? I get an error when I try to add it, and it doesn't work
The reporter states they get an error and the feature does not work when trying to add a specific address model API, with only a link and a screenshot attached and no further description.
#55253 Investigating P3 comp/cli Bound OpenAI Codex auth JSON responses
The OpenAI Codex device-auth login flow reads successful JSON responses with unbounded httpx calls, with no byte cap on the response body for several auth endpoints.
#54220 Fixed P2 comp/agent [Tracking] Windows Desktop GUI: console windows (cmd/conhost/git/gh/powershell) flash on subprocess spawns
This tracking issue consolidates roughly 25 reports of console windows (cmd, conhost, git, gh, powershell) flashing on the Windows desktop GUI when its windowless pythonw.exe backend spawns console-subsystem child processes without the no-window flag, and documents which spawn sites are still leaking based on source and git-history verification.
[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.
#42961 Workaround P2 comp/cli terminal.cwd config ignored for local backend — process cwd always used instead
The terminal.cwd config setting is silently discarded for the local terminal backend because cli.py unconditionally overrides it with the process's launch directory, so it only works for non-local backends.
#40187 Workaround P2 comp/cli [Bug]: Windows desktop app fails to compile during hermes update / hermes desktop
Running hermes update or hermes desktop fails during the final Electron packaging stage; the reporter's title references a Windows desktop app, but the attached build log shows electron-builder packaging for macOS (darwin arm64).
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.
#38448 Workaround P2 comp/cli hermes -z can miss MCP tools because oneshot snapshots tools before MCP discovery
In oneshot mode (hermes -z), the agent's tool list is built before MCP discovery registers dynamic MCP tools/aliases, so tools from configured MCP servers are never available even though they pass hermes mcp test.
#35750 Investigating P3 comp/cli [Feature]: Real-time Voice Conversation Mode (voice-in, voice-out, low-latency)
This issue requests a real-time voice conversation mode for Hermes Agent's terminal/TUI, including microphone input, streaming speech-to-text, low-latency responses, and streaming text-to-speech output.
#34871 Workaround P2 tool/mcp hermes mcp serve crashes with ModuleNotFoundError: No module named 'mcp_serve'
Starting the MCP server after a standard pip install crashes due to a module path issue. Labeled P2 by maintainers, so a workaround exists.
WorkaroundReinstall as a full package, clear stale caches, and restart. After changing config, reset the session so the MCP reloads.
#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.
#29530 Workaround P2 comp/cli Profiled workers need a shared auth home separate from isolated HERMES_HOME
Profiled Hermes workers using isolated HERMES_HOME directories can end up with split-brain OAuth state for rotating/single-use refresh tokens; the reporter proposes a separate shared HERMES_AUTH_HOME for auth storage.
[Bug]: xAI OAuth loopback on macOS: local callback received, but Hermes times out
On a local macOS Hermes install, the xAI OAuth browser callback succeeds ("authorization received") but Hermes still throws an authorization timeout and never stores xAI credentials, a case the reporter distinguishes from documented remote/SSH callback failures.
#17199 Workaround P2 comp/cli deepseek provider: model normalization and base_url override break custom endpoints (e.g. Volcengine ARK)
Custom OpenAI-compatible endpoints configured under the deepseek provider break because non-standard model names get force-normalized to deepseek-chat, and the credential pool's base_url is rebuilt from hardcoded defaults on every startup, ignoring config.yaml or auth.json settings.
RFC: review the Kanban — multi-profile collaboration board (PR #16100)
This RFC tracks the implemented Kanban board PR (#16100): a long-lived daemon replacing the cron-driven dispatcher, a drag-and-drop dashboard plugin, run history and worker log panels, live WebSocket updates, and multiple audit/review passes with concurrency and fuzz testing. Issue is closed as fixed, with further discussion moved to the PR.
#12238 Investigating P3 comp/cli Feature Request: Built-in Automatic Backup & Version Control for Agent Data (~/.hermes/)
This issue requests a built-in automatic backup and version control mechanism for all Hermes agent data stored in ~/.hermes/, including a proposed `hermes backup` CLI command for immediate or scheduled snapshots.
[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.
[Setup]: Copilot // API call failed (attempt 1/3): APIConnectionError
On a MacBook M5 running Python 3.9.6, chatting with a hermes-configured Copilot provider repeatedly fails with APIConnectionError after 3 retries; the reporter notes running `hermes update` resolves it. Issue is closed as fixed.
#10567 Investigating P3 comp/cli Add --host and CORS config for hermes dashboard to enable Tailscale/VPN access
The hermes dashboard's CORS regex is hardcoded to localhost/127.0.0.1, so even with --host 0.0.0.0 the frontend loads but API calls are blocked, preventing remote access over VPNs like Tailscale; the issue requests configurable host/port and CORS origins.
[Bug]: hermes command not found in external interactive shells after virtualenv migration (#8226)
This closed issue reports that after the virtualenv migration in PR #8226, the hermes command is not found in external interactive shells (e.g. docker exec) because the venv is not activated and its bin directory is not in PATH.
Docker image missing 'dashboard' command (web UI not available in latest image)
The nousresearch/hermes-agent:latest Docker Hub image lacked the dashboard subcommand even though it exists in the main branch source, making the web UI unusable in containerized setups like Coolify; the issue is now closed.
[Setup]: Installer stuck at "Install ripgrep / ffmpeg [Y/n]" - no keyboard input detected
On Windows 11, the curl-piped Hermes installer hangs at the ripgrep/ffmpeg install prompt with the terminal accepting no keyboard input, and retrying, restarting the terminal, or reinstalling did not resolve it.
[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.
[UX] Add Shift+Enter newline support in CLI input
This issue proposes adding Shift+Enter as an additional newline keybinding in the Hermes CLI/TUI input, alongside the existing Alt+Enter and Ctrl+J bindings. This issue is closed.
[Bug]: CLI is unreadable on light/cream terminal backgrounds — no light mode support
All built-in Hermes CLI skins use light-colored text designed for dark terminal backgrounds, making the banner, prompts, and input nearly invisible on light/cream terminal backgrounds; the issue is now closed.
#3326 Investigating P3 comp/cli feat(cli): add --output-format json flag for structured query output
hermes chat -q currently only produces plain text output for programmatic use, requiring manual parsing of token counts, cost, and session metadata; the issue requests a --output-format json flag, with an associated PR already filed.
#3002 Workaround P2 comp/cli [Bug]: Fails to install NeuTTS during setup
On a fresh Hermes install with NeuTTS enabled in the setup wizard, installation fails because the venv's Python has no pip module, even though pip3 may be available.