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 - 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 subscription limits.	~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.

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

CLI

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:

{
  "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

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 subscription limits.

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

See the Proxy provider entry for how the relay shows up in /models, and Subscription limits for reading the quota meters — including the per-model weekly caps Claude applies on top of the account-wide ones.