theclawbay 0.3.52 → 0.3.54

package/dist/commands/logout.js

@@ -31,7 +31,12 @@ const CONTINUE_CONFIG_PATH = node_path_1.default.join(node_os_1.default.homedir(
 const CLINE_GLOBAL_STATE_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".cline", "data", "globalState.json");
 const CLINE_SECRETS_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".cline", "data", "secrets.json");
 const AIDER_CONFIG_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".aider.conf.yml");
+const GSD_AGENT_DIR = node_path_1.default.join(node_os_1.default.homedir(), ".gsd", "agent");
+const GSD_MODELS_PATH = node_path_1.default.join(GSD_AGENT_DIR, "models.json");
+const GSD_AUTH_PATH = node_path_1.default.join(GSD_AGENT_DIR, "auth.json");
+const GSD_SETTINGS_PATH = node_path_1.default.join(GSD_AGENT_DIR, "settings.json");
 const CLINE_RESTORE_STATE_PATH = node_path_1.default.join(paths_1.theclawbayStateDir, "cline.restore.json");
+const GSD_RESTORE_STATE_PATH = node_path_1.default.join(paths_1.theclawbayStateDir, "gsd.restore.json");
 const OPENCODE_RESTORE_STATE_PATH = node_path_1.default.join(paths_1.theclawbayStateDir, "opencode.restore.json");
 const KILO_RESTORE_STATE_PATH = node_path_1.default.join(paths_1.theclawbayStateDir, "kilo.restore.json");
 const ROO_SETTINGS_STATE_PATH = node_path_1.default.join(paths_1.theclawbayStateDir, "roo-settings.restore.json");
@@ -414,6 +419,168 @@ async function cleanupClineConfig() {
     await removeFileIfExists(CLINE_RESTORE_STATE_PATH);
     return changed;
 }
+function isEmptyObject(value) {
+    return Object.keys(value).length === 0;
+}
+function normalizeGsdRestoreSnapshot(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return null;
+    const obj = value;
+    return {
+        version: 1,
+        modelsExisted: obj.modelsExisted === true,
+        providerConfig: typeof obj.providerConfig === "object" && obj.providerConfig !== null && !Array.isArray(obj.providerConfig)
+            ? obj.providerConfig
+            : null,
+        authExisted: obj.authExisted === true,
+        authEntry: typeof obj.authEntry === "object" && obj.authEntry !== null && !Array.isArray(obj.authEntry)
+            ? obj.authEntry
+            : null,
+        settingsExisted: obj.settingsExisted === true,
+        defaultProvider: typeof obj.defaultProvider === "string" ? obj.defaultProvider : null,
+        defaultModel: typeof obj.defaultModel === "string" ? obj.defaultModel : null,
+    };
+}
+function normalizeGsdCredential(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return null;
+    return { ...value };
+}
+async function cleanupGsdConfig() {
+    const snapshotRaw = await readFileIfExists(GSD_RESTORE_STATE_PATH);
+    if (snapshotRaw === null || !snapshotRaw.trim())
+        return false;
+    let snapshot = null;
+    try {
+        snapshot = normalizeGsdRestoreSnapshot(JSON.parse(snapshotRaw));
+    }
+    catch {
+        snapshot = null;
+    }
+    if (!snapshot)
+        return false;
+    let changed = false;
+    const modelsRaw = await readFileIfExists(GSD_MODELS_PATH);
+    if (modelsRaw !== null) {
+        let fileChanged = false;
+        let doc = objectRecordOr({}, {});
+        try {
+            doc = modelsRaw.trim() ? objectRecordOr(JSON.parse(modelsRaw), {}) : {};
+        }
+        catch {
+            doc = {};
+        }
+        const providersRoot = objectRecordOr(doc.providers, {});
+        if (snapshot.providerConfig) {
+            const currentProvider = objectRecordOr(providersRoot[DEFAULT_PROVIDER_ID], {});
+            const nextProvider = JSON.stringify(snapshot.providerConfig);
+            if (JSON.stringify(currentProvider) !== nextProvider) {
+                providersRoot[DEFAULT_PROVIDER_ID] = snapshot.providerConfig;
+                fileChanged = true;
+            }
+        }
+        else if (DEFAULT_PROVIDER_ID in providersRoot) {
+            delete providersRoot[DEFAULT_PROVIDER_ID];
+            fileChanged = true;
+        }
+        if (isEmptyObject(providersRoot)) {
+            if ("providers" in doc)
+                fileChanged = true;
+            delete doc.providers;
+        }
+        else {
+            doc.providers = providersRoot;
+        }
+        if (!fileChanged) {
+            // Preserve the file exactly if nothing changed.
+        }
+        else if (!snapshot.modelsExisted && isEmptyObject(doc)) {
+            changed = (await removeFileIfExists(GSD_MODELS_PATH)) || changed;
+        }
+        else {
+            await writeJsonFile(GSD_MODELS_PATH, doc);
+            changed = true;
+        }
+    }
+    const authRaw = await readFileIfExists(GSD_AUTH_PATH);
+    if (authRaw !== null) {
+        let fileChanged = false;
+        let doc = objectRecordOr({}, {});
+        try {
+            doc = authRaw.trim() ? objectRecordOr(JSON.parse(authRaw), {}) : {};
+        }
+        catch {
+            doc = {};
+        }
+        if (snapshot.authEntry) {
+            const currentEntry = normalizeGsdCredential(doc[DEFAULT_PROVIDER_ID]);
+            const nextEntry = JSON.stringify(snapshot.authEntry);
+            if (JSON.stringify(currentEntry) !== nextEntry) {
+                doc[DEFAULT_PROVIDER_ID] = snapshot.authEntry;
+                fileChanged = true;
+            }
+        }
+        else if (DEFAULT_PROVIDER_ID in doc) {
+            delete doc[DEFAULT_PROVIDER_ID];
+            fileChanged = true;
+        }
+        if (!fileChanged) {
+            // Preserve the file exactly if nothing changed.
+        }
+        else if (!snapshot.authExisted && isEmptyObject(doc)) {
+            changed = (await removeFileIfExists(GSD_AUTH_PATH)) || changed;
+        }
+        else {
+            await writeJsonFile(GSD_AUTH_PATH, doc, 0o600);
+            changed = true;
+        }
+    }
+    const settingsRaw = await readFileIfExists(GSD_SETTINGS_PATH);
+    if (settingsRaw !== null) {
+        let fileChanged = false;
+        let doc = objectRecordOr({}, {});
+        try {
+            doc = settingsRaw.trim() ? objectRecordOr(JSON.parse(settingsRaw), {}) : {};
+        }
+        catch {
+            doc = {};
+        }
+        if (doc.defaultProvider === DEFAULT_PROVIDER_ID) {
+            if (snapshot.defaultProvider === null) {
+                if ("defaultProvider" in doc) {
+                    delete doc.defaultProvider;
+                    fileChanged = true;
+                }
+            }
+            else if (doc.defaultProvider !== snapshot.defaultProvider) {
+                doc.defaultProvider = snapshot.defaultProvider;
+                fileChanged = true;
+            }
+            if (snapshot.defaultModel === null) {
+                if ("defaultModel" in doc) {
+                    delete doc.defaultModel;
+                    fileChanged = true;
+                }
+            }
+            else if (doc.defaultModel !== snapshot.defaultModel) {
+                doc.defaultModel = snapshot.defaultModel;
+                fileChanged = true;
+            }
+        }
+        if (!fileChanged) {
+            // Preserve the file exactly if nothing changed.
+        }
+        else if (!snapshot.settingsExisted && isEmptyObject(doc)) {
+            changed = (await removeFileIfExists(GSD_SETTINGS_PATH)) || changed;
+        }
+        else {
+            await writeJsonFile(GSD_SETTINGS_PATH, doc);
+            changed = true;
+        }
+    }
+    await removeFileIfExists(GSD_RESTORE_STATE_PATH);
+    return changed;
+}
 async function cleanupRooConfig() {
     const snapshotRaw = await readFileIfExists(ROO_SETTINGS_STATE_PATH);
     let changed = false;
@@ -773,6 +940,7 @@ class LogoutCommand extends base_command_1.BaseCommand {
             let updatedCodexConfig = false;
             let updatedContinueConfig = false;
             let updatedClineConfig = false;
+            let updatedGsdConfig = false;
             let updatedOpenClawConfig = false;
             let updatedOpenCodeConfig = false;
             let updatedKiloConfig = false;
@@ -840,6 +1008,8 @@ class LogoutCommand extends base_command_1.BaseCommand {
                 updatedContinueConfig = await cleanupContinueConfig();
                 progress.update("Reverting Cline");
                 updatedClineConfig = await cleanupClineConfig();
+                progress.update("Reverting GSD");
+                updatedGsdConfig = await cleanupGsdConfig();
                 progress.update("Reverting OpenClaw");
                 updatedOpenClawConfig = await cleanupOpenClawConfig();
                 progress.update("Reverting OpenCode");
@@ -881,6 +1051,8 @@ class LogoutCommand extends base_command_1.BaseCommand {
                 revertedTargets.push("Continue");
             if (updatedClineConfig)
                 revertedTargets.push("Cline");
+            if (updatedGsdConfig)
+                revertedTargets.push("GSD");
             if (updatedOpenClawConfig)
                 revertedTargets.push("OpenClaw");
             if (updatedOpenCodeConfig)
@@ -981,6 +1153,7 @@ class LogoutCommand extends base_command_1.BaseCommand {
             }
             this.log(`- Continue config cleaned: ${updatedContinueConfig ? "yes" : "no"}`);
             this.log(`- Cline config cleaned: ${updatedClineConfig ? "yes" : "no"}`);
+            this.log(`- GSD config cleaned: ${updatedGsdConfig ? "yes" : "no"}`);
             this.log(`- OpenClaw config cleaned: ${updatedOpenClawConfig ? "yes" : "no"}`);
             this.log(`- OpenCode config cleaned: ${updatedOpenCodeConfig ? "yes" : "no"}`);
             this.log(`- Kilo config cleaned: ${updatedKiloConfig ? "yes" : "no"}`);

package/dist/commands/setup.js

@@ -41,12 +41,18 @@ const PREFERRED_MODELS = [...SUPPORTED_MODEL_IDS];
 const ENV_KEY_NAME = "THECLAWBAY_API_KEY";
 const CLAUDE_ENV_API_KEY_NAME = "ANTHROPIC_API_KEY";
 const CLAUDE_ENV_BASE_URL_NAME = "ANTHROPIC_BASE_URL";
+const CLAUDE_ENV_SIMPLE_MODE_NAME = "CLAUDE_CODE_SIMPLE";
 const ENV_FILE = node_path_1.default.join(paths_1.theclawbayConfigDir, "env");
 const CONTINUE_CONFIG_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".continue", "config.yaml");
 const CLINE_GLOBAL_STATE_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".cline", "data", "globalState.json");
 const CLINE_SECRETS_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".cline", "data", "secrets.json");
 const AIDER_CONFIG_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".aider.conf.yml");
+const GSD_AGENT_DIR = node_path_1.default.join(node_os_1.default.homedir(), ".gsd", "agent");
+const GSD_MODELS_PATH = node_path_1.default.join(GSD_AGENT_DIR, "models.json");
+const GSD_AUTH_PATH = node_path_1.default.join(GSD_AGENT_DIR, "auth.json");
+const GSD_SETTINGS_PATH = node_path_1.default.join(GSD_AGENT_DIR, "settings.json");
 const CLINE_RESTORE_STATE_PATH = node_path_1.default.join(paths_1.theclawbayStateDir, "cline.restore.json");
+const GSD_RESTORE_STATE_PATH = node_path_1.default.join(paths_1.theclawbayStateDir, "gsd.restore.json");
 const OPENCODE_RESTORE_STATE_PATH = node_path_1.default.join(paths_1.theclawbayStateDir, "opencode.restore.json");
 const KILO_RESTORE_STATE_PATH = node_path_1.default.join(paths_1.theclawbayStateDir, "kilo.restore.json");
 const ROO_SETTINGS_STATE_PATH = node_path_1.default.join(paths_1.theclawbayStateDir, "roo-settings.restore.json");
@@ -61,7 +67,7 @@ const SHELL_END = "# theclawbay-shell-managed:end";
 const OPENCLAW_PROVIDER_ID = DEFAULT_PROVIDER_ID;
 const HISTORY_PROVIDER_NEUTRALIZE_SOURCES = new Set(["openai", "theclawbay-wan", DEFAULT_PROVIDER_ID]);
 const HISTORY_PROVIDER_DB_MIGRATE_SOURCES = ["openai", "theclawbay-wan"];
-const SETUP_CLIENT_IDS = ["codex", "claude", "continue", "cline", "openclaw", "opencode", "kilo", "roo", "trae", "aider", "zo"];
+const SETUP_CLIENT_IDS = ["codex", "claude", "continue", "cline", "gsd", "openclaw", "opencode", "kilo", "roo", "trae", "aider", "zo"];
 const LEGACY_THECLAWBAY_OPENAI_PROXY_SUFFIX = "/api/codex-auth/v1/proxy/v1";
 const CANONICAL_THECLAWBAY_OPENAI_PROXY_SUFFIX = "/v1";
 const CANONICAL_CODEX_NATIVE_PROXY_SUFFIX = "/backend-api/codex";
@@ -161,7 +167,7 @@ function logSetupCompactSummary(params) {
         .filter((client) => params.selectedSetupClients.has(client.id))
         .map((client) => client.summaryLabel);
     const restartTargets = params.setupClients
-        .filter((client) => params.selectedSetupClients.has(client.id) && ["continue", "cline", "roo", "trae", "zo"].includes(client.id))
+        .filter((client) => params.selectedSetupClients.has(client.id) && ["continue", "cline", "gsd", "roo", "trae", "zo"].includes(client.id))
         .map((client) => client.summaryLabel);
     if (configured.length > 0) {
         params.log(`Configured: ${formatSummaryList(configured)}`);
@@ -1119,6 +1125,21 @@ async function detectCodexClient() {
     }
     return false;
 }
+async function detectGsdClient() {
+    if (hasCommand("gsd"))
+        return true;
+    const candidates = [
+        GSD_AGENT_DIR,
+        GSD_MODELS_PATH,
+        GSD_AUTH_PATH,
+        GSD_SETTINGS_PATH,
+    ];
+    for (const candidate of candidates) {
+        if (await pathExists(candidate))
+            return true;
+    }
+    return false;
+}
 async function detectContinueClient() {
     if (hasCommand("cn") || hasCommand("continue"))
         return true;
@@ -1371,6 +1392,100 @@ async function writeClineConfig(params) {
     await writeJsonObjectFile(CLINE_SECRETS_PATH, secrets, 0o600);
     return [CLINE_GLOBAL_STATE_PATH, CLINE_SECRETS_PATH];
 }
+function buildGsdModels(models) {
+    const supportedModelMap = new Map((0, supported_models_1.getSupportedModels)().map((model) => [model.id, model]));
+    return models
+        .filter((model) => Boolean(model.id))
+        .map((model) => {
+        const pricing = supportedModelMap.get(model.id);
+        return {
+            id: model.id,
+            name: model.name || model.id,
+            reasoning: true,
+            input: ["text", "image"],
+            cost: {
+                input: pricing?.inputPer1M ?? 0,
+                output: pricing?.outputPer1M ?? 0,
+                cacheRead: pricing?.cachedInputPer1M ?? 0,
+                cacheWrite: pricing?.inputPer1M ?? 0,
+            },
+            contextWindow: modelContextLimit(model.id),
+            maxTokens: modelOutputLimit(model.id),
+        };
+    });
+}
+function normalizeGsdCredential(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return null;
+    return { ...value };
+}
+async function writeGsdConfig(params) {
+    const existingModelsRaw = await readFileIfExists(GSD_MODELS_PATH);
+    const existingAuthRaw = await readFileIfExists(GSD_AUTH_PATH);
+    const existingSettingsRaw = await readFileIfExists(GSD_SETTINGS_PATH);
+    const existingSnapshotRaw = await readFileIfExists(GSD_RESTORE_STATE_PATH);
+    let modelsDoc = {};
+    if (existingModelsRaw?.trim()) {
+        try {
+            modelsDoc = objectRecordOr(JSON.parse(existingModelsRaw), {});
+        }
+        catch {
+            throw new Error(`invalid JSON in GSD config: ${GSD_MODELS_PATH}`);
+        }
+    }
+    let authDoc = {};
+    if (existingAuthRaw?.trim()) {
+        try {
+            authDoc = objectRecordOr(JSON.parse(existingAuthRaw), {});
+        }
+        catch {
+            throw new Error(`invalid JSON in GSD auth: ${GSD_AUTH_PATH}`);
+        }
+    }
+    let settingsDoc = {};
+    if (existingSettingsRaw?.trim()) {
+        try {
+            settingsDoc = objectRecordOr(JSON.parse(existingSettingsRaw), {});
+        }
+        catch {
+            throw new Error(`invalid JSON in GSD settings: ${GSD_SETTINGS_PATH}`);
+        }
+    }
+    if (!existingSnapshotRaw?.trim()) {
+        const providersRoot = objectRecordOr(modelsDoc.providers, {});
+        const snapshot = {
+            version: 1,
+            modelsExisted: existingModelsRaw !== null,
+            providerConfig: objectRecordOr(providersRoot[DEFAULT_PROVIDER_ID], {}),
+            authExisted: existingAuthRaw !== null,
+            authEntry: normalizeGsdCredential(authDoc[DEFAULT_PROVIDER_ID]),
+            settingsExisted: existingSettingsRaw !== null,
+            defaultProvider: typeof settingsDoc.defaultProvider === "string" ? settingsDoc.defaultProvider : null,
+            defaultModel: typeof settingsDoc.defaultModel === "string" ? settingsDoc.defaultModel : null,
+        };
+        if (Object.keys(snapshot.providerConfig ?? {}).length === 0)
+            snapshot.providerConfig = null;
+        await writeJsonObjectFile(GSD_RESTORE_STATE_PATH, snapshot, 0o600);
+    }
+    const providersRoot = objectRecordOr(modelsDoc.providers, {});
+    providersRoot[DEFAULT_PROVIDER_ID] = {
+        baseUrl: openAiCompatibleProxyUrl(params.backendUrl),
+        apiKey: ENV_KEY_NAME,
+        api: "openai-responses",
+        models: buildGsdModels(params.models),
+    };
+    modelsDoc.providers = providersRoot;
+    authDoc[DEFAULT_PROVIDER_ID] = {
+        type: "api_key",
+        key: params.apiKey,
+    };
+    settingsDoc.defaultProvider = DEFAULT_PROVIDER_ID;
+    settingsDoc.defaultModel = params.model.trim() || DEFAULT_CODEX_MODEL;
+    await writeJsonObjectFile(GSD_MODELS_PATH, modelsDoc);
+    await writeJsonObjectFile(GSD_AUTH_PATH, authDoc, 0o600);
+    await writeJsonObjectFile(GSD_SETTINGS_PATH, settingsDoc);
+    return [GSD_MODELS_PATH, GSD_AUTH_PATH, GSD_SETTINGS_PATH];
+}
 async function writeRooConfig(params) {
     const hosts = await detectExtensionHosts(["rooveterinaryinc.roo-cline-"]);
     if (hosts.length === 0) {
@@ -1448,7 +1563,7 @@ async function persistApiKeyEnv(params) {
         `export ${ENV_KEY_NAME}=${shellQuote(params.apiKey)}`,
     ];
     if (params.claudeEnabled) {
-        envLines.push("", "# Official Claude Code CLI", `export ${CLAUDE_ENV_API_KEY_NAME}=${shellQuote(params.apiKey)}`, `export ${CLAUDE_ENV_BASE_URL_NAME}=${shellQuote(anthropicCompatibleProxyUrl(params.backendUrl))}`);
+        envLines.push("", "# Official Claude Code CLI", `export ${CLAUDE_ENV_API_KEY_NAME}=${shellQuote(params.apiKey)}`, `export ${CLAUDE_ENV_BASE_URL_NAME}=${shellQuote(anthropicCompatibleProxyUrl(params.backendUrl))}`, `export ${CLAUDE_ENV_SIMPLE_MODE_NAME}=1`);
     }
     const envContents = `${envLines.join("\n")}\n`;
     await promises_1.default.writeFile(ENV_FILE, envContents, "utf8");
@@ -1483,10 +1598,12 @@ async function persistApiKeyEnv(params) {
     if (params.claudeEnabled) {
         process.env[CLAUDE_ENV_API_KEY_NAME] = params.apiKey;
         process.env[CLAUDE_ENV_BASE_URL_NAME] = anthropicCompatibleProxyUrl(params.backendUrl);
+        process.env[CLAUDE_ENV_SIMPLE_MODE_NAME] = "1";
     }
     else {
         delete process.env[CLAUDE_ENV_API_KEY_NAME];
         delete process.env[CLAUDE_ENV_BASE_URL_NAME];
+        delete process.env[CLAUDE_ENV_SIMPLE_MODE_NAME];
     }
     return updated;
 }
@@ -1498,7 +1615,7 @@ async function persistFishEnv(params) {
         `set -gx ${ENV_KEY_NAME} ${shellQuote(params.apiKey)}`,
     ];
     if (params.claudeEnabled) {
-        lines.push("", "# Official Claude Code CLI", `set -gx ${CLAUDE_ENV_API_KEY_NAME} ${shellQuote(params.apiKey)}`, `set -gx ${CLAUDE_ENV_BASE_URL_NAME} ${shellQuote(anthropicCompatibleProxyUrl(params.backendUrl))}`);
+        lines.push("", "# Official Claude Code CLI", `set -gx ${CLAUDE_ENV_API_KEY_NAME} ${shellQuote(params.apiKey)}`, `set -gx ${CLAUDE_ENV_BASE_URL_NAME} ${shellQuote(anthropicCompatibleProxyUrl(params.backendUrl))}`, `set -gx ${CLAUDE_ENV_SIMPLE_MODE_NAME} 1`);
     }
     await promises_1.default.writeFile(fishConfPath, `${lines.join("\n")}\n`, "utf8");
     return [fishConfPath];
@@ -1523,7 +1640,7 @@ async function persistPowerShellEnv(params) {
             `$env:${ENV_KEY_NAME} = ${powerShellQuote(params.apiKey)}`,
         ];
         if (params.claudeEnabled) {
-            lines.push(`$env:${CLAUDE_ENV_API_KEY_NAME} = ${powerShellQuote(params.apiKey)}`, `$env:${CLAUDE_ENV_BASE_URL_NAME} = ${powerShellQuote(anthropicCompatibleProxyUrl(params.backendUrl))}`);
+            lines.push(`$env:${CLAUDE_ENV_API_KEY_NAME} = ${powerShellQuote(params.apiKey)}`, `$env:${CLAUDE_ENV_BASE_URL_NAME} = ${powerShellQuote(anthropicCompatibleProxyUrl(params.backendUrl))}`, `$env:${CLAUDE_ENV_SIMPLE_MODE_NAME} = "1"`);
         }
         lines.push(SHELL_END);
         const next = appendManagedBlock(cleaned, lines);
@@ -2012,11 +2129,12 @@ class SetupCommand extends base_command_1.BaseCommand {
                 managed?.backendUrl ??
                 DEFAULT_BACKEND_URL;
             const backendUrl = normalizeUrl(backendRaw, "--backend");
-            const [codexDetected, claudeDetected, continueDetected, clineDetected, kiloDetected, rooDetected, traeDetected, aiderDetected, zoDetected] = await Promise.all([
+            const [codexDetected, claudeDetected, continueDetected, clineDetected, gsdDetected, kiloDetected, rooDetected, traeDetected, aiderDetected, zoDetected] = await Promise.all([
                 detectCodexClient(),
                 detectClaudeCodeClient(),
                 detectContinueClient(),
                 detectClineClient(),
+                detectGsdClient(),
                 detectKiloClient(),
                 detectRooClient(),
                 detectTraeClient(),
@@ -2060,6 +2178,15 @@ class SetupCommand extends base_command_1.BaseCommand {
                     icon: "◈",
                     siteUrl: "https://cline.bot",
                 },
+                {
+                    id: "gsd",
+                    label: "Get Shit Done 2",
+                    summaryLabel: "GSD",
+                    detected: gsdDetected,
+                    recommended: true,
+                    icon: "▣",
+                    siteUrl: "https://github.com/gsd-build/gsd-2",
+                },
                 {
                     id: "openclaw",
                     label: "OpenClaw",
@@ -2179,6 +2306,7 @@ class SetupCommand extends base_command_1.BaseCommand {
             let modelCacheMigration = null;
             let continueConfigPath = null;
             let clineConfigPaths = [];
+            let gsdConfigPaths = [];
             let openClawConfigPath = null;
             let openClawCliWarning = null;
             let openCodeConfigPaths = [];
@@ -2274,6 +2402,15 @@ class SetupCommand extends base_command_1.BaseCommand {
                         apiKey: authCredential,
                     });
                 }
+                if (selectedSetupClients.has("gsd")) {
+                    progress.update("Configuring GSD");
+                    gsdConfigPaths = await writeGsdConfig({
+                        backendUrl,
+                        model: resolved?.model ?? DEFAULT_CODEX_MODEL,
+                        models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
+                        apiKey: authCredential,
+                    });
+                }
                 if (selectedSetupClients.has("openclaw")) {
                     progress.update("Configuring OpenClaw");
                     const openClawResult = await setupOpenClaw({
@@ -2351,8 +2488,8 @@ class SetupCommand extends base_command_1.BaseCommand {
             if (resolved?.note)
                 summaryNotes.add(resolved.note);
             if (claudeAccess?.enabled) {
-                summaryNotes.add("Claude Code: exported ANTHROPIC_BASE_URL and ANTHROPIC_API_KEY for the official client.");
-                summaryNotes.add("Claude Code may still show your claude.ai login in `claude auth status`. Restart Claude Code and approve `Use custom API key` if prompted, or enable it in `/config`.");
+                summaryNotes.add("Claude Code: exported ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY, and CLAUDE_CODE_SIMPLE=1 for the official client.");
+                summaryNotes.add("If Claude Code is already open, restart it so the custom-key env takes effect cleanly. `claude auth status` should show `authMethod: api_key` once the new env is loaded.");
             }
             else if (claudeAccess?.note) {
                 summaryNotes.add(claudeAccess.note);
@@ -2496,6 +2633,16 @@ class SetupCommand extends base_command_1.BaseCommand {
             else {
                 this.log("- Cline: not detected (skipped)");
             }
+            if (selectedSetupClients.has("gsd")) {
+                this.log(`- GSD: configured (${gsdConfigPaths.join(", ")})`);
+                this.log("- GSD note: configured with the OpenAI Responses API so tool calling works reliably.");
+            }
+            else if (gsdDetected) {
+                this.log("- GSD: detected but skipped");
+            }
+            else {
+                this.log("- GSD: not detected (skipped)");
+            }
             const openClawDetected = setupClients.find((client) => client.id === "openclaw")?.detected ?? false;
             if (selectedSetupClients.has("openclaw")) {
                 this.log(`- OpenClaw: configured (${openClawConfigPath})`);
@@ -2621,7 +2768,7 @@ class SetupCommand extends base_command_1.BaseCommand {
         });
     }
 }
-SetupCommand.description = "One-time setup: configure Codex, Claude Code, plus any detected Continue, Cline, OpenClaw, OpenCode, Kilo, Roo Code, Trae, Aider, or Zo installs to use The Claw Bay";
+SetupCommand.description = "One-time setup: configure Codex, Claude Code, plus any detected Continue, Cline, GSD, OpenClaw, OpenCode, Kilo, Roo Code, Trae, Aider, or Zo installs to use The Claw Bay";
 SetupCommand.flags = {
     backend: core_1.Flags.string({
         required: false,
@@ -2639,7 +2786,7 @@ SetupCommand.flags = {
     }),
     clients: core_1.Flags.string({
         required: false,
-        description: "Detected local clients to configure: codex, claude, continue, cline, openclaw, opencode, kilo, roo, trae, aider, zo",
+        description: "Detected local clients to configure: codex, claude, continue, cline, gsd, openclaw, opencode, kilo, roo, trae, aider, zo",
     }),
     yes: core_1.Flags.boolean({
         required: false,

package/dist/lib/device-session-auth.js

@@ -5,11 +5,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBrowserLinkedDeviceSession = createBrowserLinkedDeviceSession;
 const node_crypto_1 = __importDefault(require("node:crypto"));
+const promises_1 = __importDefault(require("node:fs/promises"));
 const node_http_1 = __importDefault(require("node:http"));
 const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
 const node_child_process_1 = require("node:child_process");
+const paths_1 = require("./config/paths");
 const BROWSER_SETUP_TIMEOUT_MS = 15 * 60000;
 const BROWSER_SETUP_POLL_INTERVAL_MS = 2000;
+const INSTALL_ID_PATH = node_path_1.default.join(paths_1.theclawbayConfigDir, "install-id");
 function preferredBrowserCallbackPort() {
     const parsed = Number(process.env.THECLAWBAY_CALLBACK_PORT?.trim() || "");
     if (Number.isFinite(parsed) && parsed > 0 && parsed < 65536) {
@@ -46,6 +50,30 @@ function openUrlInBrowser(url) {
         return false;
     }
 }
+function normalizeInstallId(value) {
+    const normalized = value.trim();
+    if (normalized.length < 16 || normalized.length > 128)
+        return null;
+    return normalized;
+}
+async function getOrCreateInstallId() {
+    try {
+        const existing = normalizeInstallId(await promises_1.default.readFile(INSTALL_ID_PATH, "utf8"));
+        if (existing)
+            return existing;
+    }
+    catch (error) {
+        const err = error;
+        if (err.code !== "ENOENT") {
+            throw new Error(`failed to read local install identity: ${err.message}`);
+        }
+    }
+    const installId = node_crypto_1.default.randomUUID();
+    await promises_1.default.mkdir(node_path_1.default.dirname(INSTALL_ID_PATH), { recursive: true });
+    await promises_1.default.writeFile(INSTALL_ID_PATH, `${installId}\n`, "utf8");
+    await promises_1.default.chmod(INSTALL_ID_PATH, 0o600).catch(() => { });
+    return installId;
+}
 function htmlPage(title, message) {
     return `<!doctype html>
 <html lang="en">
@@ -239,6 +267,7 @@ async function createBrowserLinkedDeviceSession(params) {
     const exchangeSignal = exchangeAbortController.signal;
     let exchangeInFlight = null;
     try {
+        const installId = await getOrCreateInstallId();
         const startResponse = await fetch(`${params.backendUrl}/api/setup/device-session/start`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
@@ -246,6 +275,7 @@ async function createBrowserLinkedDeviceSession(params) {
                 callbackUrl: callbackServer.callbackUrl,
                 state,
                 deviceLabel: label,
+                installId,
                 selectedClients: params.selectedClients,
             }),
             signal: AbortSignal.timeout(20000),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "theclawbay",
-  "version": "0.3.52",
-  "description": "CLI for connecting Codex, Continue, Cline, OpenClaw, OpenCode, Kilo, Roo Code, Aider, experimental Trae, and experimental Zo to The Claw Bay.",
+  "version": "0.3.54",
+  "description": "CLI for connecting Codex, Continue, Cline, GSD, OpenClaw, OpenCode, Kilo, Roo Code, Aider, experimental Trae, and experimental Zo to The Claw Bay.",
   "license": "MIT",
   "bin": {
     "theclawbay": "dist/index.js"
@@ -35,6 +35,7 @@
     "api-key",
     "continue",
     "cline",
+    "gsd",
     "openclaw",
     "opencode",
     "kilo",