gm-oc 2.0.1059 → 2.0.1061

package/README.md

@@ -4,38 +4,59 @@
 
 ### One-liner (recommended)
 
-Install directly from npm using bun x:
+Install directly from npm:
 
 ```bash
 bun x gm-oc@latest
 ```
 
-This command will automatically install gm-oc to the correct location for your platform and restart OpenCode to activate.
+This copies the plugin to `~/.config/opencode/` and registers it in your config. Restart OpenCode to activate.
 
-### Manual installation
+### Via npm install
 
-**Windows and Unix:**
 ```bash
-git clone https://github.com/AnEntrypoint/gm-oc ~/.config/opencode/plugin && cd ~/.config/opencode/plugin && bun install
+npm install -g gm-oc
+gm-oc
 ```
 
-**Windows PowerShell:**
-```powershell
-git clone https://github.com/AnEntrypoint/gm-oc "\$env:APPDATA\opencode\plugin" && cd "\$env:APPDATA\opencode\plugin" && bun install
-```
+### Manual installation
 
-### Project-level
+Clone to the global plugin directory:
 
-**Windows and Unix:**
 ```bash
-git clone https://github.com/AnEntrypoint/gm-oc .opencode/plugins && cd .opencode/plugins && bun install
+git clone https://github.com/AnEntrypoint/gm-oc ~/.config/opencode/plugin
 ```
 
 ## Features
 
-- MCP tools for code execution and search
-- State machine agent policy (gm)
-- Git enforcement on session idle
-- AST analysis via thorns at session start
+- **State machine agent** — PLAN→EXECUTE→EMIT→VERIFY→COMPLETE orchestration
+- **Skill chain** — gm, planning, gm-execute, gm-emit, gm-complete, update-docs
+- **exec: dispatch** — code execution via spool watcher (nodejs, python, bash, typescript, go, rust)
+- **Code search** — semantic codebase exploration via exec:codesearch
+- **Git enforcement** — blocks session end with uncommitted changes or unpushed commits
+- **Memory** — rs-learn integration for cross-session knowledge retention
+
+## How it works
+
+The plugin installs:
+- **Agent** (`agents/gm.md`) — primary orchestrator with skill-chain instructions
+- **Skills** (`skills/`) — PLAN, EXECUTE, EMIT, VERIFY, UPDATE-DOCS skill definitions
+- **Plugin** (`plugins/gm-oc.mjs`) — hooks for session lifecycle, tool gating, exec: dispatch
+- **Lang runners** (`lang/`) — language-specific execution plugins
+
+All exec: commands route through the spool watcher at `.gm/exec-spool/` for session-isolated task execution.
+
+## Troubleshooting
+
+**Plugin not loading:**
+- Verify `~/.config/opencode/plugins/gm-oc.mjs` exists
+- Check `opencode.json` has the plugin path in the `plugin` array
+- Restart OpenCode completely
+
+**Skills not appearing:**
+- Verify `~/.config/opencode/skills/` contains skill directories with SKILL.md files
+- Skill names must be lowercase with hyphens (e.g., `gm`, `gm-execute`)
 
-The plugin activates automatically on session start.
+**exec: commands failing:**
+- Check `.gm/exec-spool/` directory exists in your project
+- Verify plugkit binary is present at `~/.config/opencode/bin/`

package/agents/gm.md

@@ -1,6 +1,6 @@
 ---
-name: gm
 description: Agent (not skill) - immutable programming state machine. Always invoke for all work coordination.
+mode: primary
 ---
 
 # GM — Skill-First Orchestrator