bitfab-cli 0.1.0

package/dist/claude.d.ts

@@ -0,0 +1,2 @@
+export declare function runClaudeInit(): Promise<void>;
+export declare function enableAutoUpdate(settingsPath: string): void;

package/dist/claude.js

@@ -0,0 +1,49 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const REPO = "Project-White-Rabbit/bitfab-claude-plugin";
+const MARKETPLACE = "bitfab";
+const PLUGIN_KEY = "bitfab@bitfab";
+const SETUP_COMMAND = "/bitfab:setup";
+export async function runClaudeInit() {
+    runStep("Adding bitfab marketplace", () => {
+        runClaude(["plugin", "marketplace", "add", REPO]);
+    });
+    runStep("Enabling auto-updates for bitfab marketplace", () => {
+        enableAutoUpdate(path.join(os.homedir(), ".claude", "settings.json"));
+    });
+    runStep("Installing bitfab plugin", () => {
+        runClaude(["plugin", "install", PLUGIN_KEY, "--scope", "user"]);
+    });
+    process.stdout.write(`\n✓ Bitfab plugin installed in Claude Code\n`);
+    process.stdout.write(`  Launching ${SETUP_COMMAND}...\n\n`);
+    spawnSync("claude", [SETUP_COMMAND], { stdio: "inherit" });
+}
+function runStep(label, fn) {
+    process.stdout.write(`→ ${label}\n`);
+    fn();
+}
+function runClaude(args) {
+    const result = spawnSync("claude", [...args], { stdio: "inherit" });
+    if (result.status !== 0) {
+        throw new Error(`claude ${args.join(" ")} failed${result.status === null ? "" : ` with status ${result.status}`}`);
+    }
+}
+export function enableAutoUpdate(settingsPath) {
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+        const raw = fs.readFileSync(settingsPath, "utf-8");
+        settings = raw.trim() === "" ? {} : JSON.parse(raw);
+    }
+    const marketplaces = settings.extraKnownMarketplaces ?? {};
+    const existing = marketplaces[MARKETPLACE] ?? {};
+    marketplaces[MARKETPLACE] = {
+        ...existing,
+        source: existing.source ?? { source: "github", repo: REPO },
+        autoUpdate: true,
+    };
+    settings.extraKnownMarketplaces = marketplaces;
+    fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
+    fs.writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`);
+}

package/dist/codex.d.ts

@@ -0,0 +1,7 @@
+export declare function runCodexInit(): Promise<void>;
+/**
+ * Ensure `[plugins."bitfab@bitfab"] enabled = true` is present in the Codex
+ * config TOML. Append-or-replace via regex — we only touch this one section
+ * and never re-emit the rest of the file.
+ */
+export declare function enableCodexPlugin(configPath: string): void;

package/dist/codex.js

@@ -0,0 +1,48 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const REPO = "Project-White-Rabbit/bitfab-codex-plugin";
+const PLUGIN_KEY = "bitfab@bitfab";
+const SETUP_COMMAND = "$bitfab:setup";
+export async function runCodexInit() {
+    process.stdout.write("→ Adding bitfab marketplace\n");
+    const result = spawnSync("codex", ["plugin", "marketplace", "add", REPO], {
+        stdio: "inherit",
+    });
+    if (result.status !== 0) {
+        throw new Error(`codex plugin marketplace add failed${result.status === null ? "" : ` with status ${result.status}`}`);
+    }
+    process.stdout.write("→ Enabling bitfab plugin in ~/.codex/config.toml\n");
+    enableCodexPlugin(path.join(os.homedir(), ".codex", "config.toml"));
+    process.stdout.write(`\n✓ Bitfab plugin installed in Codex\n`);
+    process.stdout.write(`  Launching ${SETUP_COMMAND}...\n\n`);
+    spawnSync("codex", [SETUP_COMMAND], { stdio: "inherit" });
+}
+/**
+ * Ensure `[plugins."bitfab@bitfab"] enabled = true` is present in the Codex
+ * config TOML. Append-or-replace via regex — we only touch this one section
+ * and never re-emit the rest of the file.
+ */
+export function enableCodexPlugin(configPath) {
+    let content = "";
+    if (fs.existsSync(configPath)) {
+        content = fs.readFileSync(configPath, "utf-8");
+    }
+    const header = `[plugins."${PLUGIN_KEY}"]`;
+    const desiredSection = `${header}\nenabled = true\n`;
+    const sectionRegex = new RegExp(`\\[plugins\\."${escapeRegex(PLUGIN_KEY)}"\\][^\\[]*`, "m");
+    let next;
+    if (sectionRegex.test(content)) {
+        next = content.replace(sectionRegex, desiredSection);
+    }
+    else {
+        const trimmed = content.replace(/\s+$/, "");
+        next = trimmed === "" ? desiredSection : `${trimmed}\n\n${desiredSection}`;
+    }
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    fs.writeFileSync(configPath, next);
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}

package/dist/cursor.d.ts

@@ -0,0 +1 @@
+export declare function runCursorInit(): Promise<void>;

package/dist/cursor.js

@@ -0,0 +1,40 @@
+import { spawn, spawnSync } from "node:child_process";
+import os from "node:os";
+const REPO = "Project-White-Rabbit/bitfab-cursor-plugin";
+const ADD_PLUGIN_CMD = `/add-plugin ${REPO}`;
+const SETUP_COMMAND = "/bitfab-setup";
+export async function runCursorInit() {
+    const copied = copyToClipboard(ADD_PLUGIN_CMD);
+    if (copied) {
+        process.stdout.write(`✓ Copied to clipboard: ${ADD_PLUGIN_CMD}\n\n`);
+    }
+    else {
+        process.stdout.write(`Copy the following command:\n  ${ADD_PLUGIN_CMD}\n\n`);
+    }
+    process.stdout.write("To finish setup in Cursor:\n");
+    process.stdout.write(`  1. Run ${ADD_PLUGIN_CMD} (already in your clipboard)\n`);
+    process.stdout.write(`  2. Then run ${SETUP_COMMAND}\n\n`);
+    process.stdout.write("Opening Cursor...\n");
+    const child = spawn("cursor", ["."], { stdio: "ignore", detached: true });
+    child.unref();
+}
+function copyToClipboard(text) {
+    const cmd = clipboardCommand();
+    if (!cmd) {
+        return false;
+    }
+    const result = spawnSync(cmd.bin, cmd.args, {
+        input: text,
+        stdio: ["pipe", "ignore", "ignore"],
+    });
+    return result.status === 0;
+}
+function clipboardCommand() {
+    if (os.platform() === "darwin") {
+        return { bin: "pbcopy", args: [] };
+    }
+    if (os.platform() === "linux") {
+        return { bin: "xclip", args: ["-selection", "clipboard"] };
+    }
+    return null;
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { runInit } from "./init.js";
+const HELP_TEXT = `Usage: bitfab-cli <command> [options]
+
+Commands:
+  init [--editor <name>]   Install the Bitfab plugin in one editor and launch /bitfab:setup
+                           Editor names: claude, codex, cursor
+  help                     Show this help
+
+Examples:
+  bitfab-cli init                       Detect editors, prompt if multiple
+  bitfab-cli init --editor claude       Install for Claude Code, skip prompt
+  bitfab-cli init --editor codex
+  bitfab-cli init --editor cursor
+`;
+function parseArgs(argv) {
+    const [command, ...rest] = argv;
+    let editor;
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        if (arg === "--editor" || arg === "-e") {
+            if (i + 1 < rest.length) {
+                editor = rest[i + 1];
+                i++;
+            }
+            else {
+                throw new Error("--editor flag requires a value");
+            }
+        }
+        else if (arg?.startsWith("--editor=")) {
+            editor = arg.slice("--editor=".length);
+        }
+    }
+    return { command, editor };
+}
+async function main() {
+    const { command, editor } = parseArgs(process.argv.slice(2));
+    if (!command ||
+        command === "help" ||
+        command === "--help" ||
+        command === "-h") {
+        process.stdout.write(HELP_TEXT);
+        return;
+    }
+    if (command === "init") {
+        await runInit({ editor });
+        return;
+    }
+    process.stderr.write(`Unknown command: ${command}\n\n${HELP_TEXT}`);
+    process.exit(1);
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`Error: ${message}\n`);
+    process.exit(1);
+});

package/dist/init.d.ts

@@ -0,0 +1,5 @@
+interface InitOptions {
+    editor: string | undefined;
+}
+export declare function runInit({ editor }: InitOptions): Promise<void>;
+export {};

package/dist/init.js

@@ -0,0 +1,91 @@
+import { execSync } from "node:child_process";
+import readline from "node:readline/promises";
+import { runClaudeInit } from "./claude.js";
+import { runCodexInit } from "./codex.js";
+import { runCursorInit } from "./cursor.js";
+const EDITORS = ["claude", "codex", "cursor"];
+const EDITOR_LABEL = {
+    claude: "Claude Code",
+    codex: "Codex",
+    cursor: "Cursor",
+};
+function detectInstalledEditors() {
+    return EDITORS.filter((e) => isOnPath(e));
+}
+function isOnPath(binary) {
+    try {
+        const cmd = process.platform === "win32" ? "where" : "command -v";
+        execSync(`${cmd} ${binary}`, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function pickEditor(detected) {
+    if (detected.length === 1) {
+        return detected[0];
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        process.stdout.write("\nMultiple editors detected:\n");
+        detected.forEach((e, i) => {
+            process.stdout.write(`  ${i + 1}. ${EDITOR_LABEL[e]}\n`);
+        });
+        while (true) {
+            const answer = (await rl.question(`\nSet up which? [1-${detected.length}, default 1]: `)).trim();
+            if (answer === "") {
+                return detected[0];
+            }
+            const num = Number.parseInt(answer, 10);
+            if (Number.isInteger(num) && num >= 1 && num <= detected.length) {
+                return detected[num - 1];
+            }
+            const byName = detected.find((e) => e === answer.toLowerCase());
+            if (byName) {
+                return byName;
+            }
+            process.stdout.write(`Invalid choice: ${answer}\n`);
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function runInit({ editor }) {
+    const detected = detectInstalledEditors();
+    if (detected.length === 0) {
+        throw new Error("No supported editor found on PATH. Install Claude Code, Codex, or Cursor and try again.");
+    }
+    let chosen;
+    if (editor) {
+        if (!EDITORS.includes(editor)) {
+            throw new Error(`Unknown editor: ${editor}. Expected one of: ${EDITORS.join(", ")}`);
+        }
+        if (!detected.includes(editor)) {
+            throw new Error(`${EDITOR_LABEL[editor]} is not installed (binary "${editor}" not found on PATH).`);
+        }
+        chosen = editor;
+    }
+    else {
+        chosen = await pickEditor(detected);
+    }
+    process.stdout.write(`\nSetting up Bitfab in ${EDITOR_LABEL[chosen]}...\n\n`);
+    if (chosen === "claude") {
+        await runClaudeInit();
+    }
+    else if (chosen === "codex") {
+        await runCodexInit();
+    }
+    else {
+        await runCursorInit();
+    }
+    const others = detected.filter((e) => e !== chosen);
+    if (others.length > 0) {
+        const next = others[0];
+        process.stdout.write(`\n  To set up another editor: bitfab-cli init --editor ${next}\n`);
+    }
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "bitfab-cli",
+  "version": "0.1.0",
+  "description": "Install and configure the Bitfab plugin in Claude Code, Codex, or Cursor.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bitfab-cli": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Project-White-Rabbit/ai-assistant",
+    "directory": "bitfab-cli"
+  },
+  "homepage": "https://bitfab.ai",
+  "keywords": [
+    "bitfab",
+    "cli",
+    "claude-code",
+    "codex",
+    "cursor",
+    "plugin"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "tsc": "tsc --noEmit",
+    "knip": "knip",
+    "madge": "madge --ts-config ./tsconfig.json --extensions ts --circular ./src",
+    "validate": "pnpm lint && pnpm tsc && pnpm knip && pnpm madge && pnpm build"
+  },
+  "author": "Bitfab",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.0"
+  }
+}