Installation and access

Prepare your environment, authorize your terminal and keep Celo CLI up to date.

Environment requirements

Use Node.js 18.17 or later and npm. A supported LTS release is recommended. API access requires an internet connection and an authorized account.

Terminal

node --version
npm --version

Install or update

Terminal

npm install -g @celoiaio/cli@latest
celo --version

For npm permission errors, prefer a Node.js version manager or a user-owned global npm directory. Do not blindly run installation commands as administrator.

Authorize your terminal

Terminal

celo login
celo whoami

Approve the device code in your browser. The terminal receives an API key. whoami shows your account, plan, balance and available model count. Manage or revoke the terminal key in Settings › OpenCode / API.

Login over SSH

Disable automatic browser opening and visit the displayed URL on a trusted device.

Terminal

CELO_NO_BROWSER=1 celo login

Windows PowerShell

$env:CELO_NO_BROWSER = "1"
celo login
Remove-Item Env:CELO_NO_BROWSER

Sign out or uninstall

Terminal

celo logout

Signing out is not key revocation. Revoke the key in your account if you need to invalidate it.

Terminal

npm uninstall -g @celoiaio/cli

Uninstalling does not automatically delete local history in ~/.celo/sessions. Review it separately when retiring a computer.