AI Helper Plugins - Help

Isurus publishes two plugins that teach AI coding assistants to work with Mercurial and the Isurus forge. Both are named isurus-hg once installed, and both are hosted as Mercurial repositories in the isurus organization:

Plugin	Repository	Status
Grok plugin	`isurus/isurus-grok-plugin`	The actively developed plugin. Includes forge and CI skills.
Claude plugin	`isurus/isurus-claude-plugin`	Early (v0.1.x) and incomplete. Mercurial and product-overlay skills only.

What They Do

Skills that load when relevant and teach the assistant to:
- use Mercurial correctly: status, diff, log, commit, phases, bookmarks as the unit of feature work and pull requests, pull/update/merge, and safe history rewriting (draft changesets only);
- finish a branch: a pre-PR checklist, push, and a CI status check;
- prefer the Isurus CLI (isu) for reading and filing issues and reading CI status, when isu is installed and signed in;
- follow the Isurus product repository's house rules (the isurus-conventions overlay).
The Grok plugin adds two more skills: isurus-forge (multi-VCS forge workflows: pull requests, issues, API scopes) and isurus-ci (writing and debugging .isurus-ci.yml). In the Grok plugin, slash commands match skill names, for example /mercurial-basics.
A safety hook (block-git-in-hg.sh) that runs before each shell command the assistant issues. If the command starts with git and the closest repository is a Mercurial (.hg) one, the command is blocked and an hg equivalent is suggested. Git repositories, bare Git repositories, and commands outside any repository are allowed. Only the first word of the command is checked.

Requirements

Mercurial (the Claude plugin expects 7.x; the Grok plugin needs 6.0 or later, 7.x recommended)
jq on your PATH and Bash 4+ for the hook. If jq is missing, the hook lets commands through and prints a warning.

Install the Grok Plugin

Clone the plugin:

hg clone https://leafscale.isurus.dev/isurus/isurus-grok-plugin

Install, enable, and check it (replace <clone> with the absolute path of the clone):

grok plugin install <clone> --trust
grok plugin enable isurus-hg
grok plugin details isurus-hg

Install the Claude Plugin

Clone the plugin:

hg clone https://leafscale.isurus.dev/isurus/isurus-claude-plugin

Load it for one session (replace <clone> with the absolute path of the clone):
```
claude --plugin-dir <clone>
```
To load it in every session, register a local marketplace: create .claude-plugin/marketplace.json in the directory that contains the clone (the plugin's README shows the file), then run inside the assistant:
```
/plugin marketplace add <parent-of-clone>
/plugin install isurus-hg@local-isurus
```

Updating

Pull the latest changes into your clone:

cd <clone>
hg pull -u

Grok: reload plugins in the TUI (Ctrl+L → Plugins → r) or start a new session.
Claude: restart the assistant. With the marketplace install, also run /plugin marketplace update local-isurus.