Herdr Jcode Integration

A community Herdr plugin that installs and manages Jcode's lifecycle reporter. Once configured, Herdr receives authoritative working, idle, session identity, ordering, and release events directly from Jcode hooks.

Requirements

• macOS or Linux
• Herdr 0.8.0 or newer, which includes the plugin marketplace interface
• The integration-enabled Jcode branch until the feature lands upstream: https://github.com/capt-marbles/jcode/tree/feat/herdr-integration

Test on another machine

Install Herdr and build Jcode:

curl -fsSL https://herdr.dev/install.sh | sh

git clone --branch feat/herdr-integration \
  https://github.com/capt-marbles/jcode.git
cd jcode
cargo build --release
export JCODE_BIN="$PWD/target/release/jcode"

Install this plugin directly from GitHub:

herdr plugin install capt-marbles/herdr-jcode-integration

Invoke its installer action:

herdr plugin action invoke capt-marbles.jcode-integration.install

If JCODE_BIN is not exported, put the integration-enabled jcode binary on PATH.

Start Herdr, open a pane, and run Jcode:

herdr
$JCODE_BIN

During a turn the pane should be identified as jcode and transition between working and idle. Exiting Jcode releases lifecycle authority.

Status and uninstall

herdr plugin action invoke capt-marbles.jcode-integration.status
herdr plugin action invoke capt-marbles.jcode-integration.uninstall
herdr plugin uninstall capt-marbles.jcode-integration

The Jcode installer preserves unrelated hook commands. Uninstall removes only the managed reporter and managed hook entries.

Local development

git clone https://github.com/capt-marbles/herdr-jcode-integration.git
cd herdr-jcode-integration
herdr plugin link "$PWD"
herdr plugin action list --plugin capt-marbles.jcode-integration

Marketplace

Herdr's marketplace automatically indexes public repositories carrying the herdr-plugin GitHub topic. Plugin installation executes ordinary repository code as your user, so review the manifest and scripts before installing.

License

MIT