Merge pull request #1 from nangsontay/feat/setting-panel

Feat/setting panel

Author: nangsontay

headroom/cli/main.py

@@ -32,6 +32,19 @@ def main(ctx: click.Context) -> None:
     """
     ctx.ensure_object(dict)
 
+    # Apply file-backed settings (settings.json) to the process environment
+    # BEFORE Click parses any subcommand's ``envvar=`` options (Click resolves
+    # those when it builds the subcommand context, which happens after this
+    # group callback runs). ``os.environ.setdefault`` keeps explicit shell
+    # exports authoritative over the stored file. Fail-open so a corrupt
+    # settings.json can never block the CLI.
+    try:
+        from headroom import settings_store
+
+        settings_store.apply_to_environ(settings_store.load())
+    except Exception:  # noqa: BLE001 — settings load must never break the CLI
+        pass
+
     # Fire a rate-limited, opt-out background check for newer releases so other
     # surfaces (e.g. the proxy banner) can show an "update available" notice.
     # Never blocks, never raises; skipped for `update` (it checks explicitly).

headroom/cli/proxy.py

@@ -9,7 +9,11 @@
 import click
 
 from headroom import paths as _paths
-from headroom.providers.registry import resolve_api_overrides, resolve_api_targets
+from headroom.providers.registry import (
+    resolve_api_overrides,
+    resolve_api_targets,
+    resolve_extra_headers,
+)
 from headroom.proxy.modes import PROXY_MODE_CACHE, normalize_proxy_mode
 
 from .main import main
@@ -872,6 +876,22 @@ def dashboard(port: int, no_open: bool) -> None:
     "Default: /tmp/headroom-embed-{port}.sock. "
     "(env: HEADROOM_EMBEDDING_SERVER_SOCKET)",
 )
+@click.option(
+    "--anthropic-extra-headers",
+    default=None,
+    help=(
+        "JSON object of extra headers merged into (and overriding) headers forwarded to "
+        'the Anthropic endpoint, e.g. \'{"Api-Key": "..."}\' (env: ANTHROPIC_TARGET_API_HEADERS)'
+    ),
+)
+@click.option(
+    "--openai-extra-headers",
+    default=None,
+    help=(
+        "JSON object of extra headers merged into (and overriding) headers forwarded to "
+        "the OpenAI endpoint (env: OPENAI_TARGET_API_HEADERS)"
+    ),
+)
 @click.pass_context
 def proxy(
     ctx: click.Context,
@@ -943,6 +963,8 @@ def proxy(
     backend: str,
     anyllm_provider: str,
     anthropic_api_url: str | None,
+    anthropic_extra_headers: str | None,
+    openai_extra_headers: str | None,
     openai_api_url: str | None,
     gemini_api_url: str | None,
     cloudcode_api_url: str | None,
@@ -1047,6 +1069,17 @@ def proxy(
             sys.exit(1)
         os.environ["HEADROOM_INTERCEPT_ENABLED"] = "1"
 
+    try:
+        resolved_anthropic_extra_headers = resolve_extra_headers(
+            anthropic_extra_headers, "ANTHROPIC_TARGET_API_HEADERS"
+        )
+        resolved_openai_extra_headers = resolve_extra_headers(
+            openai_extra_headers, "OPENAI_TARGET_API_HEADERS"
+        )
+    except ValueError as exc:
+        click.secho(f"error: {exc}", fg="red", err=True)
+        sys.exit(1)
+
     provider_api_overrides = resolve_api_overrides(
         anthropic_api_url=anthropic_api_url,
         openai_api_url=openai_api_url,
@@ -1110,6 +1143,8 @@ def proxy(
         host=host,
         port=port,
         anthropic_api_url=provider_api_overrides.anthropic,
+        anthropic_extra_headers=resolved_anthropic_extra_headers,
+        openai_extra_headers=resolved_openai_extra_headers,
         openai_api_url=provider_api_overrides.openai,
         gemini_api_url=provider_api_overrides.gemini,
         cloudcode_api_url=provider_api_overrides.cloudcode,

headroom/dashboard/__init__.py

@@ -10,3 +10,9 @@ def get_dashboard_html() -> str:
     """Load the dashboard HTML template."""
     template_path = TEMPLATES_DIR / "dashboard.html"
     return template_path.read_text(encoding="utf-8")
+
+
+def get_settings_html() -> str:
+    """Load the settings GUI HTML template."""
+    template_path = TEMPLATES_DIR / "settings.html"
+    return template_path.read_text(encoding="utf-8")

headroom/dashboard/templates/dashboard.html

@@ -159,6 +159,11 @@ <h1 class="text-xl font-semibold tracking-tight">HEADROOM</h1>
             <div class="text-xs text-gray-500">
                 Updated <span x-text="lastUpdate"></span>
             </div>
+            <a href="/dashboard/settings" id="settings-link"
+               class="px-3 py-1.5 text-sm rounded-md border border-border bg-surface text-gray-400 hover:text-gray-200 transition-colors"
+               title="Settings">
+                &#9881; Settings
+            </a>
             <button onclick="toggleTheme()" id="theme-toggle"
                     class="px-3 py-1.5 text-sm rounded-md border border-border bg-surface text-gray-400 hover:text-gray-200 transition-colors"
                     title="Toggle light/dark mode">