Troubleshooting
Resolve common installation, authentication and file permission issues.
The celo command was not found
Terminal
node --version
npm --version
npm list -g @celoiaio/cli
npm prefix -gReopen the terminal after installation. If the package is installed, check that the npm global executable directory is on your PATH. Its location depends on your operating system and Node.js installation.
Login expired or key revoked
Terminal
celo login
celo whoamiUse the newly displayed device code, not an expired one. If access is denied after approval, check your account permissions, plan, network connection, proxy and firewall.
Celo did not overwrite a file
Check that you approved the write. One-off mode requires --yes for overwriting; prefer interactive mode to review each request. Verify the current folder and operating system permissions. Paths outside the working folder are rejected.
Environment variables
CELO_API_BASE overrides the saved API endpoint. CELO_NO_BROWSER disables automatic browser opening. NO_COLOR disables colored terminal output. Only use trusted API endpoints: your key and conversation context may be sent there.
Need help?
Include the Celo version, operating system, Node.js version and error message. Remove keys, tokens, personal data and private project content first.