@impractical-ai/motion 0.1.4 → 0.1.5

package/README.md

@@ -1,22 +1,34 @@
 # Impractical Motion CLI
 
-Connect Claude Code to Impractical Motion through its MCP server.
+Connect Claude Code, Codex, Cursor, or OpenCode to Impractical Motion through
+its MCP server.
 
 ## Requirements
 
 - Node.js 22 or newer
-- Claude Code installed and signed in
+- At least one supported coding agent: Claude Code, Codex, Cursor, or OpenCode
 - Google Chrome or Chromium for frame inspection
 
 ## Setup
 
+```sh
+npx --yes @impractical-ai/motion setup --agent
+```
+
+Approve the device code in the browser, then restart the detected coding agents.
+Setup installs the global `impractical` MCP configuration for every detected
+Claude Code, Codex, Cursor, and OpenCode client, plus the shared skill for Claude
+Code and Codex. Re-running setup verifies and reuses a working credential,
+preserves unrelated client configuration, and does not require another browser
+authorization.
+
+For the full Claude Code plugin workflow, run:
+
 ```sh
 npx --yes @impractical-ai/motion setup --claude
 ```
 
-Approve the device code in the browser, then run `/reload-plugins` in Claude Code and type
-`continue`. Re-running setup verifies and reuses a working credential, refreshes the user-scoped
-plugin, and does not require another browser authorization.
+Then run `/reload-plugins` in Claude Code and type `continue`.
 
 Setup writes the API credential to `~/.impractical/config.json` with mode `0600`. Environment
 variables `IMPRACTICAL_API_KEY`, `IMPRACTICAL_SUPABASE_URL`, and `IMPRACTICAL_APP_URL` take
@@ -24,7 +36,7 @@ precedence over that file.
 
 ## MCP server
 
-The installed Claude plugin launches the server automatically. Other MCP clients can run:
+The installer configures supported clients to run:
 
 ```sh
 npx --yes @impractical-ai/motion@latest mcp

package/assets/impractical/SKILL.md

@@ -13,13 +13,15 @@ source code lives in the cloud, never in the user's project directory.
 ## 0. Setup check (once per session)
 
 Call the `account_status` tool (`whoami` is its legacy alias). If the
-Impractical tools are not available, the Claude plugin is not connected. Tell
-the user to run:
+Impractical tools are not available, the current coding agent is not connected.
+Tell the user to run:
 
-    npx --yes @impractical-ai/motion setup --claude
+    npx --yes @impractical-ai/motion setup --agent
 
-Then ask them to run `/reload-plugins` and type `continue`. If the weekly quota
-is exhausted, call `upgrade` to give the user the authenticated billing page.
+Then ask them to restart or reload their coding agent and type `continue`.
+Claude Code users who specifically want the full plugin can run the same command
+with `--claude` instead. If the weekly quota is exhausted, call `upgrade` to give
+the user the authenticated billing page.
 
 ## 1. Read the engine before you write anything
 

package/dist/{api-64X3G4M2.js → api-KD6BNKBQ.js}

@@ -12,8 +12,8 @@ import {
   waitForJobs,
   withAdmissionReceipt,
   withMeteredCall
-} from "./chunk-M77TS5RO.js";
-import "./chunk-EFP4P3WA.js";
+} from "./chunk-7724464Z.js";
+import "./chunk-JDN3QHCX.js";
 export {
   ApiContractError,
   ApiError,

package/dist/{chunk-M77TS5RO.js → chunk-7724464Z.js}

@@ -2,7 +2,7 @@
 import {
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-EFP4P3WA.js";
+} from "./chunk-JDN3QHCX.js";
 
 // src/config.ts
 import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync, renameSync } from "node:fs";
@@ -44,7 +44,7 @@ function readStoredConfig() {
     if (error instanceof SyntaxError) {
       throw new Error(
         `Invalid JSON in ${configPath()}: ${error.message}
-Run: npx --yes @impractical-ai/motion setup --claude`
+Run: npx --yes @impractical-ai/motion setup --agent`
       );
     }
     throw new Error(
@@ -71,10 +71,10 @@ function saveConfig(patch) {
 function requireConfig() {
   const config = loadConfig();
   if (!config.supabaseUrl) {
-    throw new Error("Not configured. Run: npx --yes @impractical-ai/motion setup --claude");
+    throw new Error("Not configured. Run: npx --yes @impractical-ai/motion setup --agent");
   }
   if (!config.apiKey) {
-    throw new Error("Not connected. Run: npx --yes @impractical-ai/motion setup --claude");
+    throw new Error("Not connected. Run: npx --yes @impractical-ai/motion setup --agent");
   }
   return config;
 }

package/dist/{chunk-KC6BJJXH.js → chunk-DMAQPSA4.js}

@@ -6,14 +6,14 @@ import {
   loadConfig,
   recoverCorruptConfig,
   saveConfig
-} from "./chunk-M77TS5RO.js";
+} from "./chunk-7724464Z.js";
 import {
   PACKAGE_COMMAND,
   PACKAGE_NAME,
   PACKAGE_VERSION,
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-EFP4P3WA.js";
+} from "./chunk-JDN3QHCX.js";
 
 // src/onboarding.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
@@ -27,6 +27,8 @@ var CLAUDE_MARKETPLACE_NAME = "impractical";
 var AUTH_VERIFY_MIN_VERSION = "0.1.2";
 var CLAUDE_INSTALL_COMMAND = "npm install -g @anthropic-ai/claude-code";
 var CLAUDE_INSTALL_URL = "https://code.claude.com/docs/en/installation";
+var MCP_SERVER_NAME = "impractical";
+var MCP_COMMAND = ["npx", "--yes", `${PACKAGE_NAME}@latest`, "mcp"];
 function parseSemver(value) {
   const match = value.trim().match(
     /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/
@@ -106,6 +108,123 @@ function marketplaceSourceLabel(record) {
 function commandResult(command, args) {
   return spawnSync(command, args, { encoding: "utf8", windowsHide: true });
 }
+function commandAvailable(command) {
+  const result = commandResult(command, ["--version"]);
+  return !result.error && result.status === 0;
+}
+function verifyAgentPrerequisites() {
+  const found = commandAvailable("claude") || commandAvailable("codex") || commandAvailable("cursor-agent") || commandAvailable("cursor") || commandAvailable("opencode");
+  if (!found) {
+    throw new Error(
+      "No supported coding agent was detected. Install Claude Code, Codex, Cursor, or OpenCode, then rerun setup."
+    );
+  }
+}
+function commandDetail(result) {
+  return `${result.stdout ?? ""}
+${result.stderr ?? ""}`.trim();
+}
+function runMcpCommand(command, args, harness) {
+  const result = commandResult(command, args);
+  if (!result.error && result.status === 0) return;
+  throw new Error(
+    `${harness} MCP setup failed: ${commandDetail(result) || result.error?.message || "unknown error"}`
+  );
+}
+function hasExpectedMcp(result) {
+  if (result.error || result.status !== 0) return false;
+  const detail = commandDetail(result);
+  return detail.includes("@impractical-ai/motion@latest") && /\bmcp\b/.test(detail);
+}
+function installNativeMcp(command, harness) {
+  if (!commandAvailable(command)) return void 0;
+  const existing = commandResult(command, ["mcp", "get", MCP_SERVER_NAME]);
+  if (!hasExpectedMcp(existing)) {
+    if (command === "claude" && !existing.error && existing.status === 0) {
+      runMcpCommand(command, ["mcp", "remove", MCP_SERVER_NAME, "-s", "user"], harness);
+    }
+    const addArgs = command === "claude" ? ["mcp", "add", "-s", "user", MCP_SERVER_NAME, "--", ...MCP_COMMAND] : ["mcp", "add", MCP_SERVER_NAME, "--", ...MCP_COMMAND];
+    runMcpCommand(command, addArgs, harness);
+  }
+  return { harness };
+}
+function readJsonObject(path) {
+  if (!existsSync(path)) return {};
+  let value;
+  try {
+    value = JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    throw new Error(`Cannot configure MCP because ${path} is not valid JSON.`);
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`Cannot configure MCP because ${path} must contain a JSON object.`);
+  }
+  return value;
+}
+function writeJsonObject(path, value) {
+  mkdirSync(dirname(path), { recursive: true, mode: 448 });
+  writeFileSync(path, `${JSON.stringify(value, null, 2)}
+`, { mode: 384 });
+}
+function installCursorMcp(home) {
+  if (!commandAvailable("cursor-agent") && !commandAvailable("cursor")) return void 0;
+  const path = join(home, ".cursor", "mcp.json");
+  const config = readJsonObject(path);
+  const servers = config.mcpServers && typeof config.mcpServers === "object" && !Array.isArray(config.mcpServers) ? config.mcpServers : {};
+  const expected = {
+    command: MCP_COMMAND[0],
+    args: MCP_COMMAND.slice(1)
+  };
+  if (JSON.stringify(servers[MCP_SERVER_NAME]) === JSON.stringify(expected)) {
+    return { harness: "Cursor", path };
+  }
+  config.mcpServers = {
+    ...servers,
+    [MCP_SERVER_NAME]: expected
+  };
+  writeJsonObject(path, config);
+  return { harness: "Cursor", path };
+}
+function openCodeConfigHome(home) {
+  if (process.env.XDG_CONFIG_HOME?.trim()) return process.env.XDG_CONFIG_HOME.trim();
+  if (process.platform === "win32" && process.env.APPDATA?.trim()) return process.env.APPDATA.trim();
+  return join(home, ".config");
+}
+function verifyAgentConfigs(home = homedir()) {
+  if (commandAvailable("cursor-agent") || commandAvailable("cursor")) {
+    readJsonObject(join(home, ".cursor", "mcp.json"));
+  }
+  if (commandAvailable("opencode")) {
+    readJsonObject(join(openCodeConfigHome(home), "opencode", "opencode.json"));
+  }
+}
+function installOpenCodeMcp(home) {
+  if (!commandAvailable("opencode")) return void 0;
+  const path = join(openCodeConfigHome(home), "opencode", "opencode.json");
+  const config = readJsonObject(path);
+  const servers = config.mcp && typeof config.mcp === "object" && !Array.isArray(config.mcp) ? config.mcp : {};
+  const expected = {
+    type: "local",
+    command: MCP_COMMAND
+  };
+  if (JSON.stringify(servers[MCP_SERVER_NAME]) === JSON.stringify(expected)) {
+    return { harness: "OpenCode", path };
+  }
+  config.mcp = {
+    ...servers,
+    [MCP_SERVER_NAME]: expected
+  };
+  writeJsonObject(path, config);
+  return { harness: "OpenCode", path };
+}
+function installAgentMcps(home = homedir()) {
+  return [
+    installNativeMcp("claude", "Claude Code"),
+    installNativeMcp("codex", "Codex"),
+    installCursorMcp(home),
+    installOpenCodeMcp(home)
+  ].filter((result) => Boolean(result));
+}
 function requireCommand(command, label) {
   const result = commandResult(command, ["--version"]);
   if (result.error || result.status !== 0) {
@@ -288,7 +407,7 @@ function openBrowser(url) {
   });
   return !result.error && result.status === 0;
 }
-async function waitForApproval(supabaseUrl, authorization, log) {
+async function waitForApproval(supabaseUrl, authorization, log, setupFlag) {
   const deadline = Date.parse(authorization.expiresAt);
   const intervalMs = Math.max(1, authorization.intervalSeconds) * 1e3;
   let announced = false;
@@ -304,16 +423,21 @@ async function waitForApproval(supabaseUrl, authorization, log) {
     }
     await delay(intervalMs);
   }
-  throw new Error(`Authorization expired. Run \`${PACKAGE_COMMAND} setup --claude\` again.`);
+  throw new Error(`Authorization expired. Run \`${PACKAGE_COMMAND} setup ${setupFlag}\` again.`);
 }
 async function setup(options) {
   if (options.installClaudePlugin) verifyClaudePrerequisites();
+  if (options.installAgentMcp) {
+    verifyAgentPrerequisites();
+    verifyAgentConfigs();
+  }
   const corruptConfigBackup = recoverCorruptConfig();
   if (corruptConfigBackup) {
     options.log(`Backed up invalid configuration to ${corruptConfigBackup}; starting clean.`);
   }
   const supabaseUrl = process.env.IMPRACTICAL_SUPABASE_URL?.trim() || PRODUCTION_SUPABASE_URL;
   const appUrl = process.env.IMPRACTICAL_APP_URL?.trim() || PRODUCTION_APP_URL;
+  const setupFlag = options.installAgentMcp ? "--agent" : "--claude";
   const existing = loadConfig();
   let apiKey = existing.supabaseUrl === supabaseUrl ? existing.apiKey : void 0;
   let verified;
@@ -340,10 +464,10 @@ async function setup(options) {
       options.log(opened ? "Opened your browser." : "Could not open a browser automatically; use the link above.");
     }
     try {
-      apiKey = await waitForApproval(supabaseUrl, authorization, options.log);
+      apiKey = await waitForApproval(supabaseUrl, authorization, options.log, setupFlag);
     } catch (error) {
       if (error instanceof ApiError && error.status === 410) {
-        throw new Error(`Authorization expired. Run \`${PACKAGE_COMMAND} setup --claude\` again.`);
+        throw new Error(`Authorization expired. Run \`${PACKAGE_COMMAND} setup ${setupFlag}\` again.`);
       }
       throw error;
     }
@@ -351,6 +475,7 @@ async function setup(options) {
     saveConfig({ apiKey, supabaseUrl, appUrl });
   }
   const claudePlugin = options.installClaudePlugin ? installClaudePlugin(options.log) : void 0;
+  const configuredMcps = options.installAgentMcp ? installAgentMcps() : [];
   const installed = options.installAgentSkills ? installSkills() : [];
   const reconciled = reconcileLegacySkills();
   options.log("");
@@ -358,14 +483,21 @@ async function setup(options) {
   for (const skill of installed) {
     options.log(`Installed /impractical for ${skill.harness}.`);
   }
+  for (const mcp of configuredMcps) {
+    options.log(`Configured Impractical MCP for ${mcp.harness}.`);
+  }
   for (const skill of reconciled) {
     options.log(`Refreshed legacy /impractical for ${skill.harness}; previous copy preserved at ${skill.backupPath}.`);
   }
   if (claudePlugin) options.log(pluginResultLine(claudePlugin));
   options.log(`Workspace: ${verified.orgId}${verified.plan ? ` \xB7 ${verified.plan}` : ""}`);
   options.log("");
-  options.log("Run /reload-plugins, then type continue.");
   if (options.installClaudePlugin) {
+    options.log("Run /reload-plugins, then type continue.");
+  } else if (options.installAgentMcp) {
+    options.log("Restart your coding agents, then ask them to use the Impractical MCP.");
+  }
+  if (options.installClaudePlugin || options.installAgentMcp) {
     for (const line of authenticatedWhoamiGuidance()) options.log(line);
   }
   return { installed, appUrl, supabaseUrl };

package/dist/{chunk-EFP4P3WA.js → chunk-JDN3QHCX.js}

@@ -32,7 +32,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // package.json
 var package_default = {
   name: "@impractical-ai/motion",
-  version: "0.1.4",
+  version: "0.1.5",
   private: false,
   description: "Create and refine Impractical Motion videos from coding agents and the terminal.",
   homepage: "https://github.com/Openpod/impractical-motion#readme",

package/dist/{commands-WYBUEYA6.js → commands-Y35XPDVH.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   setup
-} from "./chunk-KC6BJJXH.js";
+} from "./chunk-DMAQPSA4.js";
 import {
   invoke,
   invokeAt,
@@ -11,8 +11,8 @@ import {
   saveConfig,
   studioLink,
   waitForJobs
-} from "./chunk-M77TS5RO.js";
-import "./chunk-EFP4P3WA.js";
+} from "./chunk-7724464Z.js";
+import "./chunk-JDN3QHCX.js";
 
 // src/commands.ts
 import { readFileSync as readFileSync2, writeFileSync } from "node:fs";
@@ -1193,12 +1193,11 @@ var flagList = (flags, name) => {
 var flagBool = (flags, name) => flags[name] === true;
 var out = (line) => console.log(line);
 async function setup2(flags) {
-  const claude = flagBool(flags, "claude") || flagBool(flags, "agent");
-  if (flagBool(flags, "agent")) {
-    out("Note: --agent is deprecated; use --claude next time.");
-  }
+  const claude = flagBool(flags, "claude");
+  const agent = flagBool(flags, "agent");
   await setup({
-    installAgentSkills: false,
+    installAgentMcp: agent,
+    installAgentSkills: agent,
     installClaudePlugin: claude,
     openBrowser: !flagBool(flags, "no-open"),
     log: out
@@ -1214,7 +1213,7 @@ async function login(flags) {
   if (appUrl) patch.appUrl = appUrl;
   const config = { ...loadConfig(), ...patch };
   if (!config.apiKey || !config.supabaseUrl) {
-    out("Missing API key. Run: npx --yes @impractical-ai/motion setup --claude");
+    out("Missing API key. Run: npx --yes @impractical-ai/motion setup --agent");
     process.exitCode = 1;
     return;
   }

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   PACKAGE_VERSION
-} from "./chunk-EFP4P3WA.js";
+} from "./chunk-JDN3QHCX.js";
 
 // src/cli-args.ts
 import { parseArgs } from "node:util";
@@ -46,7 +46,7 @@ var HELP = `impractical \u2014 Impractical Motion from your terminal (and your c
 
 Setup
   setup --claude                Sign in and install the Claude plugin + MCP
-  setup --agent                 Deprecated alias for setup --claude
+  setup --agent                 Sign in and install MCP for detected coding agents
   login --key imk_...           Manual credential override for development
   whoami                       Show org and plan status
   keys [list|revoke <id>]      List or revoke agent API keys
@@ -115,7 +115,7 @@ async function runCli(args, deps) {
     case "push":
       throw new Error(
         `\`impractical ${command}\` has been removed. Draft files are edited through the MCP server now \u2014 no working copy on disk. Connect it with:
-  npx --yes @impractical-ai/motion setup --claude`
+  npx --yes @impractical-ai/motion setup --agent`
       );
     case "export":
       commands.validateMeteredCommand("export", rest, flags);
@@ -139,15 +139,15 @@ async function runCli(args, deps) {
 // src/index.ts
 runCli(process.argv.slice(2), {
   writeLine: (line) => console.log(line),
-  loadCommands: () => import("./commands-WYBUEYA6.js"),
-  loadApi: () => import("./api-64X3G4M2.js"),
-  loadMcp: () => import("./stdio-JCRFEHDW.js")
+  loadCommands: () => import("./commands-Y35XPDVH.js"),
+  loadApi: () => import("./api-KD6BNKBQ.js"),
+  loadMcp: () => import("./stdio-ZFPBM6Z6.js")
 }).catch(async (error) => {
-  const { ApiError } = await import("./api-64X3G4M2.js");
+  const { ApiError } = await import("./api-KD6BNKBQ.js");
   if (error instanceof ApiError) {
     console.error(`Error (${error.status} from ${error.fn}): ${error.message}`);
     if (error.status === 429) console.error("Weekly MCP allowance reached. Upgrade or wait for Monday UTC.");
-    if (error.status === 401) console.error("Reconnect with: npx --yes @impractical-ai/motion setup --claude");
+    if (error.status === 401) console.error("Reconnect with: npx --yes @impractical-ai/motion setup --agent");
   } else {
     console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
   }