Install

Requirements

• Node.js 22 or newer. Check with node --version.
• npm (bundled with Node) or an equivalent registry client (pnpm, yarn).

Global install (recommended)

npm install -g @celigo/celigo-cli
celigo --version

This puts the celigo binary on your PATH. On macOS/Linux the npm global prefix is typically /usr/local/bin; on Windows it's under %AppData%\npm\celigo.cmd.

One-off invocation without install

npx --yes @celigo/celigo-cli --version

Useful in CI when you want to pin a specific version in a workflow file.

Upgrading

npm install -g @celigo/celigo-cli@latest

The CLI checks npm for a newer version every four hours on startup and auto-installs it unless suppressed. Skip the check with CELIGO_NO_UPDATE=1. CI environments are detected (CI, GITHUB_ACTIONS, GITLAB_CI, JENKINS_URL, CIRCLECI, BUILDKITE, …) and the check is skipped automatically.

Uninstalling

⚠️ rm -rf ~/.celigo is irreversible. It permanently deletes your saved profiles, tokens, config, and the account index. Omit it if you plan to reinstall the CLI later.

npm uninstall -g @celigo/celigo-cli
rm -rf ~/.celigo     # removes profiles, config, and the account index

Verifying the install

$ celigo --version
2026.6.1

$ celigo --help
Usage: celigo [options] [command]

Options:
  -v, --version        output the version number
  --token <token>      API bearer token (prefer CELIGO_API_TOKEN env var to
                       avoid exposing in process list).
  --base-url <url>     API base URL.
  --format <format>    Output format (json or table). Defaults to config or
                       json.
  --jq <expr>          Transform JSON output with a jq expression.
  --verbose            Show HTTP requests.
  --profile <name>     Use a named config profile instead of the active profile.
  -h, --help           display help for command

Commands:
  config     Manage CLI configuration.
  profile    Manage named config profiles
  account    Account-wide operations: snapshot, search, dependencies, lint, stats
  flows      Manage flows
  connections, exports, imports, integrations, scripts, …

If celigo isn't found after install, make sure the npm global bin directory is on your PATH:

npm bin -g    # prints the directory

Add that path to your shell rc file (~/.zshrc, ~/.bashrc, or PowerShell $PROFILE).

Releases & versioning

The CLI uses calendar versioning (e.g. 2026.6.1 = 2026-06, patch 1). Release notes and tarballs live on the npm package page.