Install

codeout is one global package. Install it once, and the codeout command runs the daemon from any project directory.

Install

codeout runs natively on macOS, Linux, and Windows, no WSL, no cloud. Pick your platform.

terminal
$ curl -fsSL https://codeout.dev/install.sh | bash

One command: installs bun and codeout, and asks which agent CLIs you want (Claude Code, Codex, Gemini: one Y/n each, only for ones you don't have). cloudflared (the tunnel) is fetched automatically on first run; dtach (optional, terminal-session persistence) is added if Homebrew is present. By hand instead? bun install -g codeoutcli, then sign in to the agents you use.

terminal
$ curl -fsSL https://codeout.dev/install.sh | bash

One command: installs bun and codeout, and asks which agent CLIs you want (Claude Code, Codex, Gemini: one Y/n each, only for ones you don't have). cloudflared (the tunnel) is fetched automatically on first run; dtach (optional, terminal-session persistence) is added via your package manager if present. By hand instead? bun install -g codeoutcli, then sign in to the agents you use.

PowerShell
> irm https://codeout.dev/install.ps1 | iex

One line, run in PowerShell. It installs Node, cloudflared, and the codeout CLI, and asks which agent CLIs you want (Claude Code, Codex, Gemini: one Y/n each, only for ones you don't have). Native Windows, no dtach, no WSL. Sign in to the agents you use, then run codeout.

That is the whole installation. There is no separate server to provision, no database, and no config file you must write before the first run. The daemon picks sensible defaults and prints what it is doing.

Verify the install

Confirm the command is on your path.

terminal
$ codeout --help
codeout - your AI coding agents, self-hosted, in your pocket

If your shell cannot find the command, your global bin directory is probably not on your PATH. Check your package manager's documentation for where it puts global binaries, then add that directory to your shell profile.

Requirements

runtime
Bun, or Node 20+. cloudflared (the public tunnel) is fetched automatically on first run, nothing to install. dtach is optional on macOS/Linux: with it, terminal sessions survive a daemon restart; without it (and always on Windows, which uses ConPTY) they don't. The native pty ships prebuilt, so there is no compile step.
os
macOS, Linux, and Windows, natively. On Windows, terminal sessions survive a client disconnect but not a daemon restart (no detached master); chat sessions resume either way.
agent
at least one supported agent: claude, codex, gemini / agy, or an OpenRouter direct API key. Install any mix; whatever is configured shows up in the session picker. A plain shell needs nothing extra.
device
any phone, tablet, or laptop with a modern browser, or the native iOS app from the App Store. A camera is handy for the QR scan but not required; you can pair with a typed code instead.
network
internet access for the default public tunnel. To run offline or on a local network only, see Remote access.
config
the daemon keeps a secure local config under ~/.codeout (mode 0600). Provider credentials, allowlists, and master password can be managed in the Host Control Deck on http://localhost:8400/. Chat uploads land in ~/.codeout/uploads by default.

About your agents & providers

Server-Authoritative Control

codeout supports both CLI-based agents (claude, codex, gemini) and direct API providers (openrouter with built-in tool execution). Your credentials, OAuth logins, and API keys stay securely encrypted on your daemon host and are never transmitted to client devices.

The practical upshot: if claude, codex, gemini, or OpenRouter works on your machine today, it works in a codeout session today, with the same model, the same project context, and the same login. codeout is the window, not the agent.

Updating

Reinstall to upgrade. Running sessions are tied to the daemon process, so finish or detach from them and stop the daemon first, otherwise the upgrade waits for the next restart to take effect.

terminal
$ bun install -g codeoutcli@latest
# or
$ npm install -g codeoutcli@latest

Pinned to a version on purpose? Swap @latest for the exact version you want. The next time you run codeout, the new build is what starts.

Uninstalling

Remove the global package and the command is gone. codeout keeps nothing outside its package and your small local config, so there is nothing else to clean up.

terminal
$ bun remove -g codeoutcli
# or
$ npm uninstall -g codeoutcli