Introduction
sotatek-proxy is a lightweight daemon that runs transparently on your workstation, bridging AI CLI tools (Claude Code, claude-cli, etc.) to the Sotatek Bifrost gateway while enriching every request with process and git attribution metadata.
Why sotatek-proxy?
Section titled “Why sotatek-proxy?”Without the proxy, AI CLI requests to Bifrost carry no local context — there is no way to know which developer sent a request, or which repository the work originates from.
sotatek-proxy solves this silently, with no changes required to your CLI workflow:
- Intercepts requests on the loopback interface (
127.0.0.1:3817) - Resolves the calling process’s working directory
- Discovers the nearest
.git/and extractsgit remote -v - Injects the
X-Git-Remoteheader (base64-encoded) before forwarding to Bifrost - Streams the response back to your CLI in real time
Key features
Section titled “Key features”| Feature | Details |
|---|---|
| Loopback-only | Binds 127.0.0.1:3817 — never exposed to LAN |
| SSE / streaming | Per-chunk flush, no buffering — instant token streaming |
| Git attribution | X-Git-Remote injected on every request |
| TTL cache | PID → git-remote cache, TOCTOU-safe CWD re-verification |
| Cross-platform | macOS (arm64 / amd64), Linux (amd64 / arm64), Windows (amd64) |
| Daemon-managed | launchd · systemd · Windows SCM — auto-starts on login / boot |
| Secure | Auth headers never logged; client cannot spoof attribution headers |
Get started
Section titled “Get started” Install on macOS launchd user agent, no admin required
Install on Linux systemd user unit, optional boot-time auto-start
Install on Windows Windows Service under LocalSystem, admin required
After installing, follow Configure your CLI to point Claude Code at the proxy.