Installation

Choose the host contract that matches your agent. The commands below are advertised by the released README; all coverage remains advertised and unverified until separate installation observation exists. The released README does not document rollback instructions for these hosts.

Compact host matrix

The released README advertises these contracts; the Observation column records the verification state of each row.

Host	Install model	Hook coverage	Observation
Claude Code	Plugin from local checkout	Partial: session start and stop	Advertised, unverified
Codex	Plugin from local checkout	Partial: session start and stop	Advertised, unverified
Grok Build	Plugin from local checkout	Partial: session start and stop	Advertised, unverified
Cursor	UI plugin	Partial; no verified CLI install	Advertised, unverified
Kimi Code	TUI plugin	Partial; no kimi plugin CLI	Advertised, unverified
GitHub Copilot in VS Code	Plugin from source	Partial plus PreToolUse, Stop, SubagentStop channels	Advertised, unverified
GitHub Copilot CLI	Plugin	Partial plus Test Engineering channels	Advertised, unverified
Qwen Code	Published extension	Skills-only; no Qwen hook namespace	Advertised, unverified
AGY	Skills-only .agy root	No command hooks	Advertised, unverified
Pi	Published skills package	No command hooks	Advertised, unverified
DeepCode	Skills-directory copy	No plugin or command-hook surface	Advertised, unverified
Muse Code	Per-skill install	No plugin subsystem or command hooks	Advertised, unverified

What stays procedural on every host

Transition order, protected action, planning review, and assurance budget stay procedural on every host. Node.js must be on PATH for hook adapters.

Plugin clients with partial hooks

Claude Code, Codex, and Grok Build install from a local checkout. Their session-start activation and stop closeout hooks are partial client coverage.

# Claude Code
claude plugin marketplace add /path/to/bearing-lite
claude plugin install bearing-lite@bearing-lite

# Codex
codex plugin marketplace add /path/to/bearing-lite
codex plugin add bearing-lite@bearing-lite

# Grok Build
grok plugin marketplace add /path/to/bearing-lite
grok plugin install bearing-lite --trust

UI and TUI plugin clients

Cursor installs from Customize for a project or user scope. Its shipped layout is .cursor-plugin/; for a local checkout, link it into Cursor’s documented local-plugin directory, then restart Cursor or run Developer: Reload Window.

mkdir -p ~/.cursor/plugins/local
ln -s /path/to/bearing-lite ~/.cursor/plugins/local/bearing-lite

Kimi Code installs through its TUI and has no kimi plugin CLI.

/plugins install /path/to/bearing-lite

GitHub Copilot in VS Code installs with Chat: Install Plugin From Source and a repository URL such as https://github.com/alphazede/bearing-lite. Its documented Test Engineering channels are PreToolUse, Stop, and SubagentStop.

CLI plugin clients

GitHub Copilot CLI requires Node.js 22 or later. Qwen Code accepts the published Agent Plugins package directly.

# GitHub Copilot CLI
npm install -g @github/copilot
copilot plugin marketplace add alphazede/bearing-lite
copilot plugin install bearing-lite@bearing-lite

# Qwen Code
qwen extensions install @alphazede/bearing-lite

Qwen is skills-only and ships no Qwen-specific hook namespace.

Skills-only clients

Skills-only installation remains first-class but does not register command hooks.

# AGY: install the .agy root, not the repository root
agy plugin install /path/to/bearing-lite/.agy

# Pi: published skills package
pi install npm:@alphazede/bearing-lite

# Muse Code: install each skill
for skill in /path/to/bearing-lite/skills/*/SKILL.md; do
  muse skills install "$(dirname "$skill")" --scope user
done

DeepCode has no plugin-install or command-hook surface. Copy skills/ into ~/.deepcode/skills or ~/.agents/skills.

Source

• Released README installation surface