Repository navigation
v2.0.0 β Docker + Reactive Cookie Architecture
π v2.0.0 β Docker/OrbStack + Reactive Cookie Sync
π³ Docker / OrbStack
- Fully self-contained Docker image (no host folder mounts)
- Multi-stage Alpine build (~25MB final image)
restart: unless-stoppedβ auto-starts on Mac reboot- Ports
8001(API) and9226(WebSocket cookie bridge)
π Reactive Cookie Architecture
- Only-On-Expiry sync β zero proactive polling
ExecuteWithFailover()triggers cookie refresh on401 Unauthorized- Passive 30-minute health logger
- Dual resilience: WebSocket primary +
POST /api/sync-cookiesHTTP fallback
π§© Chrome Extension
- π Copy Cookies button with clipboard animation
- Host permissions for
127.0.0.1&localhost(Docker-compatible) - Real-time passive cookie listener on Google session token rotation
β‘ Performance & Stability
- QUIC timeout:
60s β 10sfor fast fallback - Fixed
401bug from duplicate Cookie header in HTTP/2 (tls-clientCookieJar conflict) - CORS middleware added for extension
fetch()compatibility - BPE tokenizer (cl100k_base) β 99.5% token accuracy
- Dual analytics export: Excel (
.xlsx) + JSON auto-generated on every request
π¦ Cookie Lifetime (Real Test Data)
| Metric | Result |
|---|---|
| Unbroken session | 1h 24m 30s (76 requests, 100% pass) |
| Total tested lifespan | 2h 05m 47s (99 queries) |
| Expiry signal | HTTP 401 on StreamGenerate |
| Recovery | Automatic via extension WebSocket push |
Full documentation: README.md