codaid CLI
Install the codaid command-line client and daemon on Linux, macOS or Windows, sign in, update it, and verify what you downloaded.
codaid is one binary with two jobs: a command-line client for your codai account (chat, sessions, schedules, Resolve, keys, usage) and the daemon that turns a machine into a bring-your-own environment.
Install
curl -fsSL https://codai.ro/install-codaid.sh | shBoth installers download the build for your system from the GitHub release and check it against the release's SHA256SUMS before installing anything. They fail closed: if the release publishes no checksum, if no SHA-256 tool is available, or if the hash differs, they stop with an error and leave nothing behind. When the GitHub CLI (gh) is installed they also check the build provenance; set CODAID_REQUIRE_ATTESTATION=1 to make that check mandatory.
| Linux / macOS | Windows | |
|---|---|---|
| Installs to | /usr/local/bin/codaid (INSTALL_DIR) | %LOCALAPPDATA%\codai\bin\codaid.exe, added to your user PATH |
| Pin a version | VERSION=0.4.2 sh | $env:CODAID_VERSION='0.4.2' before irm |
| Needs | curl or wget, sha256sum or shasum | PowerShell 5.1 or 7 |
macOS builds are not published yet; on a Mac the installer stops with a download error until they are.
The same scripts are attached to every release as install.sh and install.ps1. To check a download by hand, see verify downloads.
Sign in
codaid login # device-code sign-in in the browser; stores a codai_ key
codaid whoami # the account the stored key belongs to
codaid logout # forget the stored key (revoke it in the hub to invalidate it)login opens auth.codai.ro/device with the code filled in. On a server without a browser, open that address on any device and type the code shown in the terminal. Set CODAI_API_KEY=codai_… instead to skip the sign-in (CI, fleets).
Update
Run the installer again; it replaces the binary with the latest release (or the pinned VERSION). Check the result with:
codaid versionOn Windows, stop a running codaid run first: an open codaid.exe cannot be replaced.
Everyday commands
| Command | What it does |
|---|---|
codaid chat "…" | One streamed chat turn with codai |
codaid sessions list | Your conversation sessions |
codaid usage | Usage breakdown for your account |
codaid keys list | Your API keys (prefix only, never the secret) |
codaid resolve --help | Submit an issue to Resolve and wait for the verified fix |
codaid env --help | Create, list and attach to environments |
codaid status | Daemon configuration (key redacted) and local probes |
Every command has --help. To run the machine as an environment, continue with install on your own server.