@gonkagate/claude-code-setup 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+## Unreleased
+
+- Made local alias package bootstrap publish without npm provenance because provenance requires a supported CI/OIDC provider.
+- Made alias package publishing skip cleanly until `@gonkagate/claude-code-setup` is bootstrapped on npm, with an explicit override for the first package publish.
+- Added `@gonkagate/claude-code-setup` as a setup-style alias for the existing Claude Code installer.
+- Improved npm package metadata and README copy for better package-page clarity, discovery, and onboarding.
+- Added a curated model registry and model picker to the public installer flow.
+- Added `--model <model-key>` and `--model=<model-key>` support for curated non-secret model selection.
+- Kept the public Claude Code contract tight by limiting model selection to the curated GonkaGate registry only.
+- Updated docs and tests for model selection while preserving local git ignore protection and owner-only settings file permissions.
+- Hardened local scope against symlinked `.claude` paths that could redirect secret writes outside the ignored settings path.
+- Extended local git protection to ignore timestamped backup files for `.claude/settings.local.json`.
+- Normalized backup permissions to owner-only mode so secret-bearing backups are not left world-readable.
+- Hardened local scope so `.claude/settings.local.json` cannot keep tracking secrets in git before local setup proceeds.
+- Replaced the tracked-local-settings hard stop with a recovery flow that can stop tracking the file or switch to user scope without rerunning setup.
+- Hardened local scope against symlinked path components anywhere between the repo root and the target settings file.
+- Pinned GitHub Actions workflows to immutable commit SHAs for release pipeline hardening.
+- Restored automated npm publish dispatch after Release Please creates a new release tag.
+- Made publish reruns skip versions that are already present on npm instead of failing with a duplicate-version error.
+
+## [0.2.0](https://github.com/GonkaGate/gonkagate-claude-code/compare/v0.1.3...v0.2.0) (2026-04-13)
+
+
+### Features
+
+* add Claude Code setup alias ([3d411f5](https://github.com/GonkaGate/gonkagate-claude-code/commit/3d411f5c0cbafd84d10cf8339e9d392bd8043a26))
+* add Claude Code setup alias ([caa0711](https://github.com/GonkaGate/gonkagate-claude-code/commit/caa07114025b305a36d9a3e92deb8e565d185b15))
+
+## [0.1.3](https://github.com/GonkaGate/gonkagate-claude-code/compare/v0.1.2...v0.1.3) (2026-03-31)
+
+
+### Bug Fixes
+
+* document release-please title requirements ([5fce744](https://github.com/GonkaGate/gonkagate-claude-code/commit/5fce7441dfd0c79d6f6ab43b4fa20737df879516))
+* document release-please title requirements ([145f9f7](https://github.com/GonkaGate/gonkagate-claude-code/commit/145f9f72da19cf31f8f73e8250047988ee1eb9bf))
+
+## [0.1.2](https://github.com/GonkaGate/gonkagate-claude-code/compare/v0.1.1...v0.1.2) (2026-03-31)
+
+
+### Bug Fixes
+
+* restore automated npm publishes ([42bde87](https://github.com/GonkaGate/gonkagate-claude-code/commit/42bde8795e264c8950017aa5acff0475b4fb0c8e))
+* restore automated npm publishes ([52fcd8e](https://github.com/GonkaGate/gonkagate-claude-code/commit/52fcd8e428ccae967871aba800344dd786a048ce))
+
+## [0.1.1](https://github.com/GonkaGate/gonkagate-claude-code/compare/v0.1.0...v0.1.1) (2026-03-31)
+
+
+### Bug Fixes
+
+* stop duplicate npm publishes ([1ac876a](https://github.com/GonkaGate/gonkagate-claude-code/commit/1ac876a4fb1c99bd1a1cc892e38ee2c7df3be799))
+* stop duplicate npm publishes ([58d022f](https://github.com/GonkaGate/gonkagate-claude-code/commit/58d022ff2486fa6156badc791cb236f580b68a9c))
+
+## 0.1.0
+
+- Initial public onboarding repo for connecting local Claude Code to GonkaGate.
+- Added interactive Node CLI installer with hidden API key prompt.
+- Added user and local Claude Code settings install scopes.
+- Added JSON merge, backup, and validation behavior for Claude Code settings.
+- Added public README plus troubleshooting, security, and how-it-works docs.

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,120 @@
+# @gonkagate/claude-code
+
+Set up Claude Code to use GonkaGate in one `npx` command.
+
+This CLI installer is for developers who already have local `Claude Code` and want to use it with GonkaGate, the gateway to Gonka Network, without editing shell profiles, exporting long env var blocks, or writing `.env` files by hand.
+
+Under the hood it configures Claude Code to use GonkaGate's Anthropic-compatible endpoint at `https://api.gonkagate.com`.
+
+It does not install `Claude Code` itself. It configures an existing local Claude Code install.
+
+## Quick Start
+
+```bash
+npx @gonkagate/claude-code
+```
+
+Setup-style alias for consistency with the other GonkaGate agent installers:
+
+```bash
+npx @gonkagate/claude-code-setup
+```
+
+## See It In Action
+
+From API key to a working Claude Code setup in one short walkthrough:
+
+[![See the installer in action](https://raw.githubusercontent.com/GonkaGate/gonkagate-claude-code/main/.github/assets/gonkagate-claude-code-demo.gif)](https://raw.githubusercontent.com/GonkaGate/gonkagate-claude-code/main/.github/assets/gonkagate-claude-code-demo.mp4)
+
+Need an API key first? [Create one on GonkaGate](https://gonkagate.com/en).
+
+You will be asked for:
+
+- your GonkaGate API key (`gp-...`) in a hidden interactive prompt
+- a model from the supported GonkaGate list
+- setup scope: `user` or `local`
+
+If you choose `local` scope and `.claude/settings.local.json` is already tracked by git, the installer offers to stop tracking that file and continue, or switch to `user` scope instead.
+
+You need:
+
+- local `Claude Code`
+- Node.js 18+
+- a GonkaGate API key
+
+## Supported Model
+
+Current public Claude Code model in the curated registry:
+
+- `qwen3-235b` -> `qwen/qwen3-235b-a22b-instruct-2507-fp8`
+
+## What It Does
+
+The tool writes Claude Code settings so you can keep running `claude` normally afterward.
+
+By default it writes to:
+
+- `~/.claude/settings.json`
+
+If you choose local scope, it writes to:
+
+- `.claude/settings.local.json`
+
+It also:
+
+- preserves unrelated Claude Code settings
+- creates a backup before overwriting an existing settings file
+- writes settings files with owner-only permissions
+- writes backup files with owner-only permissions
+- adds `.claude/settings.local.json` and local backup files to `.git/info/exclude` for local setup inside a git repo
+- offers to stop tracking `.claude/settings.local.json` before local setup writes secrets into a file that was already tracked by git
+- refuses local setup if the target path traverses a symlinked path component, or if `.claude` / the local settings file is a symlink
+
+## Fixed GonkaGate Setup
+
+These parts are intentionally fixed:
+
+- Base URL: `https://api.gonkagate.com`
+- Auth variable: `ANTHROPIC_AUTH_TOKEN`
+- Model choice: only from the curated supported list
+
+This tool does not ask for a custom base URL and does not accept arbitrary custom model IDs.
+
+The selected model is written into all Claude Code model env vars used by this setup flow.
+
+## Verify
+
+After setup:
+
+1. If Claude Code was previously logged directly into Anthropic, run `claude auth logout`
+2. Start Claude Code normally with `claude`
+3. Run `/status`
+4. Confirm the active gateway is `https://api.gonkagate.com`
+
+## What This Tool Does Not Do
+
+- It does not configure `claude.ai`
+- It does not install `Claude Code` itself
+- It does not edit `.zshrc`, `.bashrc`, PowerShell profiles, or other shell startup files
+- It does not write `.env` files
+- It does not support arbitrary custom model IDs
+- It does not support custom base URL overrides
+
+## Need Help?
+
+- Troubleshooting: [docs/troubleshooting.md](https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/troubleshooting.md)
+- Security notes: [docs/security.md](https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/security.md)
+- Internal behavior: [docs/how-it-works.md](https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/how-it-works.md)
+
+## Development
+
+```bash
+npm install
+npm run dev
+```
+
+Useful commands:
+
+- `npm run build`
+- `npm test`
+- `npm run ci`

package/bin/gonkagate-claude-code.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+import { CommanderError } from "commander";
+import { run } from "../dist/cli.js";
+
+run().catch((error) => {
+  if (error instanceof CommanderError) {
+    process.exitCode = error.exitCode;
+    return;
+  }
+
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`\nError: ${message}`);
+  process.exitCode = 1;
+});

package/dist/cli.d.ts

@@ -0,0 +1,17 @@
+import type { InstallScope, SettingsTarget } from "./types/settings.js";
+import type { SupportedModelKey } from "./constants/models.js";
+import type { TrackedLocalSettingsAction } from "./install/prompts.js";
+interface CliOptions {
+    help: boolean;
+    version: boolean;
+    scope?: InstallScope;
+    modelKey?: SupportedModelKey;
+}
+interface ProgramOutput {
+    writeOut?: (str: string) => void;
+    writeErr?: (str: string) => void;
+}
+export declare function parseCliOptions(argv: string[], output?: ProgramOutput, commandName?: string): CliOptions;
+export declare function resolveSettingsTarget(scope: InstallScope, cwd: string, chooseTrackedLocalSettingsAction?: (relativeTargetPath: string) => Promise<TrackedLocalSettingsAction>): Promise<SettingsTarget>;
+export declare function run(argv?: string[], commandName?: string): Promise<void>;
+export {};

package/dist/cli.js

@@ -0,0 +1,143 @@
+import process from "node:process";
+import { basename } from "node:path";
+import { pathToFileURL } from "node:url";
+import { Command, CommanderError, Option } from "commander";
+import { DEFAULT_MODEL_KEY, SUPPORTED_MODELS, SUPPORTED_MODEL_KEYS, requireSupportedModel } from "./constants/models.js";
+import { createBackup } from "./install/backup.js";
+import { loadSettings } from "./install/load-settings.js";
+import { ensureLocalSettingsIgnored, stopTrackingLocalSettings, TrackedLocalSettingsError } from "./install/local-git-ignore.js";
+import { mergeSettingsWithGonkaEnv } from "./install/merge-env.js";
+import { promptForApiKey, promptForModel, promptForScope, promptForTrackedLocalSettingsAction } from "./install/prompts.js";
+import { getSettingsTarget } from "./install/settings-paths.js";
+import { validateApiKey } from "./install/validate-api-key.js";
+import { writeSettings } from "./install/write-settings.js";
+const DEFAULT_COMMAND_NAME = "gonkagate-claude-code";
+function rejectApiKeyArgs(argv) {
+    if (argv.some((arg) => arg === "--api-key" || arg.startsWith("--api-key="))) {
+        throw new Error("Passing API keys via CLI arguments is intentionally unsupported. Run the installer interactively instead.");
+    }
+}
+function createProgram(output, commandName = DEFAULT_COMMAND_NAME) {
+    const supportedModelLines = SUPPORTED_MODELS.map((model) => {
+        const defaultSuffix = model.key === DEFAULT_MODEL_KEY ? " (default)" : "";
+        return `  ${model.key}  ${model.displayName}${defaultSuffix}`;
+    }).join("\n");
+    const program = new Command()
+        .name(commandName)
+        .description("GonkaGate Claude Code installer")
+        .addOption(new Option("--model <model-key>", "Skip the model prompt with a curated supported model.").choices(SUPPORTED_MODEL_KEYS))
+        .addOption(new Option("--scope <scope>", "Skip the scope prompt. Choose user or local.").choices(["user", "local"]))
+        .helpOption("-h, --help", "Show this help.")
+        .version("0.1.0", "-v, --version", "Show the package version.")
+        .addHelpText("after", `
+Examples:
+  npx @gonkagate/claude-code
+  npx @gonkagate/claude-code-setup
+  npx @gonkagate/claude-code --model ${DEFAULT_MODEL_KEY}
+  npx @gonkagate/claude-code --scope local
+
+Supported model keys:
+${supportedModelLines}
+`)
+        .exitOverride();
+    if (output) {
+        program.configureOutput(output);
+    }
+    return program;
+}
+export function parseCliOptions(argv, output, commandName = DEFAULT_COMMAND_NAME) {
+    rejectApiKeyArgs(argv);
+    const program = createProgram(output, commandName);
+    program.parse(["node", commandName, ...argv]);
+    const options = program.opts();
+    return {
+        help: false,
+        version: false,
+        scope: options.scope,
+        modelKey: options.model
+    };
+}
+function getCommandNameFromArgv() {
+    const commandName = process.argv[1] === undefined
+        ? DEFAULT_COMMAND_NAME
+        : basename(process.argv[1]).replace(/\.(?:js|ts)$/, "");
+    return commandName === "cli" ? DEFAULT_COMMAND_NAME : commandName;
+}
+function printIntro() {
+    console.log("Connect Claude Code to GonkaGate in one step.\n");
+    console.log("This installer writes Claude Code settings for GonkaGate's public gateway.");
+    console.log("Base URL is fixed to https://api.gonkagate.com and is not configurable.");
+    console.log(`Model choice is limited to the curated GonkaGate-supported list: ${SUPPORTED_MODEL_KEYS.join(", ")}.\n`);
+}
+function printSuccess(targetPath, scope, selectedModel, backupPath) {
+    console.log("\nInstall complete.\n");
+    console.log(`Updated: ${targetPath}`);
+    console.log(`Model: ${selectedModel.displayName} (${selectedModel.modelId})`);
+    if (backupPath) {
+        console.log(`Backup: ${backupPath}`);
+    }
+    console.log("\nNext steps:");
+    console.log("1. If Claude Code still shows direct Anthropic auth, run: claude auth logout");
+    console.log("2. Start Claude Code normally: claude");
+    console.log("3. In Claude Code, run: /status");
+    console.log("4. Confirm the active gateway is https://api.gonkagate.com");
+    if (scope === "local") {
+        console.log("\nLocal scope reminder:");
+        console.log("Keep .claude/settings.local.json uncommitted.");
+    }
+}
+export async function resolveSettingsTarget(scope, cwd, chooseTrackedLocalSettingsAction = promptForTrackedLocalSettingsAction) {
+    const target = getSettingsTarget(scope, cwd);
+    if (scope !== "local") {
+        return target;
+    }
+    try {
+        await ensureLocalSettingsIgnored(target.path);
+        return target;
+    }
+    catch (error) {
+        if (!(error instanceof TrackedLocalSettingsError)) {
+            throw error;
+        }
+        const action = await chooseTrackedLocalSettingsAction(error.relativeTargetPath);
+        if (action === "user") {
+            console.log("\nSwitching to user scope so the repository stays unchanged.");
+            return getSettingsTarget("user", cwd);
+        }
+        if (action === "cancel") {
+            throw new Error("Installation cancelled.");
+        }
+        await stopTrackingLocalSettings(target.path);
+        console.log(`\nStopped tracking ${error.relativeTargetPath} in git and added a local exclude.`);
+        return target;
+    }
+}
+export async function run(argv = process.argv.slice(2), commandName = getCommandNameFromArgv()) {
+    const options = parseCliOptions(argv, undefined, commandName);
+    printIntro();
+    const apiKey = validateApiKey(await promptForApiKey());
+    const selectedModel = options.modelKey
+        ? requireSupportedModel(options.modelKey)
+        : await promptForModel(SUPPORTED_MODELS, DEFAULT_MODEL_KEY);
+    const requestedScope = options.scope ?? (await promptForScope("user"));
+    const target = await resolveSettingsTarget(requestedScope, process.cwd());
+    const loaded = await loadSettings(target.path);
+    const mergedSettings = mergeSettingsWithGonkaEnv(loaded.settings, apiKey, selectedModel);
+    const backupPath = loaded.exists ? await createBackup(target.path) : undefined;
+    await writeSettings(target.path, mergedSettings);
+    printSuccess(target.path, target.scope, selectedModel, backupPath);
+}
+function handleCliError(error) {
+    if (error instanceof CommanderError) {
+        process.exitCode = error.exitCode;
+        return;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\nError: ${message}`);
+    process.exitCode = 1;
+}
+const isEntrypoint = process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isEntrypoint) {
+    run().catch(handleCliError);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/constants/gateway.d.ts

@@ -0,0 +1,2 @@
+export declare const GONKAGATE_BASE_URL = "https://api.gonkagate.com";
+export declare const CLAUDE_SETTINGS_SCHEMA_URL = "https://json.schemastore.org/claude-code-settings.json";

package/dist/constants/gateway.js

@@ -0,0 +1,3 @@
+export const GONKAGATE_BASE_URL = "https://api.gonkagate.com";
+export const CLAUDE_SETTINGS_SCHEMA_URL = "https://json.schemastore.org/claude-code-settings.json";
+//# sourceMappingURL=gateway.js.map

package/dist/constants/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/constants/gateway.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAC9D,MAAM,CAAC,MAAM,0BAA0B,GAAG,wDAAwD,CAAC"}

package/dist/constants/models.d.ts

@@ -0,0 +1,27 @@
+export interface SupportedModelDefinition {
+    key: string;
+    displayName: string;
+    modelId: string;
+    description?: string;
+    isDefault?: boolean;
+}
+export declare const SUPPORTED_MODELS: readonly [{
+    readonly key: "qwen3-235b";
+    readonly displayName: "Qwen 3 235B Instruct";
+    readonly modelId: "qwen/qwen3-235b-a22b-instruct-2507-fp8";
+    readonly description: "Current GonkaGate public Claude Code model.";
+    readonly isDefault: true;
+}];
+export type SupportedModel = (typeof SUPPORTED_MODELS)[number];
+export type SupportedModelKey = SupportedModel["key"];
+export declare const DEFAULT_MODEL: {
+    readonly key: "qwen3-235b";
+    readonly displayName: "Qwen 3 235B Instruct";
+    readonly modelId: "qwen/qwen3-235b-a22b-instruct-2507-fp8";
+    readonly description: "Current GonkaGate public Claude Code model.";
+    readonly isDefault: true;
+};
+export declare const DEFAULT_MODEL_KEY: SupportedModelKey;
+export declare const SUPPORTED_MODEL_KEYS: "qwen3-235b"[];
+export declare function getSupportedModelByKey(key: string): SupportedModel | undefined;
+export declare function requireSupportedModel(key: string): SupportedModel;

package/dist/constants/models.js

@@ -0,0 +1,28 @@
+const curatedModelRegistry = [
+    {
+        key: "qwen3-235b",
+        displayName: "Qwen 3 235B Instruct",
+        modelId: "qwen/qwen3-235b-a22b-instruct-2507-fp8",
+        description: "Current GonkaGate public Claude Code model.",
+        isDefault: true
+    }
+];
+const defaultModels = curatedModelRegistry.filter((model) => model.isDefault);
+if (defaultModels.length !== 1) {
+    throw new Error(`Expected exactly one default supported model, found ${defaultModels.length}.`);
+}
+export const SUPPORTED_MODELS = curatedModelRegistry;
+export const DEFAULT_MODEL = defaultModels[0];
+export const DEFAULT_MODEL_KEY = DEFAULT_MODEL.key;
+export const SUPPORTED_MODEL_KEYS = SUPPORTED_MODELS.map((model) => model.key);
+export function getSupportedModelByKey(key) {
+    return SUPPORTED_MODELS.find((model) => model.key === key);
+}
+export function requireSupportedModel(key) {
+    const model = getSupportedModelByKey(key);
+    if (!model) {
+        throw new Error(`Unsupported model key "${key}". Supported model keys: ${SUPPORTED_MODEL_KEYS.join(", ")}`);
+    }
+    return model;
+}
+//# sourceMappingURL=models.js.map

package/dist/constants/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/constants/models.ts"],"names":[],"mappings":"AAQA,MAAM,oBAAoB,GAAG;IAC3B;QACE,GAAG,EAAE,YAAY;QACjB,WAAW,EAAE,sBAAsB;QACnC,OAAO,EAAE,wCAAwC;QACjD,WAAW,EAAE,6CAA6C;QAC1D,SAAS,EAAE,IAAI;KAChB;CACqD,CAAC;AAEzD,MAAM,aAAa,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAE9E,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC/B,MAAM,IAAI,KAAK,CAAC,uDAAuD,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAGrD,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAsB,aAAa,CAAC,GAAG,CAAC;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAE/E,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAE1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,4BAA4B,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9G,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/install/backup.d.ts

@@ -0,0 +1 @@
+export declare function createBackup(filePath: string): Promise<string>;