@chatcut/cli 0.1.0 → 0.1.1

package/README.md

@@ -5,8 +5,8 @@ contains no video editor, second MCP server, downloaded skills catalog, or
 third-party runtime dependencies. Desktop owns editing, agent connections and
 the skills shipped with that app version.
 
-This package is new. The commands below become publicly available after its
-first npm publication; merging the source PR alone does not publish it.
+The `connect` entry point requires `@chatcut/cli` 0.1.1 or later. Merging source
+changes alone does not publish a new npm version.
 
 ```sh
 npx --yes @chatcut/cli app
@@ -29,12 +29,26 @@ Windows uses the signed per-user NSIS installer. OS policy, missing privileges,
 and signature assessment failures retain their original evidence.
 
 ```sh
+chatcut connect --json
+chatcut connect --client codex --json
+chatcut connect --client claude-code --json
 chatcut doctor --json
 chatcut doctor --client codex --json
 chatcut doctor --fix --json
 chatcut update --json
 ```
 
+`connect` is the agent setup entry point. It opens/installs Desktop, asks Desktop
+to register or repair the supported agent integrations and sync its managed
+skills, then verifies the local MCP connection with a real tool call. Tools are
+provided over Desktop's MCP server. Use `--client` to select Codex or Claude Code;
+without it, both supported integrations are considered. The command reuses
+`doctor --fix`, including its standing opt-outs and preservation of custom skills.
+Read the returned findings for skipped hosts or remaining actions; passing checks
+does not mean an opted-out or unavailable host was connected. Start a new agent
+conversation after connection or skill changes to load the current tools and skills.
+JSON results identify this entry point with `command: "connect"`.
+
 Doctor without `--fix` does not install or open Desktop or change agent settings.
 It inspects a running Desktop through its authenticated user-scoped IPC, then
 starts a fresh local MCP client, negotiates the protocol, lists tools and calls

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatcut/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Install, open, diagnose and repair ChatCut Desktop",
   "license": "UNLICENSED",
   "bin": {

package/src/cli.mjs

@@ -9,12 +9,13 @@ const HELP = `ChatCut — your desktop video editor
 Usage:
   chatcut                         Open Desktop; install it if needed
   chatcut app                     Same as chatcut
+  chatcut connect [--json]         Open Desktop, connect agents and sync skills
   chatcut doctor [--json]          Check Desktop, MCP and managed skills
   chatcut doctor --fix [--json]    Repair supported connection and skill issues
   chatcut update [--json]          Update Desktop after closing it
 
 Options:
-  --client codex|claude-code       Limit doctor to one agent integration
+  --client codex|claude-code       Limit connect or doctor to one integration
   --json                          Write one structured result to stdout
   --help                          Show help without opening Desktop
   --version                       Show CLI version
@@ -51,11 +52,13 @@ export async function runCli(args, dependencies = {}) {
     const command = positionals[0] ?? "app";
     if (
       positionals.length > 1 ||
-      !["app", "doctor", "update"].includes(command)
+      !["app", "connect", "doctor", "update"].includes(command)
     )
       throw new Error("Unknown command. Run chatcut --help.");
-    if ((values.fix || values.client) && command !== "doctor")
-      throw new Error("--fix and --client apply only to chatcut doctor.");
+    if (values.fix && command !== "doctor")
+      throw new Error("--fix applies only to chatcut doctor.");
+    if (values.client && !["connect", "doctor"].includes(command))
+      throw new Error("--client applies only to chatcut connect or doctor.");
     if (values.client && !["claude-code", "codex"].includes(values.client))
       throw new Error("--client must be codex or claude-code.");
     const options = {
@@ -63,12 +66,13 @@ export async function runCli(args, dependencies = {}) {
         stderr.write(`${typeof entry === "string" ? entry : entry.message}\n`),
     };
     let result;
-    if (command === "doctor") {
+    if (command === "doctor" || command === "connect") {
       result = await (dependencies.doctor ?? runDoctor)({
         ...options,
         client: values.client,
-        fix: !!values.fix,
+        fix: command === "connect" || !!values.fix,
       });
+      result = { ...result, command };
     } else {
       const desktop = await (
         command === "app"
@@ -78,9 +82,11 @@ export async function runCli(args, dependencies = {}) {
       result = { command, desktop, ok: true, schemaVersion: 1 };
     }
     if (json) stdout.write(`${JSON.stringify(result)}\n`);
-    else if (command === "doctor") {
+    else if (command === "doctor" || command === "connect") {
       stdout.write(
-        `ChatCut Doctor: ${result.ok ? "healthy" : "issues found"}\n`,
+        command === "connect"
+          ? `ChatCut Connect: ${result.ok ? "checks passed" : "issues found"}\n`
+          : `ChatCut Doctor: ${result.ok ? "healthy" : "issues found"}\n`,
       );
       for (const check of result.checks)
         stdout.write(

package/src/desktop.mjs

@@ -308,7 +308,7 @@ async function install(ctx, previous, updating) {
           : "macos-x64"
         : "windows";
     try {
-      await ctx.download(`${DOWNLOAD_ROOT}${target}`, artifact);
+      await ctx.download(`${DOWNLOAD_ROOT}${target}?src=cli`, artifact);
     } catch (cause) {
       throw new DesktopError(
         "download_failed",

package/src/doctor.mjs

@@ -95,6 +95,7 @@ export async function runDoctor(options = {}, dependencies = {}) {
       )) {
         if (
           integration.status === "unavailable" ||
+          integration.status === "disabled" ||
           integration.status === "opted-out"
         ) {
           findings.push({