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

empryo addon install proxy
empryo                # then inside the TUI:
/proxy login             # add a Claude / GPT / Gemini / Grok subscription
/proxy status            # see active accounts

See the Proxy provider entry for how the relay shows up in /models.