Skip to content
dopejs
← All projects

GoZen

Released

Multi-CLI environment switcher with API proxy auto-failover.

Switch environments across Claude Code, Codex and OpenCode from one place, and keep working when an upstream provider degrades — GoZen proxies API traffic and fails over automatically.

Overview

All API configuration lives in `~/.zen/zen.json`, and a single `zend` daemon hosts both the proxy server and a password-protected web UI. Directories can be bound to a specific profile and CLI, so `zen` in a project folder launches the right client against the right provider without flags.

The proxy is the reason to run it: requests are routed by characteristics such as thinking, image and long-context, and fall over to backup providers when the primary is unavailable. Version 3 adds token/cost tracking per provider, model and project, budget limits with warn/downgrade/block actions, provider health checks, several load-balancing strategies, and webhook notifications.

Config can be synced across devices through WebDAV, S3, a GitHub Gist or a GitHub repository, encrypted with AES-256-GCM. Web UI tokens are transported with RSA encryption behind session-based auth.

What it does

  • One switcher for Claude Code, Codex and OpenCode, configurable per project through directory bindings.
  • Built-in HTTP proxy with automatic failover to backup providers, plus scenario routing (thinking, image, long context).
  • Usage and cost tracking per provider, model and project, with daily/weekly/monthly budget limits.
  • Provider health monitoring with latency and error-rate tracking; failover, round-robin, least-latency and least-cost balancing.
  • Encrypted config sync over WebDAV, S3, GitHub Gist or GitHub repo (AES-256-GCM).
  • Bot gateway to monitor and control Claude Code sessions from Telegram, Discord, Slack, Lark or Messenger.
  • Self-update via `zen upgrade`, plus zsh / bash / fish completion.

Get started

Install

curl -fsSL https://raw.githubusercontent.com/dopejs/gozen/main/install.sh | sh

First run

zen config add provider && zen