@cardor/agent-harness-kit 2.0.0 → 2.1.0

package/dist/cli.js

@@ -380,6 +380,17 @@ function mergeCodexConfigToml(filePath, port, cwd2, pm = "npm") {
   content = mergeTomlSection(content, "mcp_servers.agent-harness-kit", sectionBody);
   writeFileSync2(filePath, content, "utf8");
 }
+function mergeGrokConfigToml(filePath, port, cwd2, pm = "npm") {
+  mkdirSync2(dirname2(filePath), { recursive: true });
+  let content = "";
+  if (existsSync4(filePath)) {
+    content = readFileSync3(filePath, "utf8");
+  }
+  const [command, ...args] = getMcpCommandParts(pm, port, cwd2);
+  const sectionBody = [`command = ${JSON.stringify(command)}`, `args = ${JSON.stringify(args)}`].join("\n");
+  content = mergeTomlSection(content, "mcp_servers.agent-harness-kit", sectionBody);
+  writeFileSync2(filePath, content, "utf8");
+}
 
 // src/core/materializer/scaffold-utils.ts
 import { createHash } from "crypto";
@@ -420,6 +431,9 @@ These tools may still appear available to you. The sandbox will reject the call.
 function codexRestrictionNotice(agentName) {
   return restrictionFor(agentName) === "no-write" ? CODEX_READ_ONLY_NOTICE : "";
 }
+function grokToolsAllowlist(agentName) {
+  return restrictionFor(agentName) === "no-write" ? ["Bash", "Read", "NotebookRead", "Grep", "Glob", "WebFetch", "WebSearch", "search_tool", "use_tool"] : [];
+}
 
 // src/core/materializer/templates.ts
 var __dirname = dirname3(fileURLToPath2(import.meta.url));
@@ -849,6 +863,11 @@ function translateFrontmatterForOpenCode(md, agentName) {
   result = stripFrontmatterBlockSequence(result, "disallowedTools");
   return appendFrontmatterMapping(result, "permission", opencodePermissions(agentName));
 }
+function translateFrontmatterForGrok(md, agentName) {
+  let result = stripFrontmatterBlockSequence(md, "tools");
+  result = stripFrontmatterBlockSequence(result, "disallowedTools");
+  return appendFrontmatterBlockSequence(result, "tools", grokToolsAllowlist(agentName));
+}
 var GITIGNORE_ENTRIES = `
 # agent-harness-kit
 .harness/harness.db
@@ -1163,9 +1182,73 @@ No tasks in progress.
   }
 };
 
-// src/core/materializer/opencode.ts
+// src/core/materializer/grok.ts
 import { existsSync as existsSync8, mkdirSync as mkdirSync5, writeFileSync as writeFileSync5 } from "fs";
 import { join as join9, resolve as resolve4 } from "path";
+function grokAgentFiles(config) {
+  const projectName = config.project.name;
+  return [
+    { relPath: ".grok/agents/lead.md", content: translateFrontmatterForGrok(agentLead({ projectName }), "lead") },
+    { relPath: ".grok/agents/explorer.md", content: translateFrontmatterForGrok(agentExplorer({ projectName }), "explorer") },
+    { relPath: ".grok/agents/consultant.md", content: translateFrontmatterForGrok(agentConsultant({ projectName }), "consultant") },
+    { relPath: ".grok/agents/builder.md", content: translateFrontmatterForGrok(agentBuilder({ projectName }), "builder") },
+    { relPath: ".grok/agents/reviewer.md", content: translateFrontmatterForGrok(agentReviewer({ projectName }), "reviewer") }
+  ];
+}
+var GrokMaterializer = class {
+  async scaffold(config, opts) {
+    const { cwd: cwd2 } = opts;
+    const write2 = (relPath, content, mode) => {
+      const abs = join9(cwd2, relPath);
+      mkdirSync5(resolve4(abs, ".."), { recursive: true });
+      writeFileSync5(abs, content, { encoding: "utf8", mode });
+    };
+    write2("AGENTS.md", stampGenerated(agentsMd(config)));
+    if (!existsSync8(join9(cwd2, "health.sh"))) {
+      write2("health.sh", HEALTH_SH, 493);
+    }
+    if (config.storage.scope === "local" && !existsSync8(join9(cwd2, config.storage.markdownFallback.path))) {
+      write2(
+        config.storage.markdownFallback.path,
+        `<!-- AUTO-GENERATED by agent-harness-kit \u2014 DO NOT EDIT MANUALLY -->
+<!-- Run ahk status to refresh -->
+
+# Current Session
+
+No tasks in progress.
+`
+      );
+    }
+    writeAgentFiles(cwd2, grokAgentFiles(config));
+    mergeGrokConfigToml(join9(cwd2, ".grok/config.toml"), config.tools.mcp.port, cwd2, detectPackageManager(cwd2));
+    appendGitignore(cwd2);
+    writeSkills(cwd2, ".grok/skills");
+  }
+  async build(config, cwd2, opts = {}) {
+    const derived = reconcileGeneratedFiles(
+      cwd2,
+      [{ relPath: "AGENTS.md", content: agentsMd(config) }],
+      { force: opts.force, backupRoot: join9(cwd2, config.storage.dir, "backups") }
+    );
+    const agents = writeAgentFiles(cwd2, grokAgentFiles(config), {
+      force: opts.force,
+      backupRoot: join9(cwd2, config.storage.dir, "backups")
+    });
+    mergeGrokConfigToml(join9(cwd2, ".grok/config.toml"), config.tools.mcp.port, cwd2, detectPackageManager(cwd2));
+    writeSkills(cwd2, ".grok/skills");
+    return { agents, derived };
+  }
+  async migrate(config, _to, _cwd) {
+    void config;
+  }
+  async syncPermissions(_cwd) {
+    console.log("  Permissions sync not needed for grok-cli \u2014 skipping");
+  }
+};
+
+// src/core/materializer/opencode.ts
+import { existsSync as existsSync9, mkdirSync as mkdirSync6, writeFileSync as writeFileSync6 } from "fs";
+import { join as join10, resolve as resolve5 } from "path";
 function opencodeAgentFiles(config) {
   const projectName = config.project.name;
   return [
@@ -1180,15 +1263,15 @@ var OpenCodeMaterializer = class {
   async scaffold(config, opts) {
     const { cwd: cwd2 } = opts;
     const write2 = (relPath, content, mode) => {
-      const abs = join9(cwd2, relPath);
-      mkdirSync5(resolve4(abs, ".."), { recursive: true });
-      writeFileSync5(abs, content, { encoding: "utf8", mode });
+      const abs = join10(cwd2, relPath);
+      mkdirSync6(resolve5(abs, ".."), { recursive: true });
+      writeFileSync6(abs, content, { encoding: "utf8", mode });
     };
     write2("AGENTS.md", stampGenerated(agentsMd(config)));
-    if (!existsSync8(join9(cwd2, "health.sh"))) {
+    if (!existsSync9(join10(cwd2, "health.sh"))) {
       write2("health.sh", HEALTH_SH, 493);
     }
-    if (config.storage.scope === "local" && !existsSync8(join9(cwd2, config.storage.markdownFallback.path))) {
+    if (config.storage.scope === "local" && !existsSync9(join10(cwd2, config.storage.markdownFallback.path))) {
       write2(
         config.storage.markdownFallback.path,
         `<!-- AUTO-GENERATED by agent-harness-kit \u2014 DO NOT EDIT MANUALLY -->
@@ -1201,7 +1284,7 @@ No tasks in progress.
       );
     }
     writeAgentFiles(cwd2, opencodeAgentFiles(config));
-    mergeOpencodeJson(join9(cwd2, "opencode.json"), config.tools.mcp.port, cwd2, detectPackageManager(cwd2));
+    mergeOpencodeJson(join10(cwd2, "opencode.json"), config.tools.mcp.port, cwd2, detectPackageManager(cwd2));
     appendGitignore(cwd2);
     writeSkills(cwd2, ".opencode/skills");
   }
@@ -1209,13 +1292,13 @@ No tasks in progress.
     const derived = reconcileGeneratedFiles(
       cwd2,
       [{ relPath: "AGENTS.md", content: agentsMd(config) }],
-      { force: opts.force, backupRoot: join9(cwd2, config.storage.dir, "backups") }
+      { force: opts.force, backupRoot: join10(cwd2, config.storage.dir, "backups") }
     );
     const agents = writeAgentFiles(cwd2, opencodeAgentFiles(config), {
       force: opts.force,
-      backupRoot: join9(cwd2, config.storage.dir, "backups")
+      backupRoot: join10(cwd2, config.storage.dir, "backups")
     });
-    mergeOpencodeJson(join9(cwd2, "opencode.json"), config.tools.mcp.port, cwd2, detectPackageManager(cwd2));
+    mergeOpencodeJson(join10(cwd2, "opencode.json"), config.tools.mcp.port, cwd2, detectPackageManager(cwd2));
     writeSkills(cwd2, ".opencode/skills");
     return { agents, derived };
   }
@@ -1236,6 +1319,8 @@ function getMaterializer(provider) {
       return new OpenCodeMaterializer();
     case "codex-cli":
       return new CodexCliMaterializer();
+    case "grok-cli":
+      return new GrokMaterializer();
     default:
       throw new Error(`Unknown provider: ${provider}`);
   }
@@ -1335,14 +1420,14 @@ async function buildOnce(cwd2, force) {
 
 // src/commands/dashboard.ts
 import { homedir } from "os";
-import { dirname as dirname5, join as join11 } from "path";
+import { dirname as dirname5, join as join12 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import pc3 from "picocolors";
 
 // src/core/dashboard-server.ts
 import { watch as watch2 } from "fs";
-import { existsSync as existsSync9, readFileSync as readFileSync6 } from "fs";
-import { extname, join as join10 } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync6 } from "fs";
+import { extname, join as join11 } from "path";
 import { serve } from "@hono/node-server";
 import { Hono } from "hono";
 import { WebSocketServer } from "ws";
@@ -1351,11 +1436,11 @@ import { WebSocketServer } from "ws";
 import { createServer } from "net";
 var DASHBOARD_BIND_HOST = void 0;
 function isPortFree(port, host = DASHBOARD_BIND_HOST) {
-  return new Promise((resolve11) => {
+  return new Promise((resolve12) => {
     const server = createServer();
-    server.once("error", () => resolve11(false));
+    server.once("error", () => resolve12(false));
     server.once("listening", () => {
-      server.close(() => resolve11(true));
+      server.close(() => resolve12(true));
     });
     server.listen(port, host);
   });
@@ -1398,7 +1483,7 @@ function fileResponse(filePath) {
   });
 }
 function awaitServerListening(server, port) {
-  return new Promise((resolve11, reject) => {
+  return new Promise((resolve12, reject) => {
     const closeQuietly = () => {
       try {
         server.close(() => {
@@ -1421,7 +1506,7 @@ function awaitServerListening(server, port) {
     };
     const onListening = () => {
       server.off("error", onError);
-      resolve11();
+      resolve12();
     };
     server.once("error", onError);
     server.once("listening", onListening);
@@ -1527,15 +1612,15 @@ async function startDashboardServer(db, dbPath, staticPath, port) {
   app.get("/*", (c) => {
     const urlPath = c.req.path;
     if (urlPath !== "/") {
-      const candidate = join10(staticPath, urlPath);
-      if (existsSync9(candidate)) {
+      const candidate = join11(staticPath, urlPath);
+      if (existsSync10(candidate)) {
         try {
           return fileResponse(candidate);
         } catch {
         }
       }
     }
-    return fileResponse(join10(staticPath, "index.html"));
+    return fileResponse(join11(staticPath, "index.html"));
   });
   const resolvedPort = await findFreePort(port, { host: DASHBOARD_BIND_HOST });
   if (resolvedPort !== port) {
@@ -1574,7 +1659,7 @@ async function startDashboardServer(db, dbPath, staticPath, port) {
   let watcher = null;
   if (dbPath) {
     const walPath = `${dbPath}-wal`;
-    const watchTarget = existsSync9(walPath) ? walPath : dbPath;
+    const watchTarget = existsSync10(walPath) ? walPath : dbPath;
     watcher = watch2(watchTarget, broadcast);
   }
   return {
@@ -1594,7 +1679,7 @@ async function runDashboard(cwd2, opts) {
   const config = await loadConfig(cwd2);
   const db = await openDB(config, cwd2);
   const dbPath = config.database.type === "sqlite" ? resolveSqlitePath(config, cwd2, homedir()) : null;
-  const staticPath = join11(__dirname3, "dashboard-dist");
+  const staticPath = join12(__dirname3, "dashboard-dist");
   const { url } = await startDashboardServer(db, dbPath, staticPath, opts.port);
   console.log(pc3.green(`\u2713`) + ` Dashboard running at ${pc3.bold(pc3.cyan(url))}`);
   console.log(pc3.dim(`  WebSocket live updates enabled`));
@@ -1614,8 +1699,8 @@ async function runDashboard(cwd2, opts) {
 import pc4 from "picocolors";
 
 // src/core/doctor.ts
-import { existsSync as existsSync10, readFileSync as readFileSync7 } from "fs";
-import { dirname as dirname6, join as join12 } from "path";
+import { existsSync as existsSync11, readFileSync as readFileSync7 } from "fs";
+import { dirname as dirname6, join as join13 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 var REGISTRY_URL = `https://registry.npmjs.org/${pkg.name}/latest`;
 var TIMEOUT_MS = 2e3;
@@ -1664,19 +1749,21 @@ function getProviderAgentInfo(provider) {
       return { agentsDir: ".opencode/agents", ext: ".md" };
     case "codex-cli":
       return { agentsDir: ".codex/agents", ext: ".toml" };
+    case "grok-cli":
+      return { agentsDir: ".grok/agents", ext: ".md" };
     default:
       return { agentsDir: ".claude/agents", ext: ".md" };
   }
 }
 function checkAgentFilesAtRoot(agentsRoot, ext) {
   return AGENT_NAMES.map((name) => {
-    const filePath = join12(agentsRoot, `${name}${ext}`);
-    return { name, status: existsSync10(filePath) ? "ok" : "missing" };
+    const filePath = join13(agentsRoot, `${name}${ext}`);
+    return { name, status: existsSync11(filePath) ? "ok" : "missing" };
   });
 }
 function checkAgentFiles(cwd2, provider) {
   const { agentsDir, ext } = getProviderAgentInfo(provider);
-  return checkAgentFilesAtRoot(join12(cwd2, agentsDir), ext);
+  return checkAgentFilesAtRoot(join13(cwd2, agentsDir), ext);
 }
 function getProviderSkillsDir(provider) {
   switch (provider) {
@@ -1686,16 +1773,18 @@ function getProviderSkillsDir(provider) {
       return ".opencode/skills";
     case "codex-cli":
       return ".agents/skills";
+    case "grok-cli":
+      return ".grok/skills";
     default:
       return ".claude/skills";
   }
 }
 function checkSkillsAtRoot(skillsRoot) {
-  const skillSourceBase = join12(__dirname4, "skills");
+  const skillSourceBase = join13(__dirname4, "skills");
   return SKILL_NAMES.map((name) => {
-    const livePath = join12(skillsRoot, name, "SKILL.md");
-    const sourcePath = join12(skillSourceBase, name, "SKILL.md");
-    if (!existsSync10(livePath)) {
+    const livePath = join13(skillsRoot, name, "SKILL.md");
+    const sourcePath = join13(skillSourceBase, name, "SKILL.md");
+    if (!existsSync11(livePath)) {
       return { name, status: "missing" };
     }
     try {
@@ -1709,7 +1798,7 @@ function checkSkillsAtRoot(skillsRoot) {
 }
 function checkSkills(cwd2, provider) {
   const skillsDir = getProviderSkillsDir(provider);
-  return checkSkillsAtRoot(join12(cwd2, skillsDir));
+  return checkSkillsAtRoot(join13(cwd2, skillsDir));
 }
 async function getDoctorStatus(cwd2) {
   const lib = await checkLibVersion();
@@ -1810,7 +1899,7 @@ async function runDoctor(cwd2) {
 }
 
 // src/commands/export.ts
-import { writeFileSync as writeFileSync6 } from "fs";
+import { writeFileSync as writeFileSync7 } from "fs";
 import pc5 from "picocolors";
 async function runExport(cwd2, opts) {
   if (!opts.sql && !opts.json) {
@@ -1824,7 +1913,7 @@ async function runExport(cwd2, opts) {
       const data = await db.exportJson();
       const out = JSON.stringify(data, null, 2) + "\n";
       if (opts.output) {
-        writeFileSync6(opts.output, out, "utf8");
+        writeFileSync7(opts.output, out, "utf8");
         console.log(pc5.green(`\u2713 Exported JSON \u2192 ${opts.output}`));
       } else {
         process.stdout.write(out);
@@ -1841,9 +1930,9 @@ async function runExport(cwd2, opts) {
 
 // src/commands/health.ts
 import { spawnSync } from "child_process";
-import { existsSync as existsSync11 } from "fs";
+import { existsSync as existsSync12 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join13, resolve as resolve5 } from "path";
+import { join as join14, resolve as resolve6 } from "path";
 import pc6 from "picocolors";
 function checkLine(label, ok3, message, indent = 0) {
   const prefix = label ? pc6.cyan(`[${label}] `) : " ".repeat(indent);
@@ -1862,7 +1951,7 @@ async function runHealth(cwd2) {
   let dbOk;
   if (config.database.type === "sqlite") {
     const dbPath = resolveSqlitePath(config, cwd2, homedir2());
-    dbOk = existsSync11(dbPath);
+    dbOk = existsSync12(dbPath);
     checkLine("checking DB", dbOk, `${dbPath} reachable`);
   } else {
     dbOk = true;
@@ -1875,8 +1964,8 @@ async function runHealth(cwd2) {
   const agentsLabelWidth = "[checking agents] ".length;
   for (let i = 0; i < agentNames.length; i++) {
     const name = agentNames[i];
-    const agentPath = join13(cwd2, agentsDir, `${name}${providerFiles.agentExtension}`);
-    const ok3 = existsSync11(agentPath);
+    const agentPath = join14(cwd2, agentsDir, `${name}${providerFiles.agentExtension}`);
+    const ok3 = existsSync12(agentPath);
     checkLine(
       i === 0 ? "checking agents" : null,
       ok3,
@@ -1887,8 +1976,8 @@ async function runHealth(cwd2) {
   }
   if (config.tools.mcp.enabled) {
     const mcpFile = providerFiles.mcpFile;
-    const mcpPath = resolve5(cwd2, mcpFile);
-    const mcpOk = existsSync11(mcpPath);
+    const mcpPath = resolve6(cwd2, mcpFile);
+    const mcpOk = existsSync12(mcpPath);
     checkLine("checking MCP", mcpOk, `${mcpFile} valid`);
     if (!mcpOk) allOk = false;
   }
@@ -1897,8 +1986,8 @@ async function runHealth(cwd2) {
     console.error(pc6.red("\u2717 Harness checks failed \u2014 fix the above before running health.sh"));
     process.exit(1);
   }
-  const scriptPath = resolve5(cwd2, config.health.scriptPath);
-  if (!existsSync11(scriptPath)) {
+  const scriptPath = resolve6(cwd2, config.health.scriptPath);
+  if (!existsSync12(scriptPath)) {
     console.error(pc6.red(`\u2717 health.sh not found: ${scriptPath}`));
     console.error("  Run ahk init first.");
     process.exit(1);
@@ -1928,14 +2017,16 @@ function getProviderHealthFiles(provider) {
       return { agentsDir: ".opencode/agents", agentExtension: ".md", mcpFile: "opencode.json" };
     case "codex-cli":
       return { agentsDir: ".codex/agents", agentExtension: ".toml", mcpFile: ".codex/config.toml" };
+    case "grok-cli":
+      return { agentsDir: ".grok/agents", agentExtension: ".md", mcpFile: ".grok/config.toml" };
     default:
       throw new Error(`Unknown provider: ${provider}`);
   }
 }
 
 // src/commands/init.ts
-import { existsSync as existsSync13, mkdirSync as mkdirSync6, readFileSync as readFileSync9, writeFileSync as writeFileSync7 } from "fs";
-import { join as join15 } from "path";
+import { existsSync as existsSync14, mkdirSync as mkdirSync7, readFileSync as readFileSync9, writeFileSync as writeFileSync8 } from "fs";
+import { join as join16 } from "path";
 import * as p3 from "@clack/prompts";
 import pc8 from "picocolors";
 
@@ -1990,13 +2081,13 @@ var cliFormWithRetry = async (formFn, schema) => {
 
 // src/commands/init-helpers.ts
 import { randomUUID } from "crypto";
-import { existsSync as existsSync12, readFileSync as readFileSync8 } from "fs";
-import { join as join14 } from "path";
+import { existsSync as existsSync13, readFileSync as readFileSync8 } from "fs";
+import { join as join15 } from "path";
 import pc7 from "picocolors";
 function readProjectNameFromPackageJson(cwd2) {
   try {
-    const pkgPath2 = join14(cwd2, "package.json");
-    if (!existsSync12(pkgPath2)) return null;
+    const pkgPath2 = join15(cwd2, "package.json");
+    if (!existsSync13(pkgPath2)) return null;
     const content = readFileSync8(pkgPath2, "utf8");
     const pkg2 = JSON.parse(content);
     const name = pkg2?.name;
@@ -2009,9 +2100,9 @@ function readProjectNameFromPackageJson(cwd2) {
 function detectConfigExtension(cwd2) {
   if (!isLocalInstallSatisfied(cwd2)) return "json";
   try {
-    if (existsSync12(join14(cwd2, "tsconfig.json"))) return "ts";
-    const pkgPath2 = join14(cwd2, "package.json");
-    if (!existsSync12(pkgPath2)) return "mjs";
+    if (existsSync13(join15(cwd2, "tsconfig.json"))) return "ts";
+    const pkgPath2 = join15(cwd2, "package.json");
+    if (!existsSync13(pkgPath2)) return "mjs";
     const pkg2 = JSON.parse(readFileSync8(pkgPath2, "utf8"));
     if (pkg2?.type === "module") return "mjs";
   } catch {
@@ -2092,10 +2183,10 @@ function printWelcomeMessage(projectName) {
 
 // src/commands/init.ts
 async function reconcileFeatureList(db, installDir, storageDir, firstTask) {
-  const featureListPath = join15(installDir, storageDir, "feature_list.json");
+  const featureListPath = join16(installDir, storageDir, "feature_list.json");
   let existingSeeds = [];
   let parseFailed = false;
-  if (existsSync13(featureListPath)) {
+  if (existsSync14(featureListPath)) {
     try {
       const parsed = JSON.parse(readFileSync9(featureListPath, "utf8"));
       if (!Array.isArray(parsed)) throw new Error("feature_list.json is not a JSON array");
@@ -2169,7 +2260,7 @@ async function runInit(cwd2, flags) {
     return val;
   }, initDescriptionSchema);
   let provider;
-  if (flags.provider && ["claude-code", "opencode"].includes(flags.provider)) {
+  if (flags.provider && ["claude-code", "opencode", "codex-cli", "grok-cli"].includes(flags.provider)) {
     provider = flags.provider;
   } else {
     const val = await p3.select({
@@ -2177,7 +2268,8 @@ async function runInit(cwd2, flags) {
       options: [
         { value: "opencode", label: "OpenCode" },
         { value: "claude-code", label: "Claude Code" },
-        { value: "codex-cli", label: "Codex CLI" }
+        { value: "codex-cli", label: "Codex CLI" },
+        { value: "grok-cli", label: "Grok CLI" }
       ]
     });
     if (p3.isCancel(val)) {
@@ -2332,14 +2424,14 @@ async function runInit(cwd2, flags) {
       scope: config.storage.scope,
       projectId: config.storage.projectId
     });
-    writeFileSync7(join15(installDir, configFileName), configContent, "utf8");
-    mkdirSync6(join15(installDir, config.storage.dir), { recursive: true });
+    writeFileSync8(join16(installDir, configFileName), configContent, "utf8");
+    mkdirSync7(join16(installDir, config.storage.dir), { recursive: true });
     const db = await openDB(config, installDir);
     await db.writeStorageState(installDir);
     await materializer.scaffold(config, { cwd: installDir, firstTask, claudeAgentModels });
     const { parseFailed } = await reconcileFeatureList(db, installDir, config.storage.dir, firstTask);
     if (parseFailed) {
-      featureListParseFailedPath = join15(config.storage.dir, "feature_list.json");
+      featureListParseFailedPath = join16(config.storage.dir, "feature_list.json");
     }
     await db.close();
     spinner6.stop("");
@@ -2354,8 +2446,13 @@ async function runInit(cwd2, flags) {
     );
   }
   console.log(pc8.green("\u2713 Scaffolded harness in current directory"));
-  const agentsDir = provider === "claude-code" ? ".claude/agents/" : ".opencode/agents/";
-  const mcpFile = provider === "claude-code" ? ".claude/mcp.json" : "./opencode.json";
+  const PROVIDER_SUMMARY_INFO = {
+    "claude-code": { agentsDir: ".claude/agents/", mcpFile: ".mcp.json" },
+    opencode: { agentsDir: ".opencode/agents/", mcpFile: "./opencode.json" },
+    "codex-cli": { agentsDir: ".codex/agents/", mcpFile: ".codex/config.toml" },
+    "grok-cli": { agentsDir: ".grok/agents/", mcpFile: ".grok/config.toml" }
+  };
+  const { agentsDir, mcpFile } = PROVIDER_SUMMARY_INFO[provider];
   console.log("");
   console.log(pc8.green(`\u2713 agent-harness-kit.config.${configExt}`));
   console.log(pc8.green("\u2713 AGENTS.md"));
@@ -2397,7 +2494,7 @@ import pc9 from "picocolors";
 async function runMigrate(cwd2, opts) {
   const config = await loadConfig(cwd2);
   let target;
-  if (opts.to && ["claude-code", "opencode", "codex-cli"].includes(opts.to)) {
+  if (opts.to && ["claude-code", "opencode", "codex-cli", "grok-cli"].includes(opts.to)) {
     target = opts.to;
   } else {
     const val = await p4.select({
@@ -2405,7 +2502,8 @@ async function runMigrate(cwd2, opts) {
       options: [
         { value: "claude-code", label: "Claude Code" },
         { value: "opencode", label: "OpenCode" },
-        { value: "codex-cli", label: "Codex CLI" }
+        { value: "codex-cli", label: "Codex CLI" },
+        { value: "grok-cli", label: "Grok CLI" }
       ]
     });
     if (p4.isCancel(val)) {
@@ -2434,9 +2532,9 @@ async function runMigrate(cwd2, opts) {
 }
 
 // src/commands/migrate-storage.ts
-import { copyFileSync, existsSync as existsSync14, mkdirSync as mkdirSync7, rmSync, writeFileSync as writeFileSync8 } from "fs";
+import { copyFileSync, existsSync as existsSync15, mkdirSync as mkdirSync8, rmSync, writeFileSync as writeFileSync9 } from "fs";
 import { homedir as homedir3 } from "os";
-import { dirname as dirname7, join as join16, resolve as resolve6 } from "path";
+import { dirname as dirname7, join as join17, resolve as resolve7 } from "path";
 import pc10 from "picocolors";
 function log5(msg) {
   console.log(msg);
@@ -2448,17 +2546,17 @@ function defaultMarkdownPathForConfig(config) {
   return config.storage.scope === "local" ? config.storage.markdownFallback.path : DEFAULT_MARKDOWN_PATH;
 }
 function currentMdPathForScope(scope, config, cwd2, homeDir) {
-  return scope === "global" ? join16(resolveGlobalStorageDir(config, homeDir), "current.md") : resolve6(cwd2, defaultMarkdownPathForConfig(config));
+  return scope === "global" ? join17(resolveGlobalStorageDir(config, homeDir), "current.md") : resolve7(cwd2, defaultMarkdownPathForConfig(config));
 }
 function defaultSqlitePathForConfig(config) {
   return config.storage.scope === "local" && config.database.type === "sqlite" ? config.storage.sqlitePath ?? DEFAULT_SQLITE_PATH : DEFAULT_SQLITE_PATH;
 }
 async function backupDestination(cwd2, storageDir, data) {
-  const backupsDir = resolve6(cwd2, storageDir, "backups");
-  const path = join16(backupsDir, `pre-migrate-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.json`);
+  const backupsDir = resolve7(cwd2, storageDir, "backups");
+  const path = join17(backupsDir, `pre-migrate-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.json`);
   try {
-    mkdirSync7(backupsDir, { recursive: true });
-    writeFileSync8(path, JSON.stringify(data, null, 2) + "\n", "utf8");
+    mkdirSync8(backupsDir, { recursive: true });
+    writeFileSync9(path, JSON.stringify(data, null, 2) + "\n", "utf8");
   } catch (err) {
     throw new Error(
       `Could not write destination backup to ${path} (${err instanceof Error ? err.message : String(err)}). Aborting migration WITHOUT touching the destination \u2014 nothing was overwritten.`
@@ -2467,14 +2565,14 @@ async function backupDestination(cwd2, storageDir, data) {
   return path;
 }
 function copySqliteFile(srcPath, destPath) {
-  mkdirSync7(dirname7(destPath), { recursive: true });
+  mkdirSync8(dirname7(destPath), { recursive: true });
   copyFileSync(srcPath, destPath);
   for (const suffix of ["-wal", "-shm"]) {
-    if (existsSync14(`${srcPath}${suffix}`)) {
+    if (existsSync15(`${srcPath}${suffix}`)) {
       copyFileSync(`${srcPath}${suffix}`, `${destPath}${suffix}`);
     }
   }
-  if (!existsSync14(destPath)) {
+  if (!existsSync15(destPath)) {
     throw new Error(`Copy verification failed: ${destPath} does not exist after copy.`);
   }
 }
@@ -2533,7 +2631,7 @@ async function runMigrateStorage(cwd2, opts, homeDir = homedir3()) {
   return migrateAcrossDbType(cwd2, config, homeDir, realScope, opts);
 }
 async function probeTaskCount(dbPath) {
-  if (!existsSync14(dbPath)) return 0;
+  if (!existsSync15(dbPath)) return 0;
   const { SQLiteDriver } = await import("./sqlite-5OWKTUUZ.js");
   const driver = new SQLiteDriver(dbPath);
   try {
@@ -2550,10 +2648,10 @@ async function migrateScopeOnly(cwd2, config, homeDir, fromScope, toScope, opts)
   const destDb = resolveSqlitePathForScope(toScope, sqlitePath, cwd2, config, homeDir);
   const srcMd = currentMdPathForScope(fromScope, config, cwd2, homeDir);
   const destMd = currentMdPathForScope(toScope, config, cwd2, homeDir);
-  if (!existsSync14(srcDb)) {
+  if (!existsSync15(srcDb)) {
     fail(`Source database not found at ${srcDb} (expected ${fromScope} scope) \u2014 nothing to move.`);
   }
-  const destExists = existsSync14(destDb);
+  const destExists = existsSync15(destDb);
   if (destExists) {
     const { SQLiteDriver } = await import("./sqlite-5OWKTUUZ.js");
     const destDriver = new SQLiteDriver(destDb);
@@ -2591,15 +2689,15 @@ async function migrateScopeOnly(cwd2, config, homeDir, fromScope, toScope, opts)
   }
   copySqliteFile(srcDb, destDb);
   log5(pc10.green(`\u2713 Copied database ${srcDb} \u2192 ${destDb}`));
-  if (existsSync14(srcMd)) {
-    mkdirSync7(dirname7(destMd), { recursive: true });
+  if (existsSync15(srcMd)) {
+    mkdirSync8(dirname7(destMd), { recursive: true });
     copyFileSync(srcMd, destMd);
     log5(pc10.green(`\u2713 Copied current.md ${srcMd} \u2192 ${destMd}`));
   }
   rmSync(srcDb, { force: true });
   rmSync(`${srcDb}-wal`, { force: true });
   rmSync(`${srcDb}-shm`, { force: true });
-  if (existsSync14(srcMd) && srcMd !== destMd) rmSync(srcMd, { force: true });
+  if (existsSync15(srcMd) && srcMd !== destMd) rmSync(srcMd, { force: true });
   const db = await openDB(config, cwd2, homeDir);
   try {
     await db.writeStorageState(cwd2);
@@ -2611,7 +2709,7 @@ async function migrateScopeOnly(cwd2, config, homeDir, fromScope, toScope, opts)
 async function migrateAcrossDbType(cwd2, config, homeDir, sourceScope, opts) {
   const sqlitePath = defaultSqlitePathForConfig(config);
   const srcPath = resolveSqlitePathForScope(sourceScope, sqlitePath, cwd2, config, homeDir);
-  if (!existsSync14(srcPath)) {
+  if (!existsSync15(srcPath)) {
     fail(`Source sqlite database not found at ${srcPath} (expected ${sourceScope} scope) \u2014 nothing to migrate.`);
   }
   const { SQLiteDriver } = await import("./sqlite-5OWKTUUZ.js");
@@ -2674,16 +2772,29 @@ async function migrateAcrossDbType(cwd2, config, homeDir, sourceScope, opts) {
 }
 
 // src/commands/reset.ts
-import { existsSync as existsSync15, readdirSync, rmSync as rmSync2 } from "fs";
+import { existsSync as existsSync16, readdirSync, rmSync as rmSync2 } from "fs";
 import { homedir as homedir4 } from "os";
-import { join as join17, resolve as resolve7 } from "path";
+import { join as join18, resolve as resolve8 } from "path";
 import * as p5 from "@clack/prompts";
 import pc11 from "picocolors";
 var AGENT_MD_FILES = ["lead", "explorer", "consultant", "builder", "reviewer"];
+var PROVIDER_AGENT_DIRS = {
+  "claude-code": ".claude/agents",
+  opencode: ".opencode/agents",
+  "codex-cli": ".codex/agents",
+  "grok-cli": ".grok/agents"
+};
+var PROVIDER_AGENT_EXT = {
+  "claude-code": ".md",
+  opencode: ".md",
+  "codex-cli": ".toml",
+  "grok-cli": ".md"
+};
 async function resetAgentMds(cwd2, provider) {
-  const agentDir = provider === "claude-code" ? ".claude/agents" : ".opencode/agents";
-  const agentDirPath = resolve7(cwd2, agentDir);
-  if (!existsSync15(agentDirPath)) {
+  const agentDir = PROVIDER_AGENT_DIRS[provider];
+  const agentDirPath = resolve8(cwd2, agentDir);
+  const agentExt = PROVIDER_AGENT_EXT[provider];
+  if (!existsSync16(agentDirPath)) {
     console.log(pc11.yellow(`  Skipping agent files \u2014 directory not found: ${agentDirPath}`));
     return;
   }
@@ -2691,7 +2802,7 @@ async function resetAgentMds(cwd2, provider) {
   try {
     const files = readdirSync(agentDirPath);
     for (const f of files) {
-      if (f.endsWith(".md") && AGENT_MD_FILES.includes(f.replace(".md", ""))) {
+      if (f.endsWith(agentExt) && AGENT_MD_FILES.includes(f.replace(agentExt, ""))) {
         existingFiles.push(f);
       }
     }
@@ -2714,7 +2825,7 @@ async function resetAgentMds(cwd2, provider) {
     }
     if (confirm3) {
       try {
-        const filePath = join17(agentDirPath, file);
+        const filePath = join18(agentDirPath, file);
         rmSync2(filePath, { force: true });
         console.log(pc11.green(`  Removed ${file}`));
       } catch {
@@ -2735,11 +2846,11 @@ async function runReset(cwd2, opts) {
   }
   const storageDir = config.storage.dir || ".harness";
   const dbPath = config.database.type === "sqlite" ? resolveSqlitePath(config, cwd2, homedir4()) : null;
-  const featureListPath = resolve7(cwd2, storageDir, "feature_list.json");
+  const featureListPath = resolve8(cwd2, storageDir, "feature_list.json");
   let resetDb = false;
   let resetFeatureList = false;
   let resetAgentMdsFlag = false;
-  if (dbPath && existsSync15(dbPath)) {
+  if (dbPath && existsSync16(dbPath)) {
     if (opts.force) {
       resetDb = true;
     } else {
@@ -2761,7 +2872,7 @@ async function runReset(cwd2, opts) {
   } else if (!dbPath) {
     console.log(pc11.dim(`  Skipping DB reset \u2014 remote ${config.database.type} database is not managed by this command.`));
   }
-  if (existsSync15(featureListPath)) {
+  if (existsSync16(featureListPath)) {
     if (opts.force) {
       resetFeatureList = true;
     } else {
@@ -2810,8 +2921,8 @@ async function runReset(cwd2, opts) {
 }
 
 // src/core/mcp-server.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync8, readdirSync as readdirSync2, readFileSync as readFileSync10, statSync, writeFileSync as writeFileSync9 } from "fs";
-import { join as join19, resolve as resolve8 } from "path";
+import { existsSync as existsSync18, mkdirSync as mkdirSync9, readdirSync as readdirSync2, readFileSync as readFileSync10, statSync, writeFileSync as writeFileSync10 } from "fs";
+import { join as join20, resolve as resolve9 } from "path";
 import { Server } from "@modelcontextprotocol/sdk/server";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -2820,8 +2931,8 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 
 // src/core/permissions-check.ts
-import { existsSync as existsSync16 } from "fs";
-import { join as join18 } from "path";
+import { existsSync as existsSync17 } from "fs";
+import { join as join19 } from "path";
 var AGENTS = ["lead", "explorer", "consultant", "builder", "reviewer"];
 function checkPermissionsSync(cwd2, config) {
   if (config.provider !== "claude-code") {
@@ -2830,8 +2941,8 @@ function checkPermissionsSync(cwd2, config) {
   const agents = {};
   let in_sync = true;
   for (const agent of AGENTS) {
-    const filePath = join18(cwd2, ".claude", "agents", `${agent}.md`);
-    const exists = existsSync16(filePath);
+    const filePath = join19(cwd2, ".claude", "agents", `${agent}.md`);
+    const exists = existsSync17(filePath);
     if (!exists) in_sync = false;
     agents[agent] = exists ? { ok: true } : { ok: false, reason: "missing_file" };
   }
@@ -3129,7 +3240,7 @@ var TOOLS = [
 ];
 async function startMcpServer(config, cwd2) {
   const db = await openDB(config, cwd2);
-  const docsPath = resolve8(cwd2, config.project.docsPath);
+  const docsPath = resolve9(cwd2, config.project.docsPath);
   const server = new Server(
     { name: "agent-harness-kit", version: VERSION },
     { capabilities: { tools: {} } }
@@ -3292,8 +3403,8 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
       return ok2(JSON.stringify(result));
     }
     case "deps.snapshot": {
-      const pkgPath2 = join19(cwd2, "package.json");
-      if (!existsSync17(pkgPath2)) {
+      const pkgPath2 = join20(cwd2, "package.json");
+      if (!existsSync18(pkgPath2)) {
         return ok2("package.json not found in project root", true);
       }
       const pkg2 = JSON.parse(readFileSync10(pkgPath2, "utf8"));
@@ -3302,9 +3413,9 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
         dependencies: pkg2.dependencies ?? {},
         devDependencies: pkg2.devDependencies ?? {}
       };
-      const harnessDir = join19(cwd2, ".harness");
-      mkdirSync8(harnessDir, { recursive: true });
-      writeFileSync9(join19(harnessDir, "deps-lock.json"), JSON.stringify(snapshot, null, 2), "utf8");
+      const harnessDir = join20(cwd2, ".harness");
+      mkdirSync9(harnessDir, { recursive: true });
+      writeFileSync10(join20(harnessDir, "deps-lock.json"), JSON.stringify(snapshot, null, 2), "utf8");
       return ok2(
         JSON.stringify({
           message: "Snapshot saved to .harness/deps-lock.json",
@@ -3313,12 +3424,12 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
       );
     }
     case "deps.check": {
-      const pkgPath2 = join19(cwd2, "package.json");
-      const lockPath = join19(cwd2, ".harness", "deps-lock.json");
-      if (!existsSync17(pkgPath2)) {
+      const pkgPath2 = join20(cwd2, "package.json");
+      const lockPath = join20(cwd2, ".harness", "deps-lock.json");
+      if (!existsSync18(pkgPath2)) {
         return ok2("package.json not found in project root", true);
       }
-      if (!existsSync17(lockPath)) {
+      if (!existsSync18(lockPath)) {
         return ok2(
           JSON.stringify({
             status: "no-snapshot",
@@ -3420,7 +3531,7 @@ function collectMarkdownFiles(dir) {
   const files = [];
   try {
     for (const entry of readdirSync2(dir)) {
-      const full = join19(dir, entry);
+      const full = join20(dir, entry);
       const stat = statSync(full);
       if (stat.isDirectory()) {
         files.push(...collectMarkdownFiles(full));
@@ -3550,13 +3661,13 @@ async function runStatus(cwd2, opts) {
 }
 
 // src/commands/sync.ts
-import { existsSync as existsSync18, readFileSync as readFileSync11 } from "fs";
-import { join as join20, resolve as resolve9 } from "path";
+import { existsSync as existsSync19, readFileSync as readFileSync11 } from "fs";
+import { join as join21, resolve as resolve10 } from "path";
 import pc13 from "picocolors";
 async function runSync(cwd2, opts) {
   const config = await loadConfig(cwd2);
   const direction = opts.direction ?? "both";
-  const featureListPath = resolve9(join20(cwd2, config.storage.dir, "feature_list.json"));
+  const featureListPath = resolve10(join21(cwd2, config.storage.dir, "feature_list.json"));
   const db = await openDB(config, cwd2);
   try {
     if (direction === "in" || direction === "both") {
@@ -3570,7 +3681,7 @@ async function runSync(cwd2, opts) {
   }
 }
 async function syncIn(featureListPath, db, dryRun) {
-  if (!existsSync18(featureListPath)) {
+  if (!existsSync19(featureListPath)) {
     console.log(pc13.dim(`feature_list.json not found at ${featureListPath} \u2014 skipping in-sync`));
     return;
   }
@@ -3661,14 +3772,14 @@ async function runTaskAdd(cwd2) {
 
 // src/commands/task/done.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync19 } from "fs";
-import { resolve as resolve10 } from "path";
+import { existsSync as existsSync20 } from "fs";
+import { resolve as resolve11 } from "path";
 import pc15 from "picocolors";
 async function runTaskDone(cwd2, idOrSlug) {
   const config = await loadConfig(cwd2);
   if (config.health.required) {
-    const scriptPath = resolve10(cwd2, config.health.scriptPath);
-    if (existsSync19(scriptPath)) {
+    const scriptPath = resolve11(cwd2, config.health.scriptPath);
+    if (existsSync20(scriptPath)) {
       const result = spawnSync2("bash", [scriptPath], { cwd: cwd2, stdio: "pipe", encoding: "utf8" });
       if (result.status !== 0) {
         console.error(pc15.red("\u2717 Health check failed \u2014 cannot mark task as done."));
@@ -3841,7 +3952,7 @@ async function runTaskList(cwd2, opts) {
 
 // src/core/path-probe.ts
 import { accessSync, constants, readdirSync as readdirSync3 } from "fs";
-import { join as join21 } from "path";
+import { join as join22 } from "path";
 import pc18 from "picocolors";
 var DEFAULT_PATHEXT = [".COM", ".EXE", ".BAT", ".CMD"];
 function defaultIsExecutable(filePath) {
@@ -3886,7 +3997,7 @@ function resolveOnPath(name, options = {}) {
   }
   for (const dir of dirs) {
     try {
-      if (isExecutable(join21(dir, name))) return true;
+      if (isExecutable(join22(dir, name))) return true;
     } catch {
       continue;
     }
@@ -3910,15 +4021,15 @@ import pc19 from "picocolors";
 var REGISTRY_URL2 = `https://registry.npmjs.org/${pkg.name}/latest`;
 var TIMEOUT_MS2 = 2500;
 function checkForUpdate(currentVersion) {
-  return new Promise((resolve11) => {
-    const timer = setTimeout(() => resolve11(null), TIMEOUT_MS2);
+  return new Promise((resolve12) => {
+    const timer = setTimeout(() => resolve12(null), TIMEOUT_MS2);
     fetch(REGISTRY_URL2).then((res) => res.json()).then((data) => {
       clearTimeout(timer);
       const latest = data.version;
-      resolve11(isNewer2(latest, currentVersion) ? { current: currentVersion, latest } : null);
+      resolve12(isNewer2(latest, currentVersion) ? { current: currentVersion, latest } : null);
     }).catch(() => {
       clearTimeout(timer);
-      resolve11(null);
+      resolve12(null);
     });
   });
 }
@@ -3955,7 +4066,7 @@ function parsePort(raw) {
 var updateCheck = checkForUpdate(pkg.version);
 var program = new Command();
 program.name("ahk").description("agent-harness-kit \u2014 CLI scaffolding for multi-agent harness systems").version(pkg.version, "-v, --version");
-program.command("init").description("Scaffold a harness interactively in the current directory").option("--name <name>", "Project name (skip prompt)").option("--provider <provider>", "AI provider: claude-code | opencode (skip prompt)").option("--docs <path>", "Docs folder path (skip prompt)").option("--tasks <adapter>", "Task adapter: local | jira | linear (skip prompt)").option("--storage-scope <scope>", "Storage scope: local | global (skip prompt)").action(async (opts) => {
+program.command("init").description("Scaffold a harness interactively in the current directory").option("--name <name>", "Project name (skip prompt)").option("--provider <provider>", "AI provider: claude-code | opencode | codex-cli | grok-cli (skip prompt)").option("--docs <path>", "Docs folder path (skip prompt)").option("--tasks <adapter>", "Task adapter: local | jira | linear (skip prompt)").option("--storage-scope <scope>", "Storage scope: local | global (skip prompt)").action(async (opts) => {
   await runInit(cwd, opts);
 });
 program.command("build").description("Regenerate AGENTS.md and provider files from agent-harness-kit.config.ts").option("--watch", "Rebuild on config changes").option("--sync", "Sync tools: frontmatter in existing .claude/agents/*.md to match current permission constants").option(
@@ -3993,7 +4104,7 @@ program.command("dashboard").description("Open web dashboard to visualize harnes
   await runDashboard(cwd, { port: opts.port, open: opts.open });
 });
 var migrate = program.command("migrate").description("Migrate provider files to a different provider, or migrate harness storage (see subcommands)");
-migrate.command("provider").description("Migrate provider-specific files to a different provider").option("--to <provider>", "Target provider: claude-code | opencode | codex-cli").action(async (opts) => {
+migrate.command("provider").description("Migrate provider-specific files to a different provider").option("--to <provider>", "Target provider: claude-code | opencode | codex-cli | grok-cli").action(async (opts) => {
   await runMigrate(cwd, opts);
 });
 migrate.command("storage").description(
@@ -4009,7 +4120,7 @@ migrate.command("storage").description(
 program.command("export").description("Export the database").option("--sql", "SQL dump").option("--json", "JSON export of tasks and actions").option("--output <path>", "Output file path (default: stdout)").action(async (opts) => {
   await runExport(cwd, opts);
 });
-program.command("reset").description("Reset/clear harness data (DB, feature list, agent files)").option("--force", "Skip confirmation prompts").option("--provider <claude-code|opencode>", "Reset agent MD files for specified provider").action(async (opts) => {
+program.command("reset").description("Reset/clear harness data (DB, feature list, agent files)").option("--force", "Skip confirmation prompts").option("--provider <claude-code|opencode|codex-cli|grok-cli>", "Reset agent MD files for specified provider").action(async (opts) => {
   await runReset(cwd, opts);
 });
 program.command("doctor").description("Check lib version, agent files, and harness skills sync status").action(async () => {