Skip to content

docs: note the stale global files HERMES_HOME leaves behind #2586

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dyoshikawa merged 2 commits into from
Aug 6, 2026
Merged

docs: note the stale global files HERMES_HOME leaves behind #2586

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
87de8f4
docs: note the stale global files HERMES_HOME leaves behind
cm-dyoshikawa Aug 6, 2026
f5f9911
docs: make the Hermes migration note version- and platform-accurate
cm-dyoshikawa Aug 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions docs/reference/supported-tools.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,15 @@ platform default: `~/.hermes` everywhere except Windows, where it is
the profile, it also takes precedence over `--output-roots` in global scope.
Project-scoped paths remain rooted in the project.

Changing which profile root Rulesync resolves strands whatever it generated
under the previous one. `--delete` reconciles only the root resolved for the
current run, so files under a root it no longer resolves are invisible to it and
must be removed by hand once you are sure Hermes no longer reads them. This
applies whenever you set or change `HERMES_HOME`, and to two upgrades that moved
the resolved root on their own: before v16.0.0 global files went to `~/.hermes`
even when `HERMES_HOME` was set, and before v16.2.0 they went there on Windows
too, rather than to `%LOCALAPPDATA%\hermes`.

Project plugins are registered by adding their names to
`$HERMES_HOME/config.yaml`, but Rulesync does not persist Hermes's global
project-plugin trust gate. Run Hermes from a trusted project root with
Expand Down
Loading
Loading