Install

curl -fsSL https://empryo.com/install.sh | bash

The one-liner detects your platform/arch, downloads the matching build from dl.empryo.com, and verifies its SHA-256 against the release checksums before anything runs. Neovim and a Nerd Font are auto-installed on first launch.

Prefer a desktop app? Grab the .dmg (macOS) or .AppImage (Linux) from the download page.

Distribution is binary-first — there is no npm install for the CLI. The @empryo/* packages on npm are the developer SDK, not the agent itself.

Windows notes

Empryo stores config + data under %LOCALAPPDATA%\Empryo. Secrets are DPAPI-encrypted (crypt32.dll, user-scoped).

A couple of features are off by default on Windows:

Embedded floating terminal panel - disabled (ghostty-opentui native addon has no stable win32 build). Override with EMPRYO_ENABLE_GHOSTTY=1 if you've patched it locally.
Kitty graphics image preview - disabled (Windows Terminal + ConPTY don't speak the protocol). Half-block art still works.
glob tool find fallback - install fd (winget install sharkdp.fd) for full glob support.

Everything else - all 22 providers, every tool, LSP, Genome, sessions, checkpoints, memory, MCP, themes, headless mode - works identically across macOS, Linux, and Windows.

Add a key

You need at least one LLM provider key. Pick one path:

LLM Gateway - one key for Claude, GPT, Gemini, Grok, Llama, Qwen, and others. Up to 30% off frontier models.

empryo --set-key llmgateway sk-...

Keys are stored in your OS keychain: macOS Keychain, Linux secret-tool (libsecret), Windows DPAPI (crypt32.dll, user-scoped, at %LOCALAPPDATA%\Empryo\secrets.dat). You can also export ANTHROPIC_API_KEY=... in your shell profile.

See all 22 providers →

Launch

empryo

Press Ctrl+L to switch models. Type /help for commands.

Next: Quickstart

Five minutes to your first refactor.

→