openproxylisted

# openproxy — install & operate from the CLI [OpenProxy](https://github.com/quangdang46/openproxy) is a single-binary AI router that exposes an OpenAI-compatible API on `127.0.0.1:4623` and fans out to 40+ providers with auto-fallback. This skill walks an agent through: 1. Installing or upgrading the `openproxy` binary 2. Initializing a data dir and capturing the admin API key 3. Starting the server **detached + headless** and verifying it 4. Configuring providers / keys / pools declaratively via `apply` 5. Wiring an AI coding CLI into the proxy Every step is non-interactive and safe to run unattended. ## 0 · Detect what's already installed Always inspect state before mutating anything: ```bash command -v openproxy && openproxy --version || echo "not installed" test -f "$HOME/.openproxy/db.json" && echo "data dir already provisioned" || true ``` If a binary is already on PATH, jump to step 2. Run `openproxy doctor` early — it catches half-installed states. ## 1 · Install the binary Two equivalent install paths. Pick whichever is least invasive in the current environment. ### 1a. One-shot curl installer (recommended for Linux / macOS, x86_64 + aarch64) ```bash curl -fsSL "https://raw.githubusercontent.com/quangdang46/openproxy/main/install.sh" | bash export PATH="$HOME/.local/bin:$PATH" ``` Drops the binary at `~/.local/bin/openproxy`. Idempotent (locked via `/tmp/openproxy-install.lock.d`). Useful flags: | Flag | Effect | |---|---| | `--version vX.Y.Z` | Pin a sp