Locus Codegraph

From its catalog listing

Rehearse a Python refactor before making it, and catch missed callers when you do. @whatif:<symbol>(<new parameters>) or the locus_rehearse tool binds every statically proven caller against a proposed signature before any file is edited and lists which call sites would break and why. After an edit, the same check appends caller locations, binding errors and, for a renamed keyword, a caller patch to review to the editing tool's result. Covers functions, class constructors, static and class methods, methods on locally constructed instances, and calls inside the edited file, through direct and module-qualified imports, aliases and static re-exports. Receivers whose type is not in view (self, parameters, attributes), decorated callables and dynamic bindings are not checked; other supported languages receive structural indexing only. One local index also powers five tools, @sym:/@impact:/@hotspots: references, /locus commands, and Web Dashboard and Desktop caller inboxes. Suggested tests and impact scores are static heuristics, not execution coverage; no alert or predicted break is not proof of safety.

Good to know before installing

reads supported workspace source subject to exclusions and size caps, rejects symlink escapes, and stores structure, call shapes, and drift history in profile-scoped SQLite. Expands explicit references and adds diagnostics and proposed patches to editing-tool results and the configured model's context. Does not modify workspace source, apply patches, or run tests. No external network requests, credential access, shell subprocesses, background daemons, or additional runtime packages.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install locus-codegraph
  2. Said no? Turn it on later:
    hermes plugins enable locus-codegraph
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Coding & developer tools
Maintained by
atikur (Community)
Needs
No API keys declared
Adds tools
locus_map locus_rehearse locus_symbol locus_impact locus_hotspots
Adds hooks
on_session_start post_tool_call transform_tool_result
Needs Hermes
0.22.0 or newer
Version
0.2.0
In the catalog
2026-11-11
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in coding & developer tools

All coding & developer tools plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins