CeloIA · Documentation

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 -g

Reopen 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 whoami

Use 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.

Contact CeloIA