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.
$ 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.
$ 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.
> 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.
$ 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
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.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.~/.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
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.
$ 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.
$ bun remove -g codeoutcli # or $ npm uninstall -g codeoutcli