gm-kilo 2.0.1060 → 2.0.1061

package/README.md

@@ -4,97 +4,59 @@
 
 ### One-liner (recommended)
 
-Install directly from npm using bun x:
+Install directly from npm:
 
 ```bash
 bun x gm-kilo@latest
 ```
 
-This command will automatically install gm-kilo to the correct location for your platform and restart Kilo to activate.
+This copies the plugin to `~/.config/kilo/` and registers it in your config. Restart Kilo to activate.
 
-### Manual installation
+### Via npm install
 
-**Windows and Unix:**
 ```bash
-git clone https://github.com/AnEntrypoint/gm-kilo ~/.config/kilo/plugin && cd ~/.config/kilo/plugin && bun install
-```
-
-**Windows PowerShell:**
-```powershell
-git clone https://github.com/AnEntrypoint/gm-kilo "\$env:APPDATA\kilo\plugin" && cd "\$env:APPDATA\kilo\plugin" && bun install
-```
-
-### Step 2: Configure MCP Servers
-
-Kilo uses the OpenCode configuration format. Create or update `~/.config/kilo/opencode.json`:
-
-```json
-{
-  "\$schema": "https://opencode.ai/config.json",
-  "mcp": {
-    "dev": {
-      "type": "local",
-      "command": ["bun x", "mcp-gm"],
-      "timeout": 360000,
-      "enabled": true
-    },
-    "code-search": {
-      "type": "local",
-      "command": ["bun x", "codebasesearch"],
-      "timeout": 360000,
-      "enabled": true
-    }
-  }
-}
-```
-
-### Step 3: Update Kilo Configuration
-
-Update `~/.config/kilo/kilocode.json` to reference the plugin:
-
-```json
-{
-  "\$schema": "https://kilo.ai/config.json",
-  "default_agent": "gm",
-  "plugin": ["/home/user/.config/kilo/plugin"]
-}
+npm install -g gm-kilo
+gm-kilo
 ```
 
-Replace `/home/user` with your actual home directory path.
+### Manual installation
 
-### Step 4: Verify Installation
+Clone to the global plugin directory:
 
-Start Kilo and verify the tools appear:
 ```bash
-kilo
+git clone https://github.com/AnEntrypoint/gm-kilo ~/.config/kilo/plugin
 ```
 
-Check MCP tools are connected:
-```bash
-kilo mcp list
-```
+## Features
 
-You should see `dev` and `code-search` marked as connected.
+- **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
 
-## Features
+## 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-kilo.mjs`) — hooks for session lifecycle, tool gating, exec: dispatch
+- **Lang runners** (`lang/`) — language-specific execution plugins
 
-- **MCP tools** - Code execution (`dev`) and semantic search (`code-search`)
-- **State machine agent** - Complete `gm` behavioral rule system
-- **Git enforcement** - Blocks uncommitted changes and unpushed commits on session idle
-- **AST analysis** - Automatic codebase analysis via mcp-thorns on session start
-- **.prd enforcement** - Blocks exit if work items remain in .prd file
+All exec: commands route through the spool watcher at `.gm/exec-spool/` for session-isolated task execution.
 
 ## Troubleshooting
 
-**MCP tools not appearing:**
-- Verify `~/.config/kilo/opencode.json` exists with correct MCP server definitions
-- Check that `plugin` path in `kilocode.json` points to the correct directory
-- Run `kilo mcp list` to verify servers are connected
+**Plugin not loading:**
+- Verify `~/.config/kilo/plugins/gm-kilo.mjs` exists
+- Check `kilocode.json` has the plugin path in the `plugin` array
 - Restart Kilo CLI completely
 
-**Plugin not loading:**
-- Verify plugin path in `kilocode.json` is absolute (e.g., `/home/user/.config/kilo/plugin`, not relative)
-- Check `index.js` and `gm.mjs` exist in the plugin directory
-- Run `bun install` in the plugin directory to ensure dependencies are installed
+**Skills not appearing:**
+- Verify `~/.config/kilo/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 once MCP servers are configured.
+**exec: commands failing:**
+- Check `.gm/exec-spool/` directory exists in your project
+- Verify plugkit binary is present at `~/.config/kilo/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

package/cli.js

@@ -36,19 +36,24 @@ try {
   copyRecursive(path.join(srcDir, 'scripts'), path.join(kiloConfigDir, 'scripts'));
 
   const kiloJsonPath = path.join(kiloConfigDir, 'kilocode.json');
+  const configExisted = fs.existsSync(kiloJsonPath);
   let kiloConfig = {};
-  try {
-    const raw = fs.readFileSync(kiloJsonPath, 'utf-8');
-    kiloConfig = JSON.parse(raw);
-    if (kiloConfig['']) { delete kiloConfig['']; }
-  } catch (e) {}
-  delete kiloConfig.mcp;
-  kiloConfig['$schema'] = 'https://kilo.ai/config.json';
-  kiloConfig.default_agent = 'gm';
+  if (configExisted) {
+    try {
+      const raw = fs.readFileSync(kiloJsonPath, 'utf-8');
+      kiloConfig = JSON.parse(raw);
+      if (kiloConfig['']) { delete kiloConfig['']; }
+    } catch (e) {}
+  }
+  if (!configExisted) {
+    kiloConfig['$schema'] = 'https://kilo.ai/config.json';
+    kiloConfig.default_agent = 'gm';
+  }
   const kiloPluginPath = path.join(kiloConfigDir, 'plugins', 'gm-kilo.mjs');
   if (!Array.isArray(kiloConfig.plugin)) kiloConfig.plugin = [];
-  kiloConfig.plugin = kiloConfig.plugin.filter(p => !p.includes('gm-kilo'));
-  kiloConfig.plugin.push(kiloPluginPath);
+  if (!kiloConfig.plugin.some(p => typeof p === 'string' && p.includes('gm-kilo'))) {
+    kiloConfig.plugin.push(kiloPluginPath);
+  }
   fs.writeFileSync(kiloJsonPath, JSON.stringify(kiloConfig, null, 2) + '\n');
 
   const oldDir = process.platform === 'win32'

package/gm-kilo.mjs

@@ -57,6 +57,14 @@ export async function GmPlugin({ directory }) {
   const injectedSessions = new Set();
 
   return {
+    'session.created': async () => {
+      if (!sessionStarted) {
+        sessionStarted = true;
+        try { runPlugkit(['hook', 'session-start']); } catch(e) {}
+        try { runPlugkit(['bootstrap', directory]); } catch(e) {}
+      }
+    },
+
     'experimental.chat.system.transform': async (input, output) => {
       const gmDir = join(directory, '.gm');
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-kilo",
-  "version": "2.0.1060",
+  "version": "2.0.1061",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "author": "AnEntrypoint",
   "license": "MIT",
@@ -30,9 +30,6 @@
     "access": "public"
   },
   "dependencies": {},
-  "scripts": {
-    "postinstall": "node scripts/postinstall-kilo.js"
-  },
   "files": [
     "agents/",
     "bin/",

package/skills/gm/SKILL.md

@@ -2,17 +2,6 @@
 name: gm
 description: Orchestrator dispatching PLAN→EXECUTE→EMIT→VERIFY→UPDATE-DOCS skill chain; spool-driven task execution with session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-cc
-  - gm-gc
-  - gm-oc
-  - gm-kilo
-  - gm-codex
-  - gm-copilot-cli
-  - gm-vscode
-  - gm-cursor
-  - gm-zed
-  - gm-jetbrains
 end-to-end: true
 ---
 

package/skills/gm-cc/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-cc
 description: AI-native software engineering via skill-driven orchestration on cc; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-cc
 ---
 
 # GM — cc Platform

package/skills/gm-codex/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-codex
 description: AI-native software engineering via skill-driven orchestration on codex; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-codex
 ---
 
 # GM — codex Platform

package/skills/gm-copilot-cli/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-copilot-cli
 description: AI-native software engineering via skill-driven orchestration on copilot-cli; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-copilot-cli
 ---
 
 # GM — copilot-cli Platform

package/skills/gm-cursor/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-cursor
 description: AI-native software engineering via skill-driven orchestration on cursor; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-cursor
 ---
 
 # GM — cursor Platform

package/skills/gm-gc/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-gc
 description: AI-native software engineering via skill-driven orchestration on gc; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-gc
 ---
 
 # GM — gc Platform

package/skills/gm-jetbrains/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-jetbrains
 description: AI-native software engineering via skill-driven orchestration on jetbrains; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-jetbrains
 ---
 
 # GM — jetbrains Platform

package/skills/gm-kilo/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-kilo
 description: AI-native software engineering via skill-driven orchestration on kilo; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-kilo
 ---
 
 # GM — kilo Platform

package/skills/gm-oc/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-oc
 description: AI-native software engineering via skill-driven orchestration on oc; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-oc
 ---
 
 # GM — oc Platform

package/skills/gm-vscode/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-vscode
 description: AI-native software engineering via skill-driven orchestration on vscode; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-vscode
 ---
 
 # GM — vscode Platform

package/skills/gm-zed/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-zed
 description: AI-native software engineering via skill-driven orchestration on zed; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-zed
 ---
 
 # GM — zed Platform