The Hermes Skill sync path does not check the HERMES_HOME environment variable, so the symlink is written into the wrong directory - CC Switch

Quick fix

CC Switch hard-codes the Skills path; await a fix supporting a custom HERMES_HOME.

Symptom

Error outputCopy

Hermes Skill 同步路径未检测 HERMES_HOME 环境变量，导致 Symlink 写入错误目录

English translation

The Hermes Skill sync path does not check the HERMES_HOME environment variable, so the symlink is written into the wrong directory

Cause

Syncing Hermes Skills, CC Switch hard-codes `~/.hermes/skills/` as the target path. The real Hermes Skills directory, however, is determined by the `HERMES_HOME` environment variable and may not be under `~/.hermes/` at all (on Windows it may be `C:\Users\<user>\AppData\Local\hermes`). The symlink CC Switch creates therefore lands in the wrong directory and Hermes cannot recognize those Skills.

Separately, on the Hermes Agent CN build, the path of the session database `state.db` also differs from the official build (it is at `%APPDATA%\cn.org.hermesagent.desktop\runtime\hermes-home\state.db`), and `HERMES_HOME` may be set to the install directory rather than the data directory, so the CC Switch Session Manager cannot read the session records. CC Switch currently has no way to detect these non-standard paths automatically or let you specify `hermesConfigDir` by hand.

Fix

1. 1

   Confirm the real directory your `HERMES_HOME` environment variable points at.

2. 2

   Since the current CC Switch version (3.16.3, for instance) has this bug, copy the symlink CC Switch created into the correct `$HERMES_HOME/skills/` directory by hand for now, so Hermes recognizes the Skill immediately.

   示例：将 symlink 从错误位置复制到正确位置

   # 错误位置: ~/.hermes/skills/
   # 正确位置: $HERMES_HOME/skills/

3. 3

   For CN build users who need the Session Manager, there is no officially supported automatic fix. Watch for a later version adding automatic detection of the fixed CN data path or a manual `hermesConfigDir` setting.

Affected Versions

ToolHermes

Version3.16.3

PlatformsWindows

Source Issues

This page is distilled from 2 real issues

• #3811Hermes Skill 同步路径未检测 HERMES_HOME 环境变量，导致 Symlink 写入错误目录
• #4648[bug] Session Manager 无法读取 Hermes Agent CN 版本的会话（state.db 路径不匹配）

FAQ

I set HERMES_HOME — why does CC Switch still put the Skill under ~/.hermes/?

This is a known CC Switch bug. It currently hard-codes the `~/.hermes/skills/` path and does not read the `HERMES_HOME` environment variable first. You have to move the symlink to the right directory by hand.

I am on the Hermes CN build and the Session Manager is empty. What now?

The CN build session database `state.db` is at `%APPDATA%\cn.org.hermesagent.desktop\runtime\hermes-home\state.db`, while CC Switch looks only under `~/.hermes/` by default. CC Switch does not detect that path automatically yet, and there is no manual setting. Wait for a later update.

Is there a way to make CC Switch recognize the CN build path automatically?

Not currently. Issue #4648 asks for CC Switch to detect the CN build path automatically or expose `hermesConfigDir` in the UI for manual configuration, but the feature is not implemented yet.

Related problems

Codex provider API keys overwrite each other after a restart or switchEnable CC Switch local proxy takeover, or use experimental_bearer_token in config.toml, to bypass the auth.json sync defect.7 issues mergedThe Codex Desktop UI project list is completely empty - CodexCC Switch changed the model_provider key name. Set it back to custom, or upgrade. Lost official login and fewer reasoning tiers remain unresolved.4 issues mergedConsole Go: Upstream request failedThis 400 comes from the OpenCode Go gateway rejecting an incompatible payload. Restart the proxy to restore session mapping, or avoid WebSearch and images.3 issues merged