<!-- Markdown mirror. Canonical: https://empryo.com/docs/tools/addons -->

# Addons

> Install Empryo's optional addons, CLIProxyAPI for subscription-based LLM routing and a bundled Neovim, on demand from the CLI with PATH-aware management.

Addons are opt-in components that ship outside the main binary. They're downloaded the first time you ask for them, recorded in your global config, and managed entirely from the CLI.

Two addons today:

| Addon | What it gets you | Approx size |
|-------|------------------|-------------|
| `proxy` | [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) - local LLM relay that lets you route Claude, GPT, Gemini, and Grok through your existing chat subscriptions instead of API keys. Use at your own risk - see [Proxy](/docs/providers/proxy). | ~25 MB |
| `neovim` | Bundled Neovim binary for the embedded editor panel, when you don't want to install Neovim system-wide. | ~15 MB |

Neither is required. The default install ships neither.

## First-run wizard

On first launch in a TTY, Empryo offers to install both. Skip and re-run later - your choice is remembered.

```bash
# Skip the prompt in CI / non-interactive shells
EMPRYO_NO_PROMPT=1 empryo
```

## CLI

```bash
empryo addon list                       # show state (installed / version / path)
empryo addon install proxy              # install the proxy addon
empryo addon install neovim             # install bundled neovim
empryo addon remove proxy               # uninstall (leaves system PATH copies alone)
empryo addon update neovim              # reinstall latest
empryo addon --help                     # full usage
```

Both positional (`empryo addon …`) and flag (`empryo --addon …`) forms work. `list`, `ls`, `--list`, `-l` are all equivalent.

## Install locations

| Path | What |
|------|------|
| `~/.empryo/bin/cli-proxy-api` | proxy binary symlink (Windows: `.exe` under `%LOCALAPPDATA%\Empryo\bin`) |
| `~/.empryo/bin/nvim` | neovim binary symlink |
| `~/.empryo/installs/cliproxyapi-<version>/` | versioned proxy install |
| `~/.empryo/installs/nvim-<version>/` | versioned neovim install |

Install records live under `addons` in `~/.empryo/config.json`:

```json
{
  "addons": {
    "proxy":  { "installed": true, "version": "1.4.2", "installedAt": "2025-01-15T12:00:00Z" },
    "neovim": { "installed": true, "installedAt": "2025-01-15T12:00:00Z" }
  }
}
```

## System binaries

If `cli-proxy-api` or `nvim` is already on your `PATH` (Homebrew, apt, scoop, etc.), Empryo picks it up automatically - you don't need the addon at all. `addon install` will still vendor a separate copy under `~/.empryo/bin` to insulate against PATH changes, `addon remove` only removes what empryo vendored, never your system install.

## Environment variables

| Variable | Purpose |
|----------|---------|
| `EMPRYO_AUTO_INSTALL_ADDONS` | Comma-separated list to install automatically (`proxy,neovim`). |
| `EMPRYO_PROXY_VERSION` | Pin a specific CLIProxyAPI version on install. |
| `EMPRYO_NO_PROMPT` | Set to `1` to skip the first-run addon wizard. |

## Proxy quickstart

> **Warning:**
> **Use at your own risk.** The relay presents your consumer subscription credentials to endpoints built for the vendor's own apps. Empryo is not affiliated with Anthropic, OpenAI, Google or xAI, and whether your plan permits this is between you and your provider. Rate limiting, revoked credentials or account suspension are possible outcomes. Details in [Proxy](/docs/providers/proxy).

```bash
empryo addon install proxy
empryo                # then inside the TUI:
/proxy login     # add a Claude / GPT / Gemini / Grok subscription
/proxy status    # see active accounts
/proxy quota     # how much of each plan is left
                         # (/proxy still works — it is the old name)
```

See the [Proxy provider](/docs/providers/overview#enterprise) entry for how the relay shows up in `/models`, and [Proxy](/docs/providers/proxy) for reading the quota meters, including the per-model weekly caps Claude applies on top of the account-wide ones.