free-claude-code 6.2.69__tar.gz → 6.2.71__tar.gz

free_claude_code-6.2.71/.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.2.71/.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.69 → free_claude_code-6.2.71}/.github/actions/ci-environment/action.yml

@@ -19,6 +19,9 @@ inputs:
     default: "false"
 
 outputs:
+  python-version:
+    description: Exact Python version required by the project
+    value: ${{ steps.identity.outputs.python-version }}
   python-path:
     description: Managed Python cache directory
     value: ${{ steps.identity.outputs.python-path }}
@@ -62,8 +65,8 @@ runs:
         CI_UV: ${{ inputs.uv-version }}
       run: |
         set -euo pipefail
-        version="$(tr -d '[:space:]' < .python-version)"
-        test -n "$version"
+        version="$(python -c 'import pathlib, tomllib; print(tomllib.loads(pathlib.Path("pyproject.toml").read_text(encoding="utf-8"))["project"]["requires-python"].removeprefix("=="))')"
+        [[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || { echo 'Expected an exact requires-python pin in pyproject.toml' >&2; exit 1; }
         cache_root="${CI_TEMP//\\//}"
         identity="$CI_RUNNER-$CI_OS-$CI_ARCH-py-$version-uv-$CI_UV"
         {

{free_claude_code-6.2.69 → free_claude_code-6.2.71}/.github/workflows/post-merge.yml

@@ -95,6 +95,7 @@ jobs:
           fetch-depth: 0
 
       - name: Set up CI environment
+        id: environment
         uses: ./.github/actions/ci-environment
         with:
           uv-version: ${{ env.CI_UV_VERSION }}
@@ -107,6 +108,7 @@ jobs:
           GH_TOKEN: ${{ github.token }}
           RELEASE_REPOSITORY: ${{ github.repository }}
           RELEASE_COMMIT: ${{ inputs.release_commit || github.sha }}
+          CI_PYTHON: ${{ steps.environment.outputs.python-version }}
         run: |
-          uv run --no-project --python "$(cat .python-version)" python -m scripts.publish_release \
+          uv run --no-project --python "$CI_PYTHON" python -m scripts.publish_release \
             --repository "$RELEASE_REPOSITORY" --commit "$RELEASE_COMMIT"

{free_claude_code-6.2.69 → free_claude_code-6.2.71}/.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.69 → free_claude_code-6.2.71}/CONTRIBUTING.md

@@ -11,18 +11,17 @@ Thanks for helping improve Free Claude Code. Keep changes focused, test the beha
 
 ## Pull Request Titles
 
-Changes to `assets/`, `scripts/`, `src/`, `.python-version`, `pyproject.toml`, or `uv.lock` require a title starting with `patch: `, `minor: `, or `major: ` followed by a description. Use exactly one space after the colon.
+Changes to `assets/`, `scripts/`, `src/`, `pyproject.toml`, or `uv.lock` require a title starting with `patch: `, `minor: `, or `major: ` followed by a description. Use exactly one space after the colon.
 
 PRs without changes to those paths must not use a release prefix. Do not edit version numbers. Publishing calculates the version after merge, creates its Git tag, and publishes to PyPI and GitHub Releases.
 
 ## Development Setup
 
-Install [uv](https://docs.astral.sh/uv/) and Python 3.14, then run directly from the checkout:
+Install [uv](https://docs.astral.sh/uv/), then run directly from the checkout. uv automatically installs the Python version required by the project.
 
 ```bash
 git clone https://github.com/Alishahryar1/free-claude-code.git
 cd free-claude-code
-uv python install 3.14.0
 uv run fcc-server
 ```
 

{free_claude_code-6.2.69 → free_claude_code-6.2.71}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.5
 Name: free-claude-code
-Version: 6.2.69
+Version: 6.2.71
 Summary: Local proxy connecting coding agents to OpenAI-compatible AI providers
 License-Expression: AGPL-3.0-only
 License-File: LICENSE
-Requires-Python: >=3.14.0
+Requires-Python: ==3.14.7
 Requires-Dist: aiohttp>=3.14.3
 Requires-Dist: anyio>=4.15.1
 Requires-Dist: discord-py>=2.7.1
@@ -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
@@ -548,6 +549,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.69 → free_claude_code-6.2.71}/README.md

@@ -508,6 +508,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.69 → free_claude_code-6.2.71}/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.2.69 → free_claude_code-6.2.71}/e2e/test_progressive_startup.py

@@ -73,7 +73,16 @@ def test_codex_connect_waits_for_catalog_and_recovers_from_publication_error(
         route.fulfill(json=data)
 
     page.route("**/admin/api/status", status)
-    page.goto(f"{admin_base_url}/admin/integrations")
+    with (
+        page.expect_response(
+            "**/admin/api/integrations/claude-vscode"
+        ) as claude_status,
+        page.expect_response("**/admin/api/integrations/codex") as codex_status,
+    ):
+        page.goto(f"{admin_base_url}/admin/integrations")
+    claude_status.value.finished()
+    codex_status.value.finished()
+    page.wait_for_function("state.startup?.startup?.catalog_file === 'starting'")
     connect = page.locator("#openCodexIntegration")
     expect(connect).to_be_disabled()
     expect(connect).to_have_attribute("aria-busy", "true")

{free_claude_code-6.2.69 → free_claude_code-6.2.71}/pyproject.toml

@@ -9,7 +9,7 @@ description = "Local proxy connecting coding agents to OpenAI-compatible AI prov
 readme = "README.md"
 license = "AGPL-3.0-only"
 license-files = ["LICENSE"]
-requires-python = ">=3.14.0"
+requires-python = "==3.14.7"
 dependencies = [
     "anyio>=4.15.1",
     "fastapi[standard]>=0.141.1",
@@ -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.69 → free_claude_code-6.2.71}/scripts/install.ps1

@@ -13,7 +13,7 @@ $ErrorActionPreference = "Stop"
 $ProgressPreference = "SilentlyContinue"
 
 # Windows on ARM emulates x64, whose Python package ecosystem has broader wheel support.
-$PythonRequest = "cpython-3.14.0-windows-x86_64-none"
+$PythonRequest = "cpython-3.14.7-windows-x86_64-none"
 $MinUvVersion = "0.12.13"
 $ClaudeInstallUrl = "https://claude.ai/install.ps1"
 $CodexInstallUrl = "https://chatgpt.com/codex/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.69 → free_claude_code-6.2.71}/scripts/install.sh

@@ -1,7 +1,7 @@
 #!/bin/sh
 set -eu
 
-PYTHON_VERSION="3.14.0"
+PYTHON_VERSION="3.14.7"
 MIN_UV_VERSION="0.12.13"
 CLAUDE_INSTALL_URL="https://claude.ai/install.sh"
 CODEX_INSTALL_URL="https://chatgpt.com/codex/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.69 → free_claude_code-6.2.71}/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.69 → free_claude_code-6.2.71}/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.71/src/free_claude_code/cli/clipboard.py

@@ -0,0 +1,14 @@
+"""Best-effort text copy for the diagnostic command."""
+
+import pyperclip
+
+
+class ClipboardUnavailable(Exception):
+    """The current desktop cannot accept clipboard text."""
+
+
+def copy_text(text: str) -> None:
+    try:
+        pyperclip.copy(text)
+    except (pyperclip.PyperclipException, OSError) as error:
+        raise ClipboardUnavailable from error

free_claude_code-6.2.71/src/free_claude_code/cli/doctor.py

@@ -0,0 +1,25 @@
+"""Print and copy a shareable local diagnostic report."""
+
+import argparse
+import json
+import sys
+from collections.abc import Sequence
+
+from free_claude_code.runtime.diagnostics import collect_report
+
+from .clipboard import ClipboardUnavailable, copy_text
+
+
+def main(argv: Sequence[str] | None = None) -> None:
+    argparse.ArgumentParser(
+        prog="fcc-doctor",
+        description="Print and copy FCC diagnostics for a bug report.",
+    ).parse_args(argv)
+    text = json.dumps(collect_report(), indent=2, ensure_ascii=False) + "\n"
+    sys.stdout.write(text)
+    try:
+        copy_text(text)
+    except ClipboardUnavailable:
+        print("Clipboard unavailable. Copy the JSON above manually.", file=sys.stderr)
+    else:
+        print("FCC diagnostics copied to the clipboard.", file=sys.stderr)

{free_claude_code-6.2.69 → free_claude_code-6.2.71}/src/free_claude_code/cli/entrypoints.py

@@ -23,3 +23,12 @@ def _print_version_if_requested(argv: Sequence[str] | None) -> bool:
         return False
     print(f"free-claude-code {package_version()}")
     return True
+
+
+def doctor(argv: Sequence[str] | None = None) -> None:
+    """Print and copy a local diagnostic report (registered as ``fcc-doctor``)."""
+    if _print_version_if_requested(argv):
+        return
+    from free_claude_code.cli.doctor import main
+
+    main(argv)

{free_claude_code-6.2.69 → free_claude_code-6.2.71}/src/free_claude_code/providers/openai_codex/auth.py

@@ -130,6 +130,30 @@ class _Credentials:
         }
 
 
+def _read_saved_credentials(path: Path) -> _Credentials | None:
+    if not path.is_file():
+        return None
+    try:
+        payload = json.loads(path.read_text(encoding="utf-8"))
+        if not isinstance(payload, dict) or payload.get("version") != 1:
+            raise ValueError("credential document has an unsupported schema")
+        return _Credentials.from_json(payload.get("credentials"))
+    except (OSError, json.JSONDecodeError, OpenAILoginError, ValueError) as exc:
+        raise ValueError("OpenAI credential file is invalid") from exc
+
+
+def saved_connection_state() -> str:
+    """Inspect saved credentials without creating a client or refreshing tokens."""
+    try:
+        return (
+            "connected"
+            if _read_saved_credentials(openai_auth_path())
+            else "disconnected"
+        )
+    except OSError, ValueError:
+        return "unavailable"
+
+
 class OpenAIAuthManager:
     """Own credentials, interactive login, refresh, and revocation."""
 
@@ -515,15 +539,7 @@ class OpenAIAuthManager:
         self._credential_path.unlink(missing_ok=True)
 
     def _read_credentials(self) -> _Credentials | None:
-        if not self._credential_path.is_file():
-            return None
-        try:
-            payload = json.loads(self._credential_path.read_text(encoding="utf-8"))
-            if not isinstance(payload, dict) or payload.get("version") != 1:
-                raise ValueError("credential document has an unsupported schema")
-            return _Credentials.from_json(payload.get("credentials"))
-        except (OSError, json.JSONDecodeError, OpenAILoginError, ValueError) as exc:
-            raise ValueError("OpenAI credential file is invalid") from exc
+        return _read_saved_credentials(self._credential_path)
 
     def _detach_login_locked(
         self,