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
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install locus-codegraph - Said no? Turn it on later:
hermes plugins enable locus-codegraph - 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_maplocus_rehearselocus_symbollocus_impactlocus_hotspots- Adds hooks
on_session_startpost_tool_calltransform_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

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