@useorgx/wizard 0.1.9 → 0.1.10

package/README.md

@@ -14,14 +14,15 @@ For local development, use `pnpm dev -- --help`.
 
 ## Commands
 
-- `setup` configures detected automated surfaces and, when OrgX auth is available in an interactive shell, guides workspace selection or creation, optional onboarding extras, and optional companion plugin installs for detected Claude Code, Codex, and OpenClaw hosts. The founder preset preplans plugin installs before it writes standalone skills so plugin-backed hosts do not get duplicate standalone Claude assets in the same run.
+- `setup` configures detected automated surfaces and, when OrgX auth is available in an interactive shell, guides workspace selection or creation, optional onboarding extras, and optional Cursor rules or companion plugin installs for detected Cursor, Claude Code, Codex, and OpenClaw hosts. The founder preset preplans plugin installs before it writes standalone skills so plugin-backed hosts do not get duplicate standalone Claude assets in the same run.
 - `surface list` shows supported surfaces and current status.
 - `surface add <name>` patches a specific surface.
 - `surface remove <name>` removes OrgX-managed config from a specific surface.
 - `mcp add [surface]` and `mcp remove [surface]` manage Claude, Cursor, Codex, VS Code, Windsurf, and Zed MCP entries.
-- `plugins list` shows companion plugin availability and install status for Claude Code, Codex, and OpenClaw.
-- `plugins add [target...]` installs the managed OrgX companion plugins into Claude Code, Codex, and/or OpenClaw. Claude Code and Codex plugins carry their own OrgX skills, so they become the source of truth for those hosts.
-- `plugins remove [target...]` uninstalls the managed OrgX companion plugins from Claude Code, Codex, and/or OpenClaw.
+- `plugins list` shows Cursor rules and companion plugin availability and install status for Cursor, Claude Code, Codex, and OpenClaw.
+- `plugins add [target...]` installs managed Cursor OrgX rules or managed OrgX companion plugins into Claude Code, Codex, and/or OpenClaw. Claude Code and Codex plugins carry their own OrgX skills, so they become the source of truth for those hosts.
+- `plugins remove [target...]` uninstalls managed Cursor OrgX rules or managed OrgX companion plugins from Claude Code, Codex, and/or OpenClaw.
+- `uninstall` removes OrgX-managed surface config, Cursor rules and companion plugins, wizard-local auth, and wizard-local setup state. Use `--keep-auth`, `--keep-state`, `--skip-plugins`, or `--skip-surfaces` to preserve specific pieces.
 - `doctor` verifies local config, hosted MCP reachability, npm registry readiness, current-workspace connectivity, local OpenClaw health, and optionally the remote setup status API. Hosted MCP tools are OAuth-scoped inside the client connector, so the wizard does not preflight them with `oxk_` API keys. It exits non-zero when blocking connectivity issues remain.
 - `auth status` shows the resolved OrgX API key source and verifies it against `POST /api/client/sync`.
 - `auth login [--base-url <url>]` starts browser pairing against OrgX, waits for approval, saves the returned per-user key to the wizard auth store, and bootstraps OpenClaw auth if OpenClaw is detected. Use `--api-key <oxk_...>` for CI or blocked-browser fallback.

package/dist/cli.js

@@ -1046,6 +1046,9 @@ function getOrCreateWizardInstallationId(statePath = ORGX_WIZARD_STATE_PATH) {
   writeWizardState(record, statePath);
   return record.installationId;
 }
+function clearWizardState(statePath = ORGX_WIZARD_STATE_PATH) {
+  return deleteFileIfExists(statePath);
+}
 
 // src/lib/agent-roster.ts
 var AGENT_ROSTER_PROFILES = [
@@ -3281,7 +3284,7 @@ import {
 } from "fs";
 import { tmpdir } from "os";
 import { dirname as dirname3, join as join3, relative } from "path";
-var DEFAULT_ORGX_PLUGIN_TARGETS = ["claude", "codex", "openclaw"];
+var DEFAULT_ORGX_PLUGIN_TARGETS = ["cursor", "claude", "codex", "openclaw"];
 var ORGX_PLUGIN_GITHUB_OWNER = "useorgx";
 var ORGX_PLUGIN_GITHUB_REF = "main";
 var ORGX_CLAUDE_PLUGIN_NAME = "orgx-claude-code-plugin";
@@ -3320,7 +3323,8 @@ function defaultPluginPaths() {
     claudeMarketplaceManifestPath: CLAUDE_MANAGED_MARKETPLACE_MANIFEST_PATH,
     claudePluginDir: CLAUDE_MANAGED_PLUGIN_DIR,
     codexMarketplacePath: CODEX_MARKETPLACE_PATH,
-    codexPluginDir: CODEX_ORGX_PLUGIN_DIR
+    codexPluginDir: CODEX_ORGX_PLUGIN_DIR,
+    cursorRulePath: CURSOR_ORGX_RULE_PATH
   };
 }
 function resolvePluginPaths(paths = {}) {
@@ -3740,6 +3744,32 @@ async function getOpenclawInstallState(runner) {
     installed: extractOpenclawPluginIds(result.stdout).includes(ORGX_OPENCLAW_PLUGIN_ID)
   };
 }
+function buildCursorStatus(paths) {
+  const existingRules = readTextIfExists(paths.cursorRulePath);
+  const available = detectSurface("cursor").detected || existingRules !== null;
+  if (existingRules === CURSOR_RULES_CONTENT) {
+    return {
+      target: "cursor",
+      available: true,
+      installed: true,
+      message: "Cursor OrgX rules are installed."
+    };
+  }
+  if (existingRules !== null) {
+    return {
+      target: "cursor",
+      available: true,
+      installed: false,
+      message: "Cursor OrgX rules file exists, but differs from the managed rules."
+    };
+  }
+  return {
+    target: "cursor",
+    available,
+    installed: false,
+    message: available ? "Cursor is available and ready for OrgX rules install." : "Cursor was not detected."
+  };
+}
 async function buildClaudeStatus(paths, runner) {
   const state = await getClaudeInstallState(runner);
   if (state.installed) {
@@ -3855,6 +3885,30 @@ async function resolveOpenclawTarball(fetchImpl) {
     version: latestVersion
   };
 }
+function installCursorPlugin(paths) {
+  const existingRules = readTextIfExists(paths.cursorRulePath);
+  const available = detectSurface("cursor").detected || existingRules !== null;
+  if (!available) {
+    return {
+      target: "cursor",
+      changed: false,
+      message: "Cursor is not available on this machine."
+    };
+  }
+  if (existingRules === CURSOR_RULES_CONTENT) {
+    return {
+      target: "cursor",
+      changed: false,
+      message: "Cursor OrgX rules are already installed."
+    };
+  }
+  writeTextFile(paths.cursorRulePath, CURSOR_RULES_CONTENT);
+  return {
+    target: "cursor",
+    changed: true,
+    message: "Installed the managed Cursor OrgX rules."
+  };
+}
 async function installClaudePlugin(paths, fetchImpl, runner) {
   const state = await getClaudeInstallState(runner);
   if (!state.available) {
@@ -3961,6 +4015,29 @@ async function installOpenclawPlugin(fetchImpl, runner) {
     message: `Installed OpenClaw plugin ${ORGX_OPENCLAW_PLUGIN_ID} from ${ORGX_OPENCLAW_PLUGIN_PACKAGE_NAME}@${version}.`
   };
 }
+function uninstallCursorPlugin(paths) {
+  const existingRules = readTextIfExists(paths.cursorRulePath);
+  if (existingRules === null) {
+    return {
+      target: "cursor",
+      changed: false,
+      message: "Cursor OrgX rules were not installed."
+    };
+  }
+  if (existingRules !== CURSOR_RULES_CONTENT) {
+    return {
+      target: "cursor",
+      changed: false,
+      message: "Cursor rules file differs from the managed OrgX rules, so it was left in place."
+    };
+  }
+  const changed = deleteFileIfExists(paths.cursorRulePath);
+  return {
+    target: "cursor",
+    changed,
+    message: changed ? "Removed the managed Cursor OrgX rules." : "Cursor OrgX rules were not installed."
+  };
+}
 async function uninstallClaudePlugin(paths, runner) {
   const state = await getClaudeInstallState(runner);
   let changed = false;
@@ -4056,6 +4133,7 @@ async function listOrgxPluginStatuses(options = {}) {
   const paths = resolvePluginPaths(options.paths);
   const runner = resolveCommandRunner(options.commandRunner);
   return await Promise.all([
+    buildCursorStatus(paths),
     buildClaudeStatus(paths, runner),
     buildCodexStatus(paths, runner),
     buildOpenclawStatus(runner)
@@ -4072,6 +4150,9 @@ async function installOrgxPlugins(options = {}) {
   const results = [];
   for (const target of targets) {
     switch (target) {
+      case "cursor":
+        results.push(installCursorPlugin(paths));
+        break;
       case "claude":
         results.push(await installClaudePlugin(paths, fetchImpl, runner));
         break;
@@ -4092,6 +4173,9 @@ async function uninstallOrgxPlugins(options = {}) {
   const results = [];
   for (const target of targets) {
     switch (target) {
+      case "cursor":
+        results.push(uninstallCursorPlugin(paths));
+        break;
       case "claude":
         results.push(await uninstallClaudePlugin(paths, runner));
         break;
@@ -4558,6 +4642,8 @@ function formatAuthSource(source) {
 }
 function formatPluginTargetLabel(target) {
   switch (target) {
+    case "cursor":
+      return "Cursor rules";
     case "claude":
       return "Claude Code";
     case "codex":
@@ -4602,6 +4688,16 @@ function printPluginMutationReport(report) {
     );
   }
 }
+async function printPluginStatusSection() {
+  const spinner = createOrgxSpinner("Checking OrgX plugin and Cursor rules status");
+  spinner.start();
+  const statuses = await listOrgxPluginStatuses();
+  spinner.succeed("OrgX plugin and Cursor rules status checked");
+  console.log("");
+  console.log(pc3.dim("  plugins"));
+  printPluginStatusReport(statuses);
+  return statuses;
+}
 function printSkillInstallReport(report) {
   for (const write of report.writes) {
     const icon = write.changed ? ICON.ok : ICON.skip;
@@ -4704,8 +4800,9 @@ async function textPrompt(input) {
 }
 async function multiselectPrompt(input) {
   const promptInput = {
-    message: input.message,
+    message: `${input.message} ${pc3.dim("Space selects items; Enter continues.")}`,
     options: input.options,
+    ...input.initialValues ? { initialValues: input.initialValues } : {},
     ...input.required !== void 0 ? { required: input.required } : {}
   };
   return normalizePromptResult(await clack.multiselect(promptInput));
@@ -4854,10 +4951,11 @@ async function maybeConfigureOptionalWorkspaceAddOns(input) {
   const hasAgentRoster = refreshedState?.agentRoster?.workspaceId === input.workspace.id;
   if (!hasAgentRoster) {
     const rosterChoice = await selectPrompt({
+      initialValue: "default",
       message: `Set up an OrgX agent roster for ${input.workspace.name}?`,
       options: [
-        { value: "guided", label: "Choose agents and domains", hint: "recommended" },
-        { value: "default", label: "Install the full default roster" },
+        { value: "default", label: "Install the full default roster", hint: "recommended" },
+        { value: "guided", label: "Choose agents and domains" },
         { value: "no", label: "Skip roster setup" }
       ]
     });
@@ -4912,7 +5010,13 @@ async function promptOptionalCompanionPluginTargets(input) {
   if (!input.interactive) {
     return [];
   }
-  const statuses = await listOrgxPluginStatuses();
+  let statuses = input.statuses;
+  if (!statuses) {
+    const spinner = createOrgxSpinner("Checking optional OrgX plugin and Cursor rules status");
+    spinner.start();
+    statuses = await listOrgxPluginStatuses();
+    spinner.succeed("Optional OrgX plugin and Cursor rules status checked");
+  }
   const installable = statuses.filter((status) => status.available && !status.installed);
   if (installable.length === 0) {
     return [];
@@ -4963,7 +5067,8 @@ async function installSelectedCompanionPlugins(input) {
 }
 async function maybeInstallOptionalCompanionPlugins(input) {
   const selection = await promptOptionalCompanionPluginTargets({
-    interactive: input.interactive
+    interactive: input.interactive,
+    ...input.statuses ? { statuses: input.statuses } : {}
   });
   if (selection === "cancelled") {
     return "cancelled";
@@ -5051,7 +5156,7 @@ function printDoctorReport(report, assessment) {
 async function main() {
   const program = new Command();
   program.name("orgx-wizard").description("One-line CLI onboarding for OrgX surfaces.").showHelpAfterError();
-  const pkgVersion = true ? "0.1.9" : void 0;
+  const pkgVersion = true ? "0.1.10" : void 0;
   program.version(pkgVersion ?? "unknown", "-V, --version");
   program.hook("preAction", () => {
     console.log(renderBanner(pkgVersion));
@@ -5162,6 +5267,7 @@ async function main() {
     const results = await setupDetectedSurfaces();
     spinner.succeed("Detected surfaces configured");
     printMutationResults(results);
+    const pluginStatuses = await printPluginStatusSection();
     await safeTrackWizardTelemetry("mcp_injected", {
       changed_count: results.filter((result) => result.changed).length,
       preset: "standard",
@@ -5250,6 +5356,7 @@ async function main() {
       }
       const pluginInstallResult = await maybeInstallOptionalCompanionPlugins({
         interactive,
+        statuses: pluginStatuses,
         telemetry: { command: "setup", preset: "standard" }
       });
       if (pluginInstallResult === "cancelled") {
@@ -5420,6 +5527,51 @@ async function main() {
       );
     }
   });
+  program.command("uninstall").description("Remove OrgX-managed surfaces, companion plugins/rules, auth, and wizard state from this machine.").option("--keep-auth", "Keep the wizard-local saved OrgX API key.").option("--keep-state", "Keep wizard-local setup state.").option("--skip-plugins", "Skip companion plugin and Cursor rules removal.").option("--skip-surfaces", "Skip MCP surface config removal.").action(async (options) => {
+    await safeTrackWizardTelemetry("wizard_uninstalled", {
+      keep_auth: Boolean(options.keepAuth),
+      keep_state: Boolean(options.keepState),
+      skip_plugins: Boolean(options.skipPlugins),
+      skip_surfaces: Boolean(options.skipSurfaces)
+    });
+    console.log(pc3.bold("Removing OrgX wizard-managed configuration"));
+    if (options.skipSurfaces) {
+      console.log(`  ${ICON.skip}  ${pc3.bold("surfaces".padEnd(10))} ${pc3.dim("skipped")}`);
+    } else {
+      console.log("");
+      console.log(pc3.dim("  surfaces"));
+      const surfaceResults = removeSurface(["all"]);
+      printMutationResults(surfaceResults);
+    }
+    if (options.skipPlugins) {
+      console.log(`  ${ICON.skip}  ${pc3.bold("plugins".padEnd(12))} ${pc3.dim("skipped")}`);
+    } else {
+      console.log("");
+      console.log(pc3.dim("  plugins"));
+      const spinner = createOrgxSpinner("Removing OrgX companion plugins and rules");
+      spinner.start();
+      const pluginReport = await uninstallOrgxPlugins({ targets: ["all"] });
+      spinner.succeed("OrgX companion plugins and rules processed");
+      printPluginMutationReport(pluginReport);
+    }
+    console.log("");
+    if (options.keepAuth) {
+      console.log(`  ${ICON.skip}  ${pc3.bold("auth".padEnd(12))} ${pc3.dim("kept")}`);
+    } else {
+      const removedAuth = await clearWizardAuth();
+      const state = removedAuth ? pc3.green("updated  ") : pc3.dim("unchanged");
+      const message = removedAuth ? "Removed the wizard-local OrgX API key." : "No wizard-local OrgX API key was stored.";
+      console.log(`  ${removedAuth ? ICON.ok : ICON.skip}  ${pc3.bold("auth".padEnd(12))} ${state}  ${pc3.dim(message)}`);
+    }
+    if (options.keepState) {
+      console.log(`  ${ICON.skip}  ${pc3.bold("state".padEnd(12))} ${pc3.dim("kept")}`);
+    } else {
+      const removedState = clearWizardState();
+      const state = removedState ? pc3.green("updated  ") : pc3.dim("unchanged");
+      const message = removedState ? "Removed wizard-local setup state." : "No wizard-local setup state was stored.";
+      console.log(`  ${removedState ? ICON.ok : ICON.skip}  ${pc3.bold("state".padEnd(12))} ${state}  ${pc3.dim(message)}`);
+    }
+  });
   const surface = program.command("surface").description("Manage supported OrgX surfaces.");
   surface.command("list").description("Show supported surfaces and their current status.").action(() => {
     printSurfaceTable(listSurfaceStatuses());
@@ -5441,15 +5593,15 @@ async function main() {
     const results = removeMcpSurface(names);
     printMutationResults(results);
   });
-  const plugins = program.command("plugins").description("Install or remove companion OrgX plugins for Claude Code, Codex, and OpenClaw.");
+  const plugins = program.command("plugins").description("Install or remove Cursor rules and companion OrgX plugins for Claude Code, Codex, and OpenClaw.");
   plugins.command("list").description("Show companion plugin availability and install status.").action(async () => {
-    const spinner = createOrgxSpinner("Checking companion plugin status");
+    const spinner = createOrgxSpinner("Checking OrgX plugin and Cursor rules status");
     spinner.start();
     const statuses = await listOrgxPluginStatuses();
-    spinner.stop();
+    spinner.succeed("OrgX plugin and Cursor rules status checked");
     printPluginStatusReport(statuses);
   });
-  plugins.command("add").description("Install OrgX companion plugins into Claude Code, Codex, or OpenClaw.").argument("[targets...]", "claude, codex, openclaw, or all", ["all"]).action(async (targets) => {
+  plugins.command("add").description("Install Cursor OrgX rules or companion plugins into Claude Code, Codex, and OpenClaw.").argument("[targets...]", "cursor, claude, codex, openclaw, or all", ["all"]).action(async (targets) => {
     const spinner = createOrgxSpinner("Installing OrgX companion plugins");
     spinner.start();
     const report = await installOrgxPlugins({ targets });
@@ -5463,7 +5615,7 @@ async function main() {
       target_count: report.results.length
     });
   });
-  plugins.command("remove").description("Uninstall managed OrgX companion plugins from Claude Code, Codex, or OpenClaw.").argument("[targets...]", "claude, codex, openclaw, or all", ["all"]).action(async (targets) => {
+  plugins.command("remove").description("Uninstall managed Cursor OrgX rules or companion plugins from Claude Code, Codex, and OpenClaw.").argument("[targets...]", "cursor, claude, codex, openclaw, or all", ["all"]).action(async (targets) => {
     const spinner = createOrgxSpinner("Removing OrgX companion plugins");
     spinner.start();
     const report = await uninstallOrgxPlugins({ targets });