free-claude-code 6.2.64__tar.gz

free_claude_code-6.2.64/.gitattributes

@@ -0,0 +1,3 @@
+src/free_claude_code/core/data/cl100k_base.tiktoken -text linguist-vendored=true
+scripts/update/fcc-update text eol=lf
+scripts/update/*.cmd text eol=crlf

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

@@ -0,0 +1,57 @@
+name: Bug report
+description: Report something that is not working in Free Claude Code.
+labels:
+  - bug
+body:
+  - type: input
+    id: fcc-version
+    attributes:
+      label: FCC version
+      description: Run `fcc-server --version` and include one version in `number.number.number` format. If FCC did not install, enter `None`.
+      placeholder: "The version is 1.22.333, or None"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: cli
+    attributes:
+      label: CLI
+      description: If the problem occurred while using a coding CLI, select it.
+      options:
+        - Claude Code (fcc-claude)
+        - Codex (fcc-codex)
+        - Pi (fcc-pi)
+
+  - type: input
+    id: selected-models
+    attributes:
+      label: Selected model(s)
+      description: If relevant, enter each model exactly as shown in the selector or configuration.
+      placeholder: nvidia_nim/nvidia/nemotron-3-super-120b-a12b
+
+  - type: textarea
+    id: model-mappings
+    attributes:
+      label: Model mappings
+      description: If relevant, enter the model mappings used when the problem occurred.
+      placeholder: |
+        MODEL_FABLE=
+        MODEL_OPUS=
+        MODEL_SONNET=
+        MODEL_HAIKU=
+
+  - type: input
+    id: providers
+    attributes:
+      label: Provider(s)
+      description: If relevant, enter the provider or providers involved.
+      placeholder: NVIDIA NIM, OpenRouter
+
+  - type: textarea
+    id: issue
+    attributes:
+      label: Issue
+      description: Describe what happened and include any useful reproduction details. Remove API keys and tokens from logs or screenshots.
+      placeholder: Tell us what went wrong.
+    validations:
+      required: true

free_claude_code-6.2.64/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Report a security vulnerability
+    url: https://github.com/Alishahryar1/free-claude-code/security/advisories/new
+    about: Report credential leaks and security vulnerabilities privately.

free_claude_code-6.2.64/.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,22 @@
+name: Feature request
+description: Suggest an improvement to Free Claude Code.
+labels:
+  - enhancement
+body:
+  - type: textarea
+    id: what
+    attributes:
+      label: What?
+      description: What would you like Free Claude Code to do?
+      placeholder: Describe the feature.
+    validations:
+      required: true
+
+  - type: textarea
+    id: why
+    attributes:
+      label: Why?
+      description: Why would this be useful?
+      placeholder: Describe the problem or use case this would address.
+    validations:
+      required: true

free_claude_code-6.2.64/.github/actions/ci-environment/action.yml

@@ -0,0 +1,152 @@
+name: CI environment
+description: Restore managed Python and uv dependencies using the same cache identity on every runner.
+
+inputs:
+  uv-version:
+    description: Pinned uv version
+    required: true
+  runner-label:
+    description: GitHub runner image label
+    required: true
+  lookup-only:
+    description: Check dependency cache availability without downloading it
+    default: "false"
+  sync-dependencies:
+    description: Install the locked project and development dependencies after cache restoration.
+    default: "true"
+  prepare-node:
+    description: Prepare the Node runtime used by pytest subprocess contracts.
+    default: "false"
+
+outputs:
+  python-path:
+    description: Managed Python cache directory
+    value: ${{ steps.identity.outputs.python-path }}
+  python-key:
+    description: Exact managed Python cache key
+    value: ${{ steps.identity.outputs.python-key }}
+  python-hit:
+    description: Whether managed Python was restored from the exact key
+    value: ${{ steps.python-cache.outputs.cache-hit }}
+  dependencies-path:
+    description: uv dependency cache directory
+    value: ${{ steps.identity.outputs.dependencies-path }}
+  dependencies-prefix:
+    description: Compatible dependency cache prefix
+    value: ${{ steps.identity.outputs.dependencies-prefix }}
+  dependencies-key:
+    description: Exact dependency cache key
+    value: ${{ steps.identity.outputs.dependencies-prefix }}${{ steps.dependencies.outputs.hash }}
+  dependencies-hit:
+    description: Whether the exact dependency key exists
+    value: ${{ steps.dependencies-cache.outputs.cache-hit }}
+
+runs:
+  using: composite
+  steps:
+    - name: Prepare cache identity
+      id: identity
+      shell: bash
+      env:
+        CI_TEMP: ${{ runner.temp }}
+        CI_RUNNER: ${{ inputs.runner-label }}
+        CI_OS: ${{ runner.os }}
+        CI_ARCH: ${{ runner.arch }}
+        CI_UV: ${{ inputs.uv-version }}
+      run: |
+        set -euo pipefail
+        version="$(tr -d '[:space:]' < .python-version)"
+        test -n "$version"
+        cache_root="${CI_TEMP//\\//}"
+        identity="$CI_RUNNER-$CI_OS-$CI_ARCH-py-$version-uv-$CI_UV"
+        {
+          echo "UV_CACHE_DIR=$cache_root/fcc-uv-cache"
+          echo "UV_PYTHON_INSTALL_DIR=$cache_root/fcc-uv-python"
+          echo "UV_PYTHON_PREFERENCE=only-managed"
+        } >> "$GITHUB_ENV"
+        {
+          echo "python-version=$version"
+          echo "python-path=$cache_root/fcc-uv-python"
+          echo "python-key=uv-python-v2-$identity"
+          echo "dependencies-path=$cache_root/fcc-uv-cache"
+          echo "dependencies-prefix=uv-deps-v2-$identity-"
+        } >> "$GITHUB_OUTPUT"
+
+    - name: Restore Python
+      id: python-cache
+      uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
+      with:
+        path: ${{ steps.identity.outputs.python-path }}
+        key: ${{ steps.identity.outputs.python-key }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4
+      with:
+        version: ${{ inputs.uv-version }}
+        enable-cache: false
+
+    - name: Install Python
+      if: steps.python-cache.outputs.cache-hit != 'true'
+      shell: bash
+      env:
+        CI_PYTHON: ${{ steps.identity.outputs.python-version }}
+      run: uv python install "$CI_PYTHON"
+
+    - name: Prepare Node runtime
+      if: inputs.prepare-node == 'true'
+      shell: bash
+      env:
+        CI_PYTHON: ${{ steps.identity.outputs.python-version }}
+      run: |
+        uv run --no-project --python "$CI_PYTHON" python - <<'PY'
+        import shutil
+        import subprocess
+
+        node = shutil.which("node")
+        if node is None:
+            raise RuntimeError("Node is required for pytest subprocess contracts")
+        # Cold executable paging must happen before the timed behavior checks.
+        subprocess.run(
+            [node, "--experimental-strip-types", "--input-type=module", "--eval",
+             "import { stripTypeScriptTypes } from 'node:module'; "
+             "stripTypeScriptTypes('const value: number = 1'); "
+             "await new Response('ready').text(); "
+             "console.log('Node runtime ready:', process.version);"],
+            check=True,
+            timeout=120,
+        )
+        PY
+
+    - name: Fingerprint dependencies
+      id: dependencies
+      shell: bash
+      env:
+        CI_PYTHON: ${{ steps.identity.outputs.python-version }}
+      run: |
+        set -euo pipefail
+        uv export --locked --group dev --no-emit-workspace --no-header --no-annotate \
+          --output-file "$RUNNER_TEMP/uv-ci-dependencies.txt" > /dev/null
+        uv run --no-project --python "$CI_PYTHON" python - <<'PY'
+        import hashlib
+        import os
+        from pathlib import Path
+
+        dependencies = Path(os.environ["RUNNER_TEMP"]) / "uv-ci-dependencies.txt"
+        digest = hashlib.sha256(dependencies.read_bytes().replace(b"\r\n", b"\n")).hexdigest()
+        with Path(os.environ["GITHUB_OUTPUT"]).open("a", encoding="utf-8") as output:
+            output.write(f"hash={digest}\n")
+        PY
+
+    - name: Restore dependency cache
+      id: dependencies-cache
+      uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
+      with:
+        path: ${{ steps.identity.outputs.dependencies-path }}
+        key: ${{ steps.identity.outputs.dependencies-prefix }}${{ steps.dependencies.outputs.hash }}
+        restore-keys: ${{ steps.identity.outputs.dependencies-prefix }}
+        lookup-only: ${{ inputs.lookup-only }}
+
+    - name: Install dependencies
+      if: inputs.sync-dependencies == 'true'
+      shell: bash
+      run: uv sync --locked --group dev

free_claude_code-6.2.64/.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      minor-and-patch:
+        update-types: ["minor", "patch"]
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

free_claude_code-6.2.64/.github/workflows/post-merge.yml

@@ -0,0 +1,142 @@
+name: Post merge
+
+env:
+  CI_UV_VERSION: "0.12.13"
+  UV_MALWARE_CHECK: "1"
+  UV_PREVIEW_FEATURES: "malware-check"
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+
+concurrency:
+  group: post-merge-main
+  cancel-in-progress: false
+  queue: max
+
+jobs:
+  warm-dependency-cache:
+    name: Warm dependency cache (${{ matrix.os }})
+    if: github.ref == 'refs/heads/main'
+    runs-on: ${{ matrix.runner }}
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: Linux
+            runner: ubuntu-latest
+          - os: Windows
+            runner: windows-latest
+          - os: macOS
+            runner: macos-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          ref: ${{ github.sha }}
+          fetch-depth: 1
+
+      - name: Set up CI environment
+        id: environment
+        uses: ./.github/actions/ci-environment
+        with:
+          uv-version: ${{ env.CI_UV_VERSION }}
+          runner-label: ${{ matrix.runner }}
+          lookup-only: "true"
+          sync-dependencies: "false"
+
+      - name: Save Python
+        if: steps.environment.outputs.python-hit != 'true'
+        uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
+        with:
+          path: ${{ steps.environment.outputs.python-path }}
+          key: ${{ steps.environment.outputs.python-key }}
+
+      - name: Restore compatible dependency cache
+        if: steps.environment.outputs.dependencies-hit != 'true'
+        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
+        with:
+          path: ${{ steps.environment.outputs.dependencies-path }}
+          key: ${{ steps.environment.outputs.dependencies-key }}
+          restore-keys: ${{ steps.environment.outputs.dependencies-prefix }}
+
+      - name: Warm dependency cache
+        if: steps.environment.outputs.dependencies-hit != 'true'
+        run: uv sync --locked --group dev --no-install-workspace
+
+      - name: Save dependency cache
+        if: steps.environment.outputs.dependencies-hit != 'true'
+        uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
+        with:
+          path: ${{ steps.environment.outputs.dependencies-path }}
+          key: ${{ steps.environment.outputs.dependencies-key }}
+
+  publish:
+    name: Publish to PyPI
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          ref: ${{ github.sha }}
+          fetch-depth: 2
+
+      - name: Fetch previous revision
+        env:
+          BEFORE_SHA: ${{ github.event.before }}
+        run: |
+          if [ -n "$BEFORE_SHA" ]; then
+            git fetch --no-tags --depth=1 origin "$BEFORE_SHA"
+          fi
+
+      - name: Set up CI environment
+        uses: ./.github/actions/ci-environment
+        with:
+          uv-version: ${{ env.CI_UV_VERSION }}
+          runner-label: ubuntu-latest
+          lookup-only: "true"
+          sync-dependencies: "false"
+
+      - name: Detect release
+        id: release
+        env:
+          BEFORE_SHA: ${{ github.event.before }}
+          HEAD_SHA: ${{ github.sha }}
+        run: |
+          uv run --no-project --python "$(cat .python-version)" python - <<'PY'
+          import os
+          import subprocess
+          import tomllib
+          from pathlib import Path
+
+          head = os.environ["HEAD_SHA"]
+          before = os.environ.get("BEFORE_SHA") or f"{head}^"
+          def version(revision):
+              result = subprocess.run(
+                  ["git", "show", f"{revision}:pyproject.toml"],
+                  check=True, capture_output=True, text=True,
+              )
+              return tomllib.loads(result.stdout)["project"]["version"]
+          current, previous = version(head), version(before)
+          with Path(os.environ["GITHUB_OUTPUT"]).open("a", encoding="utf-8") as output:
+              output.write(f"changed={str(current != previous).lower()}\n")
+          print(f"Release version: {previous} -> {current}")
+          PY
+
+      - name: Build and validate release
+        if: steps.release.outputs.changed == 'true'
+        run: |
+          uv build --no-sources --out-dir "$RUNNER_TEMP/fcc-release"
+          uv run --no-project --python "$(cat .python-version)" python scripts/validate_release.py "$RUNNER_TEMP/fcc-release"
+
+      - name: Publish release
+        if: steps.release.outputs.changed == 'true'
+        run: uv publish --trusted-publishing always "$RUNNER_TEMP/fcc-release/"*

free_claude_code-6.2.64/.github/workflows/tests.yml

@@ -0,0 +1,186 @@
+# Branch protection: require every status check this workflow reports, for example:
+#   Ban suppressions and legacy annotations
+#   ruff-format, ruff-check, ty
+#   Version policy
+#   pytest (Linux), pytest (Windows), pytest (macOS)
+#   playwright (Linux), playwright (Windows), playwright (macOS)
+# GitHub may prefix with the workflow name (e.g. "CI / ruff-format"); use the names the branch protection UI offers after a run.
+
+name: CI
+
+env:
+  CI_UV_VERSION: "0.12.13"
+  UV_MALWARE_CHECK: "1"
+  UV_PREVIEW_FEATURES: "malware-check"
+
+on:
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  version-policy:
+    name: Version policy
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          fetch-depth: 0
+
+      - name: Fetch target revision
+        env:
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          BASE_REPOSITORY: ${{ github.event.pull_request.base.repo.full_name }}
+        run: git fetch --no-tags "https://github.com/$BASE_REPOSITORY.git" "$BASE_SHA"
+
+      - name: Set up CI environment
+        uses: ./.github/actions/ci-environment
+        with:
+          uv-version: ${{ env.CI_UV_VERSION }}
+          runner-label: ubuntu-latest
+
+      - name: Check version policy
+        env:
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: uv run --locked --group dev python scripts/check_version_policy.py --base "$BASE_SHA" --head "$HEAD_SHA"
+
+  no-suppressions-or-legacy-annotations:
+    name: Ban suppressions and legacy annotations
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name || github.repository }}
+          fetch-depth: 1
+
+      - name: "Fail on type ignores and legacy future annotations"
+        run: |
+          if grep -rE '# type: ignore|# ty: ignore|from __future__ import annotations' --include='*.py' . --exclude-dir=.venv --exclude-dir=.git; then
+            echo "::error::type: ignore / ty: ignore comments and legacy future annotations are not allowed. Fix the underlying type/import issue instead."
+            exit 1
+          fi
+          exit 0
+
+  quality:
+    name: ${{ matrix.id }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - id: ruff-format
+            run: uv run --locked ruff format --check
+          - id: ruff-check
+            run: uv run --locked ruff check
+          - id: ty
+            run: uv run --locked ty check
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name || github.repository }}
+          fetch-depth: 1
+
+      - name: Set up CI environment
+        uses: ./.github/actions/ci-environment
+        with:
+          uv-version: ${{ env.CI_UV_VERSION }}
+          runner-label: ubuntu-latest
+
+      - name: Run
+        run: ${{ matrix.run }}
+
+  pytest:
+    name: pytest (${{ matrix.os }})
+    runs-on: ${{ matrix.runner }}
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: Linux
+            runner: ubuntu-latest
+          - os: Windows
+            runner: windows-latest
+          - os: macOS
+            runner: macos-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name || github.repository }}
+          fetch-depth: 1
+
+      - name: Set up CI environment
+        uses: ./.github/actions/ci-environment
+        with:
+          uv-version: ${{ env.CI_UV_VERSION }}
+          runner-label: ${{ matrix.runner }}
+          prepare-node: "true"
+
+      - name: Run pytest
+        run: uv run --locked pytest -v --tb=short --durations=50
+
+  playwright:
+    name: playwright (${{ matrix.os }})
+    runs-on: ${{ matrix.runner }}
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: Linux
+            runner: ubuntu-latest
+          - os: Windows
+            runner: windows-latest
+          - os: macOS
+            runner: macos-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name || github.repository }}
+          fetch-depth: 1
+
+      - name: Set up CI environment
+        uses: ./.github/actions/ci-environment
+        with:
+          uv-version: ${{ env.CI_UV_VERSION }}
+          runner-label: ${{ matrix.runner }}
+
+      - name: Install Chromium
+        run: uv run --locked playwright install ${{ matrix.os == 'Linux' && '--with-deps chromium' || 'chromium' }}
+
+      - name: Run Playwright
+        run: >-
+          uv run --locked pytest e2e -v --tb=short
+          --tracing=retain-on-failure --screenshot=only-on-failure
+          --full-page-screenshot --output=test-results
+
+      - name: Upload Playwright failure artifacts
+        if: failure()
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
+        with:
+          name: playwright-results-${{ runner.os }}-${{ runner.arch }}-${{ github.run_id }}-${{ github.run_attempt }}
+          path: test-results/
+          if-no-files-found: ignore
+          retention-days: 7