@opentag/cli 0.2.0 → 0.3.0

package/README.md

@@ -12,6 +12,7 @@ Then run:
 
 ```bash
 opentag setup
+opentag doctor
 opentag start
 ```
 
@@ -61,6 +62,16 @@ The setup wizard links to the matching guide for each platform:
 - A local coding agent if you choose Codex or Claude Code.
 - Platform credentials for the platform you connect.
 
+## No Install
+
+The scoped CLI package supports one-off runs without a global install:
+
+```bash
+npx @opentag/cli doctor
+npx @opentag/cli setup
+npx @opentag/cli start
+```
+
 ## Local Development
 
 Inside the OpenTag monorepo, install the development command:

package/dist/catalogs/executors.d.ts

@@ -12,12 +12,12 @@ export type ExecutorDetection = {
     reason: string;
 };
 export declare const EXECUTOR_CATALOG: ExecutorDescriptor[];
-export declare function parseExecutorId(value: string): ExecutorId;
+export declare function isExecutorId(value: string): value is ExecutorId;
 export declare function detectExecutors(env?: NodeJS.ProcessEnv): ExecutorDetection[];
 export declare function defaultExecutorId(input?: {
     previous?: ExecutorId;
     detections?: ExecutorDetection[];
 }): ExecutorId;
-export declare function executorLabel(id: ExecutorId): string;
+export declare function executorLabel(id: string): string;
 export declare function formatExecutors(env?: NodeJS.ProcessEnv): string;
 //# sourceMappingURL=executors.d.ts.map

package/dist/catalogs/executors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executors.d.ts","sourceRoot":"","sources":["../../src/catalogs/executors.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,UAAU,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EAiBhD,CAAC;AAWF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAKzD;AAED,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,EAAE,CAgBzF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,GAAE;IACvC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC7B,GAAG,UAAU,CAYlB;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAEpD;AASD,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAU5E"}
+{"version":3,"file":"executors.d.ts","sourceRoot":"","sources":["../../src/catalogs/executors.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,UAAU,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EAiBhD,CAAC;AAWF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,EAAE,CAgBzF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,GAAE;IACvC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC7B,GAAG,UAAU,CAYlB;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhD;AASD,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAU5E"}

package/dist/config.d.ts

@@ -1,6 +1,5 @@
 import { type OpenTagDaemonConfig } from "@opentag/local-runtime";
 import { z } from "zod";
-import type { ExecutorId } from "./catalogs/executors.js";
 import type { CliLanguage } from "./catalogs/languages.js";
 import type { PlatformId } from "./catalogs/platforms.js";
 export declare const OpenTagCliConfigSchema: z.ZodObject<{
@@ -22,7 +21,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
         language: z.ZodOptional<z.ZodEnum<["en", "zh-CN"]>>;
         lastSetup: z.ZodOptional<z.ZodObject<{
             platforms: z.ZodOptional<z.ZodArray<z.ZodEnum<["lark", "slack", "github", "telegram"]>, "many">>;
-            executor: z.ZodOptional<z.ZodEnum<["echo", "codex", "claude-code"]>>;
+            executor: z.ZodOptional<z.ZodString>;
             projectPath: z.ZodOptional<z.ZodString>;
             larkSetupMethod: z.ZodOptional<z.ZodEnum<["saved", "scan", "manual"]>>;
             larkDomain: z.ZodOptional<z.ZodEnum<["lark", "feishu"]>>;
@@ -37,7 +36,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
             githubAutoCreatePullRequest: z.ZodOptional<z.ZodBoolean>;
         }, "strict", z.ZodTypeAny, {
             platforms?: ("lark" | "slack" | "github" | "telegram")[] | undefined;
-            executor?: "echo" | "codex" | "claude-code" | undefined;
+            executor?: string | undefined;
             projectPath?: string | undefined;
             larkSetupMethod?: "saved" | "scan" | "manual" | undefined;
             larkDomain?: "lark" | "feishu" | undefined;
@@ -52,7 +51,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
             githubAutoCreatePullRequest?: boolean | undefined;
         }, {
             platforms?: ("lark" | "slack" | "github" | "telegram")[] | undefined;
-            executor?: "echo" | "codex" | "claude-code" | undefined;
+            executor?: string | undefined;
             projectPath?: string | undefined;
             larkSetupMethod?: "saved" | "scan" | "manual" | undefined;
             larkDomain?: "lark" | "feishu" | undefined;
@@ -70,7 +69,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
         language?: "en" | "zh-CN" | undefined;
         lastSetup?: {
             platforms?: ("lark" | "slack" | "github" | "telegram")[] | undefined;
-            executor?: "echo" | "codex" | "claude-code" | undefined;
+            executor?: string | undefined;
             projectPath?: string | undefined;
             larkSetupMethod?: "saved" | "scan" | "manual" | undefined;
             larkDomain?: "lark" | "feishu" | undefined;
@@ -88,7 +87,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
         language?: "en" | "zh-CN" | undefined;
         lastSetup?: {
             platforms?: ("lark" | "slack" | "github" | "telegram")[] | undefined;
-            executor?: "echo" | "codex" | "claude-code" | undefined;
+            executor?: string | undefined;
             projectPath?: string | undefined;
             larkSetupMethod?: "saved" | "scan" | "manual" | undefined;
             larkDomain?: "lark" | "feishu" | undefined;
@@ -111,7 +110,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
             owner: z.ZodString;
             repo: z.ZodString;
             checkoutPath: z.ZodString;
-            defaultExecutor: z.ZodEnum<["echo", "codex", "claude-code"]>;
+            defaultExecutor: z.ZodString;
             baseBranch: z.ZodString;
             pushRemote: z.ZodString;
             worktreeRoot: z.ZodString;
@@ -121,7 +120,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
             owner: string;
             repo: string;
             checkoutPath: string;
-            defaultExecutor: "echo" | "codex" | "claude-code";
+            defaultExecutor: string;
             baseBranch: string;
             pushRemote: string;
             worktreeRoot: string;
@@ -131,7 +130,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
             owner: string;
             repo: string;
             checkoutPath: string;
-            defaultExecutor: "echo" | "codex" | "claude-code";
+            defaultExecutor: string;
             baseBranch: string;
             pushRemote: string;
             worktreeRoot: string;
@@ -208,7 +207,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
             owner: string;
             repo: string;
             checkoutPath: string;
-            defaultExecutor: "echo" | "codex" | "claude-code";
+            defaultExecutor: string;
             baseBranch: string;
             pushRemote: string;
             worktreeRoot: string;
@@ -249,7 +248,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
             owner: string;
             repo: string;
             checkoutPath: string;
-            defaultExecutor: "echo" | "codex" | "claude-code";
+            defaultExecutor: string;
             baseBranch: string;
             pushRemote: string;
             worktreeRoot: string;
@@ -468,7 +467,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
             owner: string;
             repo: string;
             checkoutPath: string;
-            defaultExecutor: "echo" | "codex" | "claude-code";
+            defaultExecutor: string;
             baseBranch: string;
             pushRemote: string;
             worktreeRoot: string;
@@ -506,7 +505,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
         language?: "en" | "zh-CN" | undefined;
         lastSetup?: {
             platforms?: ("lark" | "slack" | "github" | "telegram")[] | undefined;
-            executor?: "echo" | "codex" | "claude-code" | undefined;
+            executor?: string | undefined;
             projectPath?: string | undefined;
             larkSetupMethod?: "saved" | "scan" | "manual" | undefined;
             larkDomain?: "lark" | "feishu" | undefined;
@@ -563,7 +562,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
             owner: string;
             repo: string;
             checkoutPath: string;
-            defaultExecutor: "echo" | "codex" | "claude-code";
+            defaultExecutor: string;
             baseBranch: string;
             pushRemote: string;
             worktreeRoot: string;
@@ -601,7 +600,7 @@ export declare const OpenTagCliConfigSchema: z.ZodObject<{
         language?: "en" | "zh-CN" | undefined;
         lastSetup?: {
             platforms?: ("lark" | "slack" | "github" | "telegram")[] | undefined;
-            executor?: "echo" | "codex" | "claude-code" | undefined;
+            executor?: string | undefined;
             projectPath?: string | undefined;
             larkSetupMethod?: "saved" | "scan" | "manual" | undefined;
             larkDomain?: "lark" | "feishu" | undefined;
@@ -624,7 +623,7 @@ export type OpenTagCliPreferences = NonNullable<OpenTagCliConfig["preferences"]>
 export type OpenTagCliLastSetup = NonNullable<OpenTagCliPreferences["lastSetup"]>;
 export type OpenTagCliLanguage = CliLanguage;
 export type OpenTagCliPlatform = PlatformId;
-export type OpenTagCliExecutor = ExecutorId;
+export type OpenTagCliExecutor = string;
 export type PathEnvironment = Partial<Record<"OPENTAG_CONFIG_PATH" | "OPENTAG_CONFIG_HOME" | "OPENTAG_STATE_DIR" | "XDG_CONFIG_HOME" | "XDG_STATE_HOME", string>>;
 export declare function defaultConfigPath(env?: PathEnvironment, home?: string): string;
 export declare function defaultStateDirectory(env?: PathEnvironment, home?: string): string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACnI,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAqJ1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBxB,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAAE,QAAQ,CAAC,GAAG;IACtF,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC;AAClF,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC7C,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAC5C,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAE5C,MAAM,MAAM,eAAe,GAAG,OAAO,CACnC,MAAM,CAAC,qBAAqB,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,gBAAgB,EAAE,MAAM,CAAC,CAC3H,CAAC;AAQF,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,eAA6B,EAAE,IAAI,SAAY,GAAG,MAAM,CAG9F;AAED,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,eAA6B,EAAE,IAAI,SAAY,GAAG,MAAM,CAIlG;AAMD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK3D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAM/D;AAED,wBAAgB,aAAa,CAAC,IAAI,SAAsB,GAAG,gBAAgB,CAG1E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKzD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAYjF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAM1D;AAeD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAEnE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACnI,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAyJ1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBxB,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAAE,QAAQ,CAAC,GAAG;IACtF,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC;AAClF,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC7C,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAC5C,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAExC,MAAM,MAAM,eAAe,GAAG,OAAO,CACnC,MAAM,CAAC,qBAAqB,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,gBAAgB,EAAE,MAAM,CAAC,CAC3H,CAAC;AAQF,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,eAA6B,EAAE,IAAI,SAAY,GAAG,MAAM,CAG9F;AAED,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,eAA6B,EAAE,IAAI,SAAY,GAAG,MAAM,CAIlG;AAMD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK3D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAM/D;AAED,wBAAgB,aAAa,CAAC,IAAI,SAAsB,GAAG,gBAAgB,CAG1E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKzD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAYjF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAM1D;AAeD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAEnE"}

package/dist/index.js

@@ -10,7 +10,7 @@ import { homedir } from "os";
 import { dirname, join, resolve } from "path";
 import { formatConfigError as formatDaemonConfigError, parseDaemonConfig } from "@opentag/local-runtime";
 import { z } from "zod";
-var ExecutorSchema = z.enum(["echo", "codex", "claude-code"]);
+var ExecutorIdSchema = z.string().trim().min(1);
 var KeepWorktreeSchema = z.enum(["always", "on_failure", "never"]);
 var PositiveIntegerSchema = z.number().int().positive();
 var CliLanguageSchema = z.enum(["en", "zh-CN"]);
@@ -24,7 +24,7 @@ var RepositoryBindingSchema = z.object({
   owner: z.string().min(1),
   repo: z.string().min(1),
   checkoutPath: z.string().min(1),
-  defaultExecutor: ExecutorSchema,
+  defaultExecutor: ExecutorIdSchema,
   baseBranch: z.string().min(1),
   pushRemote: z.string().min(1),
   worktreeRoot: z.string().min(1),
@@ -110,7 +110,7 @@ var PreferencesSchema = z.object({
   language: CliLanguageSchema.optional(),
   lastSetup: z.object({
     platforms: z.array(PlatformSchema).optional(),
-    executor: ExecutorSchema.optional(),
+    executor: ExecutorIdSchema.optional(),
     projectPath: z.string().min(1).optional(),
     larkSetupMethod: LarkSetupMethodSchema.optional(),
     larkDomain: z.enum(["lark", "feishu"]).optional(),
@@ -244,11 +244,8 @@ function pathExistsOnPath(command, env = process.env) {
   const candidates = process.platform === "win32" && !extname(command) ? [command, ...(env.PATHEXT?.split(delimiter).filter(Boolean) ?? [".COM", ".EXE", ".BAT", ".CMD"]).map((extension) => `${command}${extension.toLowerCase()}`)] : [command];
   return paths.some((directory) => candidates.some((candidate) => existsSync(join2(directory, candidate))));
 }
-function parseExecutorId(value) {
-  if (value === "echo" || value === "codex" || value === "claude-code") {
-    return value;
-  }
-  throw new Error("Executor must be echo, codex, or claude-code.");
+function isExecutorId(value) {
+  return value === "echo" || value === "codex" || value === "claude-code";
 }
 function detectExecutors(env = process.env) {
   return EXECUTOR_CATALOG.map((executor) => {
@@ -652,6 +649,7 @@ var MESSAGES = {
     language: "Language / \u8BED\u8A00",
     platform: "Where should OpenTag listen?",
     executor: "Which coding agent should OpenTag use?",
+    executorCustomHint: "Currently configured custom executor",
     projectPath: "Which project should OpenTag use?",
     larkSetup: "How should OpenTag connect to Lark / Feishu?",
     larkDomain: "Which Lark domain should OpenTag use?",
@@ -681,6 +679,7 @@ var MESSAGES = {
     language: "Language / \u8BED\u8A00",
     platform: "OpenTag \u8981\u76D1\u542C\u54EA\u4E2A\u5E73\u53F0\uFF1F",
     executor: "OpenTag \u8981\u4F7F\u7528\u54EA\u4E2A coding agent\uFF1F",
+    executorCustomHint: "\u5F53\u524D\u914D\u7F6E\u7684\u81EA\u5B9A\u4E49\u6267\u884C\u5668",
     projectPath: "OpenTag \u8981\u4F7F\u7528\u54EA\u4E2A\u9879\u76EE\uFF1F",
     larkSetup: "OpenTag \u8981\u5982\u4F55\u8FDE\u63A5 Lark / \u98DE\u4E66\uFF1F",
     larkDomain: "OpenTag \u8981\u4F7F\u7528\u54EA\u4E2A Lark \u57DF\u540D\uFF1F",
@@ -822,7 +821,7 @@ function setupNeeds(platform, language) {
       case "lark":
         return ["\u63A8\u8350\u76F4\u63A5\u626B\u7801\u521B\u5EFA Personal Agent", "\u624B\u52A8\u914D\u7F6E\u65F6\u9700\u8981 Lark App ID \u548C App Secret"];
       case "slack":
-        return ["\u63A8\u8350\u672C\u5730\u4F7F\u7528 Socket Mode", "Socket Mode \u9700\u8981 Slack App-Level Token \u548C Bot User OAuth Token", "Events API \u9700\u8981 Slack Signing Secret \u548C\u516C\u7F51 Request URL", "Slack bot scopes \u9700\u8981 app_mentions:read\u3001chat:write\u3001channels:history", "\u8BA2\u9605 bot events: app_mention\u3001message.channels", "Slack Team ID", "Slack Channel ID", "\u6D4B\u8BD5\u524D\u9700\u8981\u628A Slack app \u9080\u8BF7\u8FDB\u76EE\u6807 channel"];
+        return ["\u63A8\u8350\u672C\u5730\u4F7F\u7528 Socket Mode", "Socket Mode \u9700\u8981 Slack App-Level Token \u548C Bot User OAuth Token", "Events API \u9700\u8981 Slack Signing Secret \u548C\u516C\u7F51 Request URL", "\u5F00\u542F Interactivity & Shortcuts \u4EE5\u652F\u6301 Apply 1 \u6309\u94AE", "Slack bot scopes \u9700\u8981 app_mentions:read\u3001chat:write\u3001reactions:write\u3001channels:history", "\u8BA2\u9605 bot events: app_mention\u3001message.channels", "Slack Team ID", "Slack Channel ID", "\u6D4B\u8BD5\u524D\u9700\u8981\u628A Slack app \u9080\u8BF7\u8FDB\u76EE\u6807 channel"];
       case "github":
         return ["GitHub \u4ED3\u5E93 owner/repo", "GitHub token\uFF08\u7528\u4E8E\u56DE\u5199\u8BC4\u8BBA\uFF1B\u4F60\u56DE\u590D apply 1 \u540E\u4E5F\u7528\u4E8E\u521B\u5EFA PR\uFF09", "OpenTag \u4F1A\u81EA\u52A8\u751F\u6210 webhook secret", "\u672C\u5730 webhook \u7AEF\u53E3\uFF0C\u9ED8\u8BA4 3050", "\u9700\u8981\u4E00\u4E2A\u516C\u7F51 tunnel \u8F6C\u53D1 GitHub webhook"];
       case "telegram":
@@ -833,7 +832,7 @@ function setupNeeds(platform, language) {
     case "lark":
       return ["QR scan is the recommended path", "manual setup needs a Lark App ID and App Secret"];
     case "slack":
-      return ["Socket Mode is recommended for local OpenTag", "Socket Mode needs a Slack App-Level Token and Bot User OAuth Token", "Events API needs a Slack Signing Secret and public Request URL", "Slack bot scopes need app_mentions:read, chat:write, channels:history", "Subscribe to bot events: app_mention, message.channels", "Slack Team ID", "Slack Channel ID", "Invite the Slack app to the target channel before testing"];
+      return ["Socket Mode is recommended for local OpenTag", "Socket Mode needs a Slack App-Level Token and Bot User OAuth Token", "Events API needs a Slack Signing Secret and public Request URL", "Enable Interactivity & Shortcuts for Apply 1 buttons", "Slack bot scopes need app_mentions:read, chat:write, reactions:write, channels:history", "Subscribe to bot events: app_mention, message.channels", "Slack Team ID", "Slack Channel ID", "Invite the Slack app to the target channel before testing"];
     case "github":
       return ["GitHub repository owner/repo", "GitHub token for comments and PR creation after you reply `apply 1`", "OpenTag generates the webhook secret", "Local webhook port, default 3050", "A public tunnel is required for GitHub webhook delivery"];
     case "telegram":
@@ -940,18 +939,19 @@ function formatSlackCredentialHelp(language, mode) {
     const modeSpecific2 = mode === "socket_mode" ? [
       `- Socket Mode \u5B98\u65B9\u6587\u6863: ${OFFICIAL_SETUP_LINKS.slackSocketModeDocs}`,
       "- Slack App-Level Token: Basic Information -> App-Level Tokens -> Generate Token and Scopes\uFF0Cscope \u9009 connections:write",
-      "- Socket Mode \u4E0D\u9700\u8981 Request URL"
+      "- Interactivity & Shortcuts: \u6253\u5F00 Interactivity\uFF1BSocket Mode \u4E0D\u9700\u8981 Request URL"
     ] : [
       `- Signing Secret \u5B98\u65B9\u6587\u6863: ${OFFICIAL_SETUP_LINKS.slackSigningSecretDocs}`,
       "- Slack Signing Secret: Basic Information -> App Credentials",
-      "- Request URL: \u586B\u4F60\u7684\u516C\u7F51 tunnel\uFF0C\u4F8B\u5982 https://<your-tunnel>/slack/events"
+      "- Event Subscriptions Request URL: \u586B\u4F60\u7684\u516C\u7F51 tunnel\uFF0C\u4F8B\u5982 https://<your-tunnel>/slack/events",
+      "- Interactivity & Shortcuts Request URL: \u586B\u540C\u4E00\u4E2A https://<your-tunnel>/slack/events"
     ];
     return [
       "Slack \u8FD9\u4E9B\u503C\u5728\u54EA\u91CC\u62FF:",
       `- Slack App \u7BA1\u7406\u9875: ${OFFICIAL_SETUP_LINKS.slackApps}`,
       ...modeSpecific2,
       "- Slack Bot User OAuth Token: OAuth & Permissions -> Bot User OAuth Token",
-      "- Bot Token Scopes: app_mentions:read, chat:write, channels:history",
+      "- Bot Token Scopes: app_mentions:read, chat:write, reactions:write, channels:history",
       "- Bot Events: app_mention, message.channels",
       "- Team ID / Channel ID: \u7528\u6D4F\u89C8\u5668\u6253\u5F00 Slack channel\uFF0C\u4ECE\u5730\u5740\u91CC\u590D\u5236 T... \u548C C...",
       "- \u6D4B\u8BD5\u524D\u5728\u76EE\u6807 channel \u91CC\u8FD0\u884C /invite @\u4F60\u7684 App \u540D\u79F0\uFF0C\u628A app \u9080\u8BF7\u8FDB channel"
@@ -960,18 +960,19 @@ function formatSlackCredentialHelp(language, mode) {
   const modeSpecific = mode === "socket_mode" ? [
     `- Socket Mode docs: ${OFFICIAL_SETUP_LINKS.slackSocketModeDocs}`,
     "- Slack App-Level Token: Basic Information -> App-Level Tokens -> Generate Token and Scopes, then add connections:write",
-    "- Socket Mode does not need a Request URL"
+    "- Interactivity & Shortcuts: turn Interactivity on; Socket Mode does not need a Request URL"
   ] : [
     `- Signing Secret docs: ${OFFICIAL_SETUP_LINKS.slackSigningSecretDocs}`,
     "- Slack Signing Secret: Basic Information -> App Credentials",
-    "- Request URL: use your public tunnel, for example https://<your-tunnel>/slack/events"
+    "- Event Subscriptions Request URL: use your public tunnel, for example https://<your-tunnel>/slack/events",
+    "- Interactivity & Shortcuts Request URL: use the same https://<your-tunnel>/slack/events"
   ];
   return [
     "Where to find these Slack values:",
     `- Slack app settings: ${OFFICIAL_SETUP_LINKS.slackApps}`,
     ...modeSpecific,
     "- Slack Bot User OAuth Token: OAuth & Permissions -> Bot User OAuth Token",
-    "- Bot Token Scopes: app_mentions:read, chat:write, channels:history",
+    "- Bot Token Scopes: app_mentions:read, chat:write, reactions:write, channels:history",
     "- Bot Events: app_mention, message.channels",
     "- Team ID / Channel ID: open the Slack channel in a browser and copy the T... and C... values from the URL",
     "- Before testing, run /invite @your app name in the target channel so Slack sends mentions to the app"
@@ -1342,32 +1343,42 @@ async function collectPlatform(options, defaults, prompts, language) {
   return selected;
 }
 async function collectExecutor(options, defaults, prompts, language, env) {
-  if (options.executor) {
-    return parseExecutorId(options.executor);
+  if (options.executor !== void 0) {
+    const executor = options.executor.trim();
+    if (executor.length === 0) {
+      throw new Error("Executor id must not be empty.");
+    }
+    return executor;
   }
   const detections = detectExecutors(env);
-  const previous = defaults.executor;
-  const initialValue = defaultExecutorId({
-    ...previous ? { previous } : {},
+  const normalizedPrevious = defaults.executor?.trim();
+  if (normalizedPrevious !== void 0 && normalizedPrevious.length === 0) {
+    throw new Error("Executor id must not be empty.");
+  }
+  const previousBuiltIn = normalizedPrevious !== void 0 && isExecutorId(normalizedPrevious) ? normalizedPrevious : void 0;
+  const customPrevious = normalizedPrevious !== void 0 && previousBuiltIn === void 0 ? normalizedPrevious : void 0;
+  const initialValue = customPrevious ?? defaultExecutorId({
+    ...previousBuiltIn ? { previous: previousBuiltIn } : {},
     detections
   });
+  const builtInOptions = EXECUTOR_CATALOG.map((executor) => {
+    const detection = detections.find((entry) => entry.id === executor.id);
+    return {
+      value: executor.id,
+      label: executor.label,
+      hint: formatExecutorHint({
+        language,
+        executor,
+        available: detection?.available ?? false,
+        current: executor.id === normalizedPrevious,
+        selectedByDefault: executor.id === initialValue
+      })
+    };
+  });
   return prompts.select({
     message: t(language, "executor"),
     initialValue,
-    options: EXECUTOR_CATALOG.map((executor) => {
-      const detection = detections.find((entry) => entry.id === executor.id);
-      return {
-        value: executor.id,
-        label: executor.label,
-        hint: formatExecutorHint({
-          language,
-          executor,
-          available: detection?.available ?? false,
-          current: executor.id === previous,
-          selectedByDefault: executor.id === initialValue
-        })
-      };
-    })
+    options: customPrevious ? [{ value: customPrevious, label: customPrevious, hint: t(language, "executorCustomHint") }, ...builtInOptions] : builtInOptions
   });
 }
 async function collectProjectPath(options, defaults, prompts, language, cwd) {