@opentag/cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amplift
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# @opentag/cli
+
+OpenTag CLI for setting up and running a local OpenTag stack.
+
+## Install
+
+```bash
+npm install -g @opentag/cli
+```
+
+Then run:
+
+```bash
+opentag setup
+opentag start
+```
+
+`opentag setup` walks through the local configuration:
+
+- Choose a language.
+- Choose a platform: Lark / Feishu, Slack, or GitHub.
+- Choose a coding agent: Codex, Claude Code, or Echo for local testing.
+- Configure platform credentials.
+- Bind the selected project.
+- Optionally start OpenTag immediately.
+
+## Commands
+
+```bash
+opentag setup
+opentag start
+opentag status
+opentag doctor
+opentag config path
+opentag config show
+opentag platforms
+opentag executors
+```
+
+## Local Config
+
+OpenTag stores local configuration at:
+
+```text
+~/.config/opentag/config.json
+```
+
+The config contains local secrets, so the CLI writes it with private file permissions.
+
+## Platform Guides
+
+The setup wizard links to the matching guide for each platform:
+
+- Lark / Feishu: `docs/platforms/lark.en.md`
+- Slack: `docs/platforms/slack.en.md`
+- GitHub: `docs/platforms/github.en.md`
+
+## Requirements
+
+- Node.js 20 or newer.
+- A local coding agent if you choose Codex or Claude Code.
+- Platform credentials for the platform you connect.
+
+## Local Development
+
+Inside the OpenTag monorepo, install the development command:
+
+```bash
+corepack pnpm opentag-dev
+```
+
+Then run:
+
+```bash
+opentag-dev setup
+opentag-dev start
+```

package/dist/catalogs/executors.d.ts

@@ -0,0 +1,23 @@
+export type ExecutorId = "echo" | "codex" | "claude-code";
+export type ExecutorDescriptor = {
+    id: ExecutorId;
+    label: string;
+    command?: string;
+    alwaysAvailable?: boolean;
+    devOnly?: boolean;
+};
+export type ExecutorDetection = {
+    id: ExecutorId;
+    available: boolean;
+    reason: string;
+};
+export declare const EXECUTOR_CATALOG: ExecutorDescriptor[];
+export declare function parseExecutorId(value: string): 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 formatExecutors(env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=executors.d.ts.map

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

@@ -0,0 +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"}

package/dist/catalogs/languages.d.ts

@@ -0,0 +1,8 @@
+export type CliLanguage = "en" | "zh-CN";
+export declare const LANGUAGE_OPTIONS: Array<{
+    id: CliLanguage;
+    label: string;
+    hint: string;
+}>;
+export declare function parseCliLanguage(value: string): CliLanguage;
+//# sourceMappingURL=languages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../src/catalogs/languages.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC;AAEzC,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC;IACnC,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAGA,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAK3D"}

package/dist/catalogs/platforms.d.ts

@@ -0,0 +1,16 @@
+import type { CliLanguage } from "./languages.js";
+export type PlatformId = "lark" | "slack" | "github" | "telegram";
+export type PlatformStatus = "setup_ready" | "setup_pending" | "experimental_setup_pending";
+export type PlatformDescriptor = {
+    id: PlatformId;
+    label: string;
+    status: PlatformStatus;
+    startable: boolean;
+};
+export declare const PLATFORM_CATALOG: PlatformDescriptor[];
+export declare function parsePlatformId(value: string): PlatformId;
+export declare function platformById(id: PlatformId): PlatformDescriptor;
+export declare function platformSetupGuideUrl(id: PlatformId, language: CliLanguage): string | undefined;
+export declare function formatPlatformStatus(status: PlatformStatus): string;
+export declare function formatPlatforms(): string;
+//# sourceMappingURL=platforms.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.d.ts","sourceRoot":"","sources":["../../src/catalogs/platforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElE,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,eAAe,GAAG,4BAA4B,CAAC;AAE5F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAmBF,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EAyBhD,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAKzD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,UAAU,GAAG,kBAAkB,CAM/D;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAG/F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CASnE;AAED,wBAAgB,eAAe,IAAI,MAAM,CAOxC"}

package/dist/commands/executors.d.ts

@@ -0,0 +1,5 @@
+export type ExecutorsCommandOptions = {
+    env?: NodeJS.ProcessEnv;
+};
+export declare function runExecutorsCommand(options?: ExecutorsCommandOptions): void;
+//# sourceMappingURL=executors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executors.d.ts","sourceRoot":"","sources":["../../src/commands/executors.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,uBAA4B,GAAG,IAAI,CAE/E"}

package/dist/commands/platforms.d.ts

@@ -0,0 +1,2 @@
+export declare function runPlatformsCommand(): void;
+//# sourceMappingURL=platforms.d.ts.map

package/dist/commands/platforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.d.ts","sourceRoot":"","sources":["../../src/commands/platforms.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/commands/setup.d.ts

@@ -0,0 +1,10 @@
+import { type SetupCommandOptions, type SetupFlowDependencies } from "../setup/flow.js";
+import { type StartCommandOptions } from "../start.js";
+export type { SetupCommandOptions };
+export type SetupCommandDependencies = Partial<Omit<SetupFlowDependencies, "prompts" | "scanLarkPersonalAgent">> & {
+    prompts?: SetupFlowDependencies["prompts"];
+    scanLarkPersonalAgent?: SetupFlowDependencies["scanLarkPersonalAgent"];
+    startOpenTag?(options: StartCommandOptions): Promise<void>;
+};
+export declare function runSetupCommand(options: SetupCommandOptions, dependencies?: SetupCommandDependencies): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAOA,OAAO,EAAqB,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAI3G,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAExE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,uBAAuB,CAAC,CAAC,GAAG;IACjH,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC3C,qBAAqB,CAAC,EAAE,qBAAqB,CAAC,uBAAuB,CAAC,CAAC;IACvE,YAAY,CAAC,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D,CAAC;AAcF,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,YAAY,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC9H"}