clikit-plugin 0.1.2 → 0.1.6

package/README.md

@@ -16,22 +16,21 @@ Curated agents, commands, skills, and memory system for OpenCode.
 
 ## Installation
 
-### Option 1: Via npm (Recommended)
-
 ```bash
-# In your project
-bun add -d clikit-plugin
+# Install CliKit globally for OpenCode
+bun x clikit-plugin install
 
-# Create .opencode/index.ts
-echo 'import CliKitPlugin from "clikit-plugin";
-export default CliKitPlugin;' > .opencode/index.ts
+# Restart OpenCode
 ```
 
-### Option 2: Direct Copy
+That's it! The plugin will be registered in `~/.config/opencode/opencode.json`.
 
-```bash
-# Copy the built plugin to OpenCode plugin directory
-cp dist/index.js ~/.config/opencode/plugin/clikit-plugin.js
+## Quick Start
+
+After installation, use these commands:
+
+```
+/create → /plan → /start → /verify → /ship
 ```
 
 ## Configuration
@@ -80,7 +79,7 @@ Project config overrides user config.
     "session_notification": { "enabled": true },
     "truncator": { "enabled": true },
     "compaction": { "enabled": true },
-    "swarm_enforcer": { "enabled": false }
+    "swarm_enforcer": { "enabled": true }
   }
 }
 ```
@@ -112,7 +111,7 @@ Project config overrides user config.
 | `session_notification` | on | Desktop notifications on idle/error (Linux/macOS/Windows) |
 | `truncator` | on | Truncates large outputs to prevent context overflow |
 | `compaction` | on | Preserves beads state + memory during context compaction |
-| `swarm_enforcer` | **off** | Enforces task isolation in multi-agent swarms |
+| `swarm_enforcer` | on | Enforces task isolation in multi-agent swarms |
 
 ## Agents
 

package/dist/cli.js

@@ -4,73 +4,133 @@
 // src/cli.ts
 import * as fs from "fs";
 import * as path from "path";
-var VERSION = "0.1.0";
-function getCwd() {
-  return process.cwd();
+import * as os from "os";
+var PLUGIN_NAME = "clikit-plugin";
+var VERSION = "0.1.4";
+function getConfigDir() {
+  if (process.platform === "win32") {
+    return path.join(process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming"), "opencode");
+  }
+  return path.join(process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config"), "opencode");
 }
-async function install() {
-  const cwd = getCwd();
-  const opencodeDir = path.join(cwd, ".opencode");
-  console.log(`\uD83D\uDE80 Installing CliKit...
-`);
-  if (!fs.existsSync(opencodeDir)) {
-    fs.mkdirSync(opencodeDir, { recursive: true });
-    console.log("\u2705 Created .opencode directory");
+function getConfigPath() {
+  const configDir = getConfigDir();
+  const jsonPath = path.join(configDir, "opencode.json");
+  const jsoncPath = path.join(configDir, "opencode.jsonc");
+  if (fs.existsSync(jsonPath))
+    return jsonPath;
+  if (fs.existsSync(jsoncPath))
+    return jsoncPath;
+  return jsonPath;
+}
+function ensureConfigDir() {
+  const configDir = getConfigDir();
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true });
+  }
+}
+function parseConfig(configPath) {
+  try {
+    if (!fs.existsSync(configPath)) {
+      return {};
+    }
+    const content = fs.readFileSync(configPath, "utf-8");
+    const cleaned = content.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
+    return JSON.parse(cleaned);
+  } catch {
+    return {};
   }
-  const indexPath = path.join(opencodeDir, "index.ts");
-  if (!fs.existsSync(indexPath)) {
-    fs.writeFileSync(indexPath, `import CliKitPlugin from "clikit-plugin";
-export default CliKitPlugin;
+}
+function writeConfig(configPath, config) {
+  ensureConfigDir();
+  const tmpPath = `${configPath}.tmp`;
+  const content = JSON.stringify(config, null, 2) + `
+`;
+  fs.writeFileSync(tmpPath, content);
+  fs.renameSync(tmpPath, configPath);
+}
+async function install() {
+  console.log(`
+  CliKit Installer
+  ================
 `);
-    console.log("\u2705 Created .opencode/index.ts");
-  } else {
-    console.log("\u2139\uFE0F  .opencode/index.ts already exists");
+  console.log("[1/3] Adding CliKit plugin to OpenCode config...");
+  try {
+    ensureConfigDir();
+  } catch (err) {
+    console.error(`\u2717 Failed to create config directory: ${err}`);
+    return 1;
   }
-  const configPath = path.join(opencodeDir, "clikit.config.json");
-  if (!fs.existsSync(configPath)) {
-    fs.writeFileSync(configPath, JSON.stringify({
-      $schema: "https://unpkg.com/clikit-plugin/schema.json",
-      disabled_agents: [],
-      disabled_commands: [],
-      agents: {},
-      hooks: {}
-    }, null, 2));
-    console.log("\u2705 Created .opencode/clikit.config.json");
-  } else {
-    console.log("\u2139\uFE0F  .opencode/clikit.config.json already exists");
+  const configPath = getConfigPath();
+  try {
+    const config = parseConfig(configPath) || {};
+    const plugins = config.plugin || [];
+    const filteredPlugins = plugins.filter((p) => p !== PLUGIN_NAME && !p.startsWith(`${PLUGIN_NAME}@`));
+    filteredPlugins.push(PLUGIN_NAME);
+    config.plugin = filteredPlugins;
+    writeConfig(configPath, config);
+    console.log(`\u2713 Plugin added to ${configPath}`);
+  } catch (err) {
+    console.error(`\u2717 Failed to update OpenCode config: ${err}`);
+    return 1;
   }
-  const memoryDir = path.join(opencodeDir, "memory");
+  console.log(`
+[2/3] Creating memory directories...`);
+  const memoryDir = path.join(getConfigDir(), "memory");
   const memorySubdirs = ["specs", "plans", "research", "reviews", "handoffs", "beads", "prds"];
   for (const subdir of memorySubdirs) {
     const dir = path.join(memoryDir, subdir);
     if (!fs.existsSync(dir)) {
       fs.mkdirSync(dir, { recursive: true });
-      console.log(`\u2705 Created .opencode/memory/${subdir}/`);
     }
   }
+  console.log(`\u2713 Memory directories created in ${memoryDir}`);
   console.log(`
-\u2705 CliKit installed successfully!`);
+[3/3] Creating CliKit config...`);
+  const clikitConfigPath = path.join(getConfigDir(), "clikit.config.json");
+  if (!fs.existsSync(clikitConfigPath)) {
+    const defaultConfig = {
+      $schema: `https://unpkg.com/${PLUGIN_NAME}@latest/schema.json`,
+      disabled_agents: [],
+      disabled_commands: [],
+      agents: {},
+      hooks: {}
+    };
+    writeConfig(clikitConfigPath, defaultConfig);
+    console.log(`\u2713 Config created at ${clikitConfigPath}`);
+  } else {
+    console.log(`\u2713 Config already exists at ${clikitConfigPath}`);
+  }
   console.log(`
-Next steps:`);
-  console.log("  1. Run: bun add -d clikit-plugin");
-  console.log("  2. Restart OpenCode");
+\u2713 CliKit installed successfully!
+`);
+  console.log("Available commands:");
+  console.log("  /create   - Start new task with specification");
+  console.log("  /start    - Begin implementing from plan");
+  console.log("  /plan     - Create implementation plan");
+  console.log("  /verify   - Run verification suite");
+  console.log("  /ship     - Commit, PR, and cleanup");
+  console.log("  /review   - Request code review");
+  console.log("  /debug    - Debug issues");
   console.log(`
-Available commands: /create, /start, /plan, /ship, /verify, /review, /debug, /pr`);
+Restart OpenCode to use CliKit.
+`);
+  return 0;
 }
 function help() {
   console.log(`
 CliKit - OpenCode Plugin
 
 Usage:
-  clikit <command>
+  bun x clikit-plugin <command>
 
 Commands:
-  install     Install CliKit in current project
+  install     Install CliKit globally for OpenCode
   help        Show this help message
   version     Show version
 
 Examples:
-  bunx clikit install
+  bun x clikit-plugin install
 `);
 }
 function version() {
@@ -79,10 +139,11 @@ function version() {
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0] || "help";
+  let exitCode = 0;
   switch (command) {
     case "install":
     case "i":
-      await install();
+      exitCode = await install();
       break;
     case "help":
     case "-h":
@@ -97,7 +158,11 @@ async function main() {
     default:
       console.error(`Unknown command: ${command}`);
       help();
-      process.exit(1);
+      exitCode = 1;
   }
+  process.exit(exitCode);
 }
-main().catch(console.error);
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clikit-plugin",
-  "version": "0.1.2",
+  "version": "0.1.6",
   "description": "OpenCode plugin with 10 agents, 19 commands, 48 skills, 14 hooks",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,7 +21,8 @@
     "skill",
     "command",
     "memory",
-    "AGENTS.md"
+    "AGENTS.md",
+    "README.md"
   ],
   "scripts": {
     "build": "bun build src/index.ts src/cli.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly && cp src/clikit.schema.json dist/",
@@ -51,7 +52,7 @@
   },
   "homepage": "https://github.com/KiraKas-Tr/CliKit#readme",
   "dependencies": {
-    "@opencode-ai/plugin": "1.1.64",
+    "@opencode-ai/plugin": "1.2.1",
     "gray-matter": "^4.0.3"
   },
   "devDependencies": {