Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python
1.9 KB
Raw Blame
"""Browser-friendly local server URLs shared by runtime and launchers."""

from urllib.parse import urlsplit

from free_claude_code.config.settings import Settings


def _browser_host_for_local_urls(settings: Settings) -> str:
    """Host fragment for URLs shown to humans on the same machine as the server."""

    host = settings.host.strip() if settings.host else "127.0.0.1"
    if host in {"0.0.0.0", "::", "[::]"}:
        host = "127.0.0.1"
    if ":" in host and not host.startswith("["):
        host = f"[{host}]"
    return host


def local_proxy_root_url(settings: Settings) -> str:
    """Return the proxy root URL (no path) for clients on the same machine."""

    return f"http://{_browser_host_for_local_urls(settings)}:{settings.port}"


def local_admin_url(settings: Settings) -> str:
    """Return a browser-friendly URL for the localhost-only admin UI."""

    return f"{local_proxy_root_url(settings)}/admin"


def same_proxy_url(value: object, expected: str) -> bool:
    """Compare client endpoints, allowing equivalent loopback names and trailing slashes."""
    if not isinstance(value, str):
        return False

    def normalized(url: str) -> tuple[str, str | None, int | None, str]:
        parsed = urlsplit(url)
        if parsed.username or parsed.password or parsed.query or parsed.fragment:
            raise ValueError("Unexpected URL components")
        host = parsed.hostname
        if host in {"localhost", "127.0.0.1", "::1"}:
            host = "localhost"
        return parsed.scheme, host, parsed.port, parsed.path.rstrip("/")

    try:
        return normalized(value) == normalized(expected)
    except ValueError:
        return False


def proxy_v1_url(proxy_root_url: str) -> str:
    """Return the canonical local proxy API root for client launchers."""

    stripped = proxy_root_url.rstrip("/")
    return stripped if stripped.endswith("/v1") else f"{stripped}/v1"