free-claude-code 6.2.70__tar.gz → 6.3.0__tar.gz

free_claude_code-6.3.0/.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,20 @@
+name: Problem after installation
+description: Report a problem using Free Claude Code after installing it.
+labels:
+  - bug
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the issue
+      description: Describe what happened, what you expected, and how to reproduce it. Include the provider, model, and harness you were using when relevant. Reports missing relevant details may be closed. You can attach screenshots here.
+    validations:
+      required: true
+  - type: textarea
+    id: doctor
+    attributes:
+      label: FCC doctor output
+      description: Run `fcc-doctor` and paste the JSON it copies to your clipboard. If copying is unavailable, copy the printed JSON from your terminal.
+      render: json
+    validations:
+      required: true

free_claude_code-6.3.0/.github/ISSUE_TEMPLATE/installation-problem.yml

@@ -0,0 +1,12 @@
+name: Installation problem
+description: Report a problem before FCC has been installed successfully.
+labels:
+  - bug
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Installation issue
+      description: Describe what happened and include the error you received. You can attach screenshots here if helpful.
+    validations:
+      required: true

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/.github/workflows/validate-bug-report-version.yml

@@ -31,11 +31,34 @@ jobs:
             const fieldPattern = "^### FCC version\\r?\\n+\\s*([^\\r\\n]+)";
             const releaseVersionPattern = "^v((?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*))$";
             const versionPattern = "(?:^|[^0-9A-Za-z_.])v?([0-9]+\\.[0-9]+\\.[0-9]+(?:\\.dev[0-9]+(?:\\+g[0-9a-f]+(?:\\.d[0-9]{8})?)?|\\+d[0-9]{8})?)(?![0-9A-Za-z_+-]|\\.[0-9A-Za-z_])";
-            const match = (issue.body || "").match(new RegExp(fieldPattern, "m"));
-            const fieldValue = match?.[1]?.trim() || "";
-            const versionMatches = [...fieldValue.matchAll(new RegExp(versionPattern, "g"))];
-            const reportedVersion = versionMatches.length === 1 ? versionMatches[0][1] : undefined;
-            const valid = reportedVersion !== undefined || fieldValue === "None";
+            const parseReport = (body) => {
+              const sections = body.split(/^### /m);
+              const doctor = sections.filter((section) => /^FCC doctor output\r?\n/.test(section));
+              if (doctor.length) {
+                if (doctor.length !== 1) return { valid: false };
+                let text = doctor[0].replace(/^FCC doctor output\r?\n/, "").trim();
+                const fence = text.match(/^```(?:json)?\r?\n([\s\S]*)\r?\n```$/);
+                if (fence) text = fence[1];
+                let report;
+                try { report = JSON.parse(text); }
+                catch { return { valid: false }; }
+                const version = report?.version;
+                if (version === "0+unknown") return { valid: true };
+                if (typeof version !== "string") return { valid: false };
+                const matches = [...version.matchAll(new RegExp(versionPattern, "g"))];
+                if (matches.length !== 1 || matches[0][0] !== version) return { valid: false };
+                return { valid: true, reportedVersion: matches[0][1] };
+              }
+              const match = body.match(new RegExp(fieldPattern, "m"));
+              if (!match && sections.some((section) => /^Installation issue\r?\n/.test(section))) {
+                return { valid: true };
+              }
+              const fieldValue = match?.[1]?.trim() || "";
+              const versionMatches = [...fieldValue.matchAll(new RegExp(versionPattern, "g"))];
+              const reportedVersion = versionMatches.length === 1 ? versionMatches[0][1] : undefined;
+              return { valid: reportedVersion !== undefined || fieldValue === "None", reportedVersion };
+            };
+            const { reportedVersion, valid } = parseReport(issue.body || "");
             const labelName = "needs-fcc-version";
             const invalidMarker = "<!-- fcc-version-validator -->";
             const outdatedMarker = "<!-- fcc-version-outdated -->";
@@ -82,7 +105,7 @@ jobs:
                       ...repo,
                       name: labelName,
                       color: "d4c5f9",
-                      description: "FCC version must contain one installed version or be None",
+                      description: "Bug report needs valid FCC version information",
                     });
                   } catch (createError) {
                     if (createError.status !== 422) throw createError;
@@ -98,7 +121,7 @@ jobs:
                 await github.rest.issues.createComment({
                   ...repo,
                   issue_number,
-                  body: `${invalidMarker}\nPlease edit **FCC version** so it contains one version copied from \`fcc-server --version\`, including any development suffix, or is exactly \`None\`.`,
+                  body: `${invalidMarker}\nPlease run \`fcc-doctor\` and paste its complete JSON into **FCC doctor output**. For an older issue with an **FCC version** field, enter one version from \`fcc-server --version\` or exactly \`None\`. If FCC has not installed successfully, use the Installation problem form.`,
                 });
               }
               return;

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: free-claude-code
-Version: 6.2.70
+Version: 6.3.0
 Summary: Local proxy connecting coding agents to OpenAI-compatible AI providers
 License-Expression: AGPL-3.0-only
 License-File: LICENSE
@@ -23,6 +23,7 @@ Requires-Dist: nvidia-riva-client>=2.26.0
 Requires-Dist: openai>=3.18.0
 Requires-Dist: pillow>=12.0.0; sys_platform == 'win32' or sys_platform == 'darwin'
 Requires-Dist: pydantic>=2.13.5
+Requires-Dist: pyperclip>=1.11.0
 Requires-Dist: pystray>=0.19.5; sys_platform == 'win32' or sys_platform == 'darwin'
 Requires-Dist: python-dotenv>=1.2.2
 Requires-Dist: python-telegram-bot>=22.8
@@ -238,6 +239,8 @@ Optional: add an ordered **Fallback Models** list under **Model Config**. It
 applies to every connected client. A failed request may reach and consume usage
 from more than one provider before succeeding.
 
+For another API endpoint, open **Providers → Custom providers → Add provider**. Enter its API base URL, optional key, and API format. Leave **Model IDs** empty to discover models automatically, or enter one upstream model ID per line. Save, then select a model in **Model Config**.
+
 <details>
 <summary><strong>Provider catalog</strong></summary>
 
@@ -548,6 +551,12 @@ Windows PowerShell:
 
 ## Project Links
 
+For a problem after installation, run the command below and paste its output into your bug report. It also copies the JSON to your clipboard when available.
+
+```bash
+fcc-doctor
+```
+
 - [Report bugs or request features](https://github.com/Alishahryar1/free-claude-code/issues)
 - [Contributing guide](CONTRIBUTING.md)
 

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/README.md

@@ -198,6 +198,8 @@ Optional: add an ordered **Fallback Models** list under **Model Config**. It
 applies to every connected client. A failed request may reach and consume usage
 from more than one provider before succeeding.
 
+For another API endpoint, open **Providers → Custom providers → Add provider**. Enter its API base URL, optional key, and API format. Leave **Model IDs** empty to discover models automatically, or enter one upstream model ID per line. Save, then select a model in **Model Config**.
+
 <details>
 <summary><strong>Provider catalog</strong></summary>
 
@@ -508,6 +510,12 @@ Windows PowerShell:
 
 ## Project Links
 
+For a problem after installation, run the command below and paste its output into your bug report. It also copies the JSON to your clipboard when available.
+
+```bash
+fcc-doctor
+```
+
 - [Report bugs or request features](https://github.com/Alishahryar1/free-claude-code/issues)
 - [Contributing guide](CONTRIBUTING.md)
 

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/e2e/conftest.py

@@ -117,6 +117,7 @@ class _ModelListingProvider(BaseProvider):
         response_model: str | None = None,
         reasoning: ReasoningPolicy = DEFAULT_REASONING_POLICY,
         request_headers: Mapping[str, str] | None = None,
+        model_info: ProviderModelInfo | None = None,
     ) -> AsyncIterator[str]:
         if False:
             yield ""

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/e2e/test_admin_apply.py

@@ -47,8 +47,32 @@ def test_apply_is_the_only_config_action_and_retains_invalid_edits(
 def test_key_rejection_retains_edits_and_restores_focus(
     page: Page, admin_base_url: str
 ):
-    pending: list[Route] = []
-    page.route("**/admin/api/config/apply", lambda route: pending.append(route))
+    request_count = 0
+
+    def reject_key(route: Route) -> None:
+        nonlocal request_count
+        request_count += 1
+        expect(page.locator("#messageArea")).to_have_text("Checking API keys…")
+        expect(page.locator("#view-providers")).to_have_attribute("inert", "")
+        expect(page.locator("#applyButton")).to_be_disabled()
+        submitted = route.request.post_data_json
+        assert isinstance(submitted, dict)
+        assert submitted["values"] == {"MISTRAL_API_KEY": "bad-key"}
+        route.fulfill(
+            json={
+                "applied": False,
+                "errors": ["Rejected key"],
+                "credential_checks": [
+                    {
+                        "key": "MISTRAL_API_KEY",
+                        "status": "rejected",
+                        "message": "Check this API key.",
+                    }
+                ],
+            }
+        )
+
+    page.route("**/admin/api/config/apply", reject_key)
     page.goto(f"{admin_base_url}/admin")
     expect(page.locator("#messageArea")).to_have_text("")
     page.get_by_role("button", name="Model Config", exact=True).click()
@@ -58,34 +82,14 @@ def test_key_rejection_retains_edits_and_restores_focus(
     open_provider(page, "mistral")
     key = page.locator("#field-MISTRAL_API_KEY")
     key.fill("bad-key")
-    page.get_by_role("button", name="Save", exact=True).click()
-    expect(page.locator("#messageArea")).to_have_text("Checking API keys…")
-    expect(page.locator("#view-providers")).to_have_attribute("inert", "")
-    expect(page.locator("#applyButton")).to_be_disabled()
-    assert len(pending) == 1
-    submitted = pending[0].request.post_data_json
-    assert isinstance(submitted, dict)
-    assert submitted["values"] == {
-        "MISTRAL_API_KEY": "bad-key",
-    }
-    pending.pop().fulfill(
-        json={
-            "applied": False,
-            "errors": ["Rejected key"],
-            "credential_checks": [
-                {
-                    "key": "MISTRAL_API_KEY",
-                    "status": "rejected",
-                    "message": "Check this API key.",
-                }
-            ],
-        }
-    )
+    with page.expect_response("**/admin/api/config/apply"):
+        page.get_by_role("button", name="Save", exact=True).click()
     expect(key).to_be_focused()
     expect(key).to_have_attribute("aria-invalid", "true")
     expect(page.locator("#field-MISTRAL_API_KEY-error")).to_have_text(
         "Check this API key."
     )
+    assert request_count == 1
     expect(key).to_have_value("bad-key")
     expect(other).to_have_value("open_router/other-edit")
     expect(page.locator("#dirtyState")).to_have_text("1 unsaved change")

free_claude_code-6.3.0/e2e/test_custom_providers.py

@@ -0,0 +1,122 @@
+"""Custom endpoint configuration through the real Admin Apply flow."""
+
+import pytest
+from playwright.sync_api import Page, expect
+
+
+@pytest.fixture(autouse=True)
+def no_page_errors(page: Page):
+    errors = []
+    page.on("pageerror", lambda error: errors.append(str(error)))
+    yield
+    assert errors == []
+
+
+def add_provider(page: Page, name: str) -> str:
+    page.get_by_role("button", name="Add provider", exact=True).click()
+    dialog = page.locator("#providerDialog")
+    dialog.get_by_label("Name", exact=True).fill(name)
+    dialog.get_by_label("Base URL", exact=True).fill("https://gateway.example/team/v1")
+    dialog.get_by_label("API key", exact=True).fill("example-custom-key")
+    dialog.get_by_label("Model IDs", exact=True).fill("org/model-one\nmodel-two")
+    page.locator("#saveProvider").click()
+    expect(dialog).not_to_be_visible()
+    card = page.locator("#providers-custom .provider-card").filter(
+        has=page.get_by_text(name, exact=True)
+    )
+    expect(card).to_be_visible()
+    expect(page.locator("#addCustomProvider")).to_be_focused()
+    provider_id = card.get_attribute("data-provider")
+    assert provider_id is not None
+    return provider_id
+
+
+def test_custom_provider_save_rename_and_remove_preserve_unrelated_draft(
+    page: Page, admin_base_url: str
+):
+    page.goto(admin_base_url + "/admin")
+    expect(page.locator("#messageArea")).to_have_text("")
+    page.locator("#field-HTTP_READ_TIMEOUT").fill("181")
+    provider_id = add_provider(page, "Work gateway")
+    expect(page.locator("#field-HTTP_READ_TIMEOUT")).to_have_value("181")
+    card = page.locator(f'[data-provider="{provider_id}"]')
+    expect(card.locator(".provider-check-result")).to_have_text("2 models available")
+    card.get_by_role("button", name="Edit", exact=True).click()
+    dialog = page.locator("#providerDialog")
+    expect(dialog.get_by_label("API key", exact=True)).to_have_value("")
+    dialog.get_by_label("Name", exact=True).fill("Renamed gateway")
+    page.locator("#saveProvider").click()
+    expect(dialog).not_to_be_visible()
+    expect(card.locator(".provider-title")).to_have_text("Renamed gateway")
+    expect(card.get_by_role("button", name="Edit", exact=True)).to_be_focused()
+    card.get_by_role("button", name="Edit", exact=True).click()
+    dialog.get_by_role("button", name="Remove provider", exact=True).click()
+    expect(dialog).not_to_be_visible()
+    expect(card).to_have_count(0)
+    expect(page.locator("#addCustomProvider")).to_be_focused()
+    expect(page.locator("#field-HTTP_READ_TIMEOUT")).to_have_value("181")
+
+
+def test_custom_provider_sorting_selection_and_blocked_removal(
+    page: Page, admin_base_url: str
+):
+    page.goto(admin_base_url + "/admin")
+    add_provider(page, "Zulu gateway")
+    selected = add_provider(page, "Alpha gateway")
+    expect(page.locator("#providers-custom .provider-title")).to_have_text(
+        ["Alpha gateway", "Zulu gateway"]
+    )
+    page.get_by_role("button", name="Model Config", exact=True).click()
+    model = page.locator("#field-MODEL_HAIKU")
+    model.fill("Alpha gateway")
+    page.get_by_role("option", name="Alpha gateway/org/model-one", exact=True).click()
+    expect(model).to_have_value(f"{selected}/org/model-one")
+    page.locator("#applyButton").click()
+    expect(page.locator("#dirtyState")).to_have_text("No changes")
+    page.get_by_role("button", name="Providers", exact=True).click()
+    page.locator(f'[data-provider="{selected}"]').get_by_role(
+        "button", name="Edit", exact=True
+    ).click()
+    page.get_by_role("button", name="Remove provider", exact=True).click()
+    expect(page.locator("#providerMessage")).to_contain_text("MODEL")
+    expect(page.locator("#providerDialog")).to_be_visible()
+
+
+def test_custom_dialog_cancel_and_format_changes(page: Page, admin_base_url: str):
+    page.goto(admin_base_url + "/admin")
+    page.get_by_role("button", name="Add provider", exact=True).click()
+    dialog = page.locator("#providerDialog")
+    dialog.get_by_label("Reasoning format", exact=True).select_option("thinking")
+    dialog.get_by_label("Reasoning history format", exact=True).select_option(
+        "reasoning_content"
+    )
+    dialog.get_by_label("API format", exact=True).select_option("anthropic_messages")
+    expect(dialog.get_by_label("Reasoning format", exact=True)).to_have_value(
+        "provider_default"
+    )
+    expect(
+        dialog.get_by_label("Reasoning history format", exact=True)
+    ).not_to_be_visible()
+    page.keyboard.press("Escape")
+    expect(dialog).not_to_be_visible()
+    expect(page.locator("#providers-custom .provider-card")).to_have_count(0)
+    expect(page.locator("#addCustomProvider")).to_be_focused()
+
+
+def test_duplicate_custom_provider_keeps_failed_save_draft(
+    page: Page, admin_base_url: str
+):
+    page.goto(admin_base_url + "/admin")
+    add_provider(page, "Gateway")
+    page.get_by_role("button", name="Add provider", exact=True).click()
+    dialog = page.locator("#providerDialog")
+    dialog.get_by_label("Name", exact=True).fill("Gateway")
+    dialog.get_by_label("Base URL", exact=True).fill("https://another.example/v1")
+    page.locator("#saveProvider").click()
+    expect(page.locator("#providerMessage")).to_contain_text("already exists")
+    expect(dialog).to_be_visible()
+    expect(dialog.get_by_label("Base URL", exact=True)).to_have_value(
+        "https://another.example/v1"
+    )
+    expect(page.locator("#saveProvider")).to_be_enabled()
+    expect(page.locator("#providers-custom .provider-card")).to_have_count(1)

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/e2e/test_provider_modals.py

@@ -82,6 +82,7 @@ def test_provider_groups_sort_each_subgroup_and_keep_setup_separate_from_health(
         "OAuth providers",
         "Cloud providers",
         "Local providers",
+        "Custom providers",
     ]
     for group in ("cloud", "local"):
         for subgroup in ("configured", "unconfigured"):

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/pyproject.toml

@@ -37,10 +37,12 @@ dependencies = [
     "grpcio>=1.84.0",
     "grpcio-tools>=1.81.1",
     "nvidia-riva-client>=2.26.0",
+    "pyperclip>=1.11.0",
 ]
 
 [project.scripts]
 fcc-server = "free_claude_code.cli.entrypoints:serve"
+fcc-doctor = "free_claude_code.cli.entrypoints:doctor"
 fcc-claude = "free_claude_code.cli.launchers.claude:launch"
 fcc-codex = "free_claude_code.cli.launchers.codex:launch"
 fcc-pi = "free_claude_code.cli.launchers.pi:launch"

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/scripts/install.ps1

@@ -56,6 +56,7 @@ $FccCommands = @(
     "fcc-grok",
     "fcc-muse",
     "fcc-aider",
+    "fcc-doctor",
     "fcc-update",
     "fcc-init",
     "free-claude-code"
@@ -1488,7 +1489,7 @@ function Configure-AndConfirmFreeClaudeCode {
         [IO.Path]::AltDirectorySeparatorChar
     )
     $installedCommands = @{}
-    foreach ($commandName in @("fcc-desktop", "fcc-server", "fcc-claude", "fcc-codex", "fcc-pi", "fcc-opencode", "fcc-cline", "fcc-hermes", "fcc-dsh", "fcc-grok", "fcc-muse", "fcc-aider", "fcc-update.cmd")) {
+    foreach ($commandName in @("fcc-desktop", "fcc-server", "fcc-claude", "fcc-codex", "fcc-pi", "fcc-opencode", "fcc-cline", "fcc-hermes", "fcc-dsh", "fcc-grok", "fcc-muse", "fcc-aider", "fcc-doctor", "fcc-update.cmd")) {
         $command = Get-ApplicationCommand $commandName
         if (-not $command) {
             throw "Free Claude Code installation did not create '$commandName'."

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/scripts/install.sh

@@ -18,7 +18,7 @@ UV_INSTALL_URL="https://astral.sh/uv/install.sh"
 FCC_MACOS_BUNDLE_ID="io.github.alishahryar1.free-claude-code"
 FCC_MACOS_OWNER_FILE=".free-claude-code-owner"
 # Include retired entry points so updates reject older FCC processes before replacement.
-FCC_COMMANDS="fcc-desktop fcc-server fcc-claude fcc-codex fcc-pi fcc-opencode fcc-cline fcc-hermes fcc-dsh fcc-grok fcc-muse fcc-aider fcc-update fcc-init free-claude-code"
+FCC_COMMANDS="fcc-desktop fcc-server fcc-claude fcc-codex fcc-pi fcc-opencode fcc-cline fcc-hermes fcc-dsh fcc-grok fcc-muse fcc-aider fcc-doctor fcc-update fcc-init free-claude-code"
 
 dry_run=0
 voice_local=0
@@ -1325,7 +1325,7 @@ configure_and_verify_free_claude_code() {
 
     add_uv_tool_bin_directory
 
-    for command_name in fcc-desktop fcc-server fcc-claude fcc-codex fcc-pi fcc-opencode fcc-cline fcc-hermes fcc-dsh fcc-grok fcc-muse fcc-aider fcc-update; do
+    for command_name in fcc-desktop fcc-server fcc-claude fcc-codex fcc-pi fcc-opencode fcc-cline fcc-hermes fcc-dsh fcc-grok fcc-muse fcc-aider fcc-doctor fcc-update; do
         [ -x "$tool_bin/$command_name" ] || fail "Free Claude Code installation did not create $tool_bin/$command_name."
     done
 

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/scripts/uninstall.ps1

@@ -24,6 +24,7 @@ $FccCommands = @(
     "fcc-grok",
     "fcc-muse",
     "fcc-aider",
+    "fcc-doctor",
     "fcc-update",
     "fcc-init",
     "free-claude-code"

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/scripts/uninstall.sh

@@ -6,7 +6,7 @@ FCC_HOME_DIRNAME=".fcc"
 FCC_MACOS_BUNDLE_ID="io.github.alishahryar1.free-claude-code"
 FCC_MACOS_OWNER_FILE=".free-claude-code-owner"
 # Include retired entry points so older installations are fully stopped and removed.
-FCC_COMMANDS="fcc-desktop fcc-server fcc-claude fcc-codex fcc-pi fcc-opencode fcc-cline fcc-hermes fcc-dsh fcc-grok fcc-muse fcc-aider fcc-update fcc-init free-claude-code"
+FCC_COMMANDS="fcc-desktop fcc-server fcc-claude fcc-codex fcc-pi fcc-opencode fcc-cline fcc-hermes fcc-dsh fcc-grok fcc-muse fcc-aider fcc-doctor fcc-update fcc-init free-claude-code"
 
 dry_run=0
 uv_tool_bin=""

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/smoke/README.md

@@ -1,11 +1,13 @@
 # Product E2E Smoke Tests
 
 `smoke/` is local-only. It can launch subprocesses, call real providers, touch
-local model servers, and optionally send/delete bot messages. Hermetic contracts
-belong under `tests/` and must stay green with plain `uv run pytest`.
+local model servers, and optionally send/delete bot messages. Installer checks
+also live here as an opt-in suite. Regular CI collects only `tests/` and `e2e/`.
 
 ## Taxonomy
 
+- `smoke/installers/`: installer, uninstaller, and harness lifecycle checks with
+  isolated files and simulated downloads. These do not install real tools.
 - `smoke/prereq/`: liveness checks that prove the server, routes, auth, CLI
   scripts, provider pings, local `/models`, and bot permissions are reachable.
   These are prerequisites only.
@@ -24,6 +26,13 @@ uv run pytest smoke -n 0 -s --tb=short
 The second command skips everything unless `FCC_LIVE_SMOKE=1` is set, but still
 writes skip entries to `.smoke-results/`.
 
+Run only the installer checks:
+
+```powershell
+$env:FCC_LIVE_SMOKE = "1"
+uv run pytest smoke/installers
+```
+
 ## Product Smoke Run
 
 ```powershell

{free_claude_code-6.2.70/tests → free_claude_code-6.3.0/smoke}/installers/AGENTS.md

@@ -9,7 +9,7 @@ These rules apply to installer, uninstaller, and harness lifecycle tests here.
   and abort ordering between installation phases. Preserve those assertions when
   making tests faster. Prepare unrelated prerequisites as already installed.
 - Keep coverage for both Windows PowerShell and PowerShell 7, plus the applicable
-  POSIX paths. Do not skip coverage or move it out of CI to hide slow tests.
+  POSIX paths. This suite is opt-in and does not run in regular CI.
 - Stub downloads and external installers. Never install real harnesses, use live
   providers, or modify the user's installed tools and configuration in these tests.
 - Give every scenario private files, configuration, PATH, and cache storage. Use
@@ -22,7 +22,7 @@ These rules apply to installer, uninstaller, and harness lifecycle tests here.
   or user configuration to save startup time. Clean up processes you launch.
 - Diagnose slowness with per-test durations and timings inside subprocesses. Do not
   increase timeouts or add sleeps without identifying the operation being delayed.
-- Use `scripts/ci.ps1` for local verification. `PYTEST_ADDOPTS` can select focused
-  cases and enable duration reporting. Run the full relevant suite before pushing.
+- Run these checks explicitly with `FCC_LIVE_SMOKE=1` and
+  `uv run pytest smoke/installers`. Select focused cases when checking a component.
 - Reuse pytest's capture handler for logs. Do not create a logging cycle between
   Python logging and Loguru while adding diagnostics.

{free_claude_code-6.2.70/tests → free_claude_code-6.3.0/smoke}/installers/test_installers.py

@@ -26,6 +26,7 @@ FCC_COMMANDS = (
     "fcc-grok",
     "fcc-muse",
     "fcc-aider",
+    "fcc-doctor",
     "fcc-update",
     "fcc-init",
     "free-claude-code",
@@ -191,6 +192,7 @@ if [ "${{1:-}}" = "tool" ] && [ "${{2:-}}" = "install" ]; then
     cp "$FAKE_FIXTURES/fcc-command.sh" "$tool_bin/fcc-grok"
     cp "$FAKE_FIXTURES/fcc-command.sh" "$tool_bin/fcc-muse"
     cp "$FAKE_FIXTURES/fcc-command.sh" "$tool_bin/fcc-aider"
+    cp "$FAKE_FIXTURES/fcc-command.sh" "$tool_bin/fcc-doctor"
     cp "$FAKE_FIXTURES/fcc-command.sh" "$tool_bin/fcc-update"
     if [ "$FAIL_STEP" != "fcc-missing" ]; then
         cp "$FAKE_FIXTURES/fcc-command.sh" "$tool_bin/fcc-codex"
@@ -2107,6 +2109,7 @@ copy /y "%FAKE_FIXTURES%\fcc-command.cmd" "%UV_BIN_DIR%\fcc-dsh.cmd" >nul
 copy /y "%FAKE_FIXTURES%\fcc-command.cmd" "%UV_BIN_DIR%\fcc-grok.cmd" >nul
 copy /y "%FAKE_FIXTURES%\fcc-command.cmd" "%UV_BIN_DIR%\fcc-muse.cmd" >nul
 copy /y "%FAKE_FIXTURES%\fcc-command.cmd" "%UV_BIN_DIR%\fcc-aider.cmd" >nul
+copy /y "%FAKE_FIXTURES%\fcc-command.cmd" "%UV_BIN_DIR%\fcc-doctor.cmd" >nul
 copy /y "%FAKE_FIXTURES%\fcc-command.cmd" "%UV_BIN_DIR%\fcc-update.cmd" >nul
 if not "%FAIL_STEP%"=="fcc-missing" copy /y "%FAKE_FIXTURES%\fcc-command.cmd" "%UV_BIN_DIR%\fcc-codex.cmd" >nul
 exit /b 0

{free_claude_code-6.2.70/tests → free_claude_code-6.3.0/smoke}/installers/test_uninstallers.py

@@ -19,6 +19,7 @@ FCC_COMMANDS = (
     "fcc-grok",
     "fcc-muse",
     "fcc-aider",
+    "fcc-doctor",
     "fcc-update",
     "fcc-init",
     "free-claude-code",
@@ -192,7 +193,7 @@ if [ "${1:-}" = "tool" ] && [ "${2:-}" = "uninstall" ]; then
         echo 'Tool `free-claude-code` is not installed' >&2
         exit 2
     fi
-    for name in fcc-desktop fcc-server fcc-claude fcc-codex fcc-pi fcc-opencode fcc-cline fcc-hermes fcc-dsh fcc-grok fcc-muse fcc-aider fcc-update fcc-init free-claude-code; do
+    for name in fcc-desktop fcc-server fcc-claude fcc-codex fcc-pi fcc-opencode fcc-cline fcc-hermes fcc-dsh fcc-grok fcc-muse fcc-aider fcc-doctor fcc-update fcc-init free-claude-code; do
         /bin/rm -f "$FAKE_TOOL_BIN/$name"
     done
     echo "Uninstalled free-claude-code"

{free_claude_code-6.2.70 → free_claude_code-6.3.0}/src/free_claude_code/api/admin_routes.py

@@ -22,6 +22,7 @@ from free_claude_code.application.connected_accounts import (
 from free_claude_code.application.errors import ApplicationError
 from free_claude_code.application.model_catalog import read_model_catalog
 from free_claude_code.application.model_metadata import ProviderModelRefreshResult
+from free_claude_code.config.admin.custom_providers import CustomProviderMutation
 from free_claude_code.config.admin.manifest import FIELD_BY_KEY
 from free_claude_code.config.provider_catalog import (
     PROVIDER_CATALOG,
@@ -76,6 +77,7 @@ class AdminConfigPayload(BaseModel):
     """Partial config update submitted by the admin UI."""
 
     values: JsonObject = Field(default_factory=dict)
+    custom_provider: CustomProviderMutation | None = None
 
 
 class ConnectedAccountLoginPayload(BaseModel):
@@ -136,6 +138,10 @@ async def apply_admin_config(
     services: ApiServices = Depends(get_services),
 ):
     require_loopback_admin(request)
+    if payload.custom_provider is not None:
+        return await services.admin.apply_admin_config(
+            _filtered_values(payload.values), payload.custom_provider
+        )
     result = await services.admin.apply_admin_config(_filtered_values(payload.values))
     return result
 
@@ -421,13 +427,16 @@ def _model_options(
     services: ApiServices,
     *,
     refresh_result: ProviderModelRefreshResult | None = None,
-) -> dict[str, list[str]]:
+) -> JsonObject:
     catalog = read_model_catalog(services.requests)
     failed_provider_ids = (
         refresh_result.failed_provider_ids if refresh_result is not None else ()
     )
     return {
         "models": [model.provider_model_ref for model in catalog.models],
+        "model_labels": {
+            model.provider_model_ref: model.display_name for model in catalog.models
+        },
         "failed_providers": list(failed_provider_ids),
     }