CLI overview - Engini Developer Docs

The engini CLI is machine-first: human-readable output on a TTY, JSON when piped or with --json, stable exit codes, and agent-resumable flows.

npm install -g @engini/cli

The CLI ships on npm only - pip install engini is the Python SDK and includes no CLI.

Upgrading

npm install -g @engini/cli@latest   # stable
npm install -g @engini/cli@beta     # pre-release channel
engini --version                    # confirm what's installed

On an interactive terminal, the CLI checks once a day whether a newer release is available on your current channel (stable or beta - a beta install compares against beta, never against latest) and prints a one-line notice to stderr after the command’s own output:

Update available: 0.12.0 -> 0.13.0   Run: npm install -g @engini/cli@latest

This check never runs under --json, --quiet, in CI (CI set), or when output is piped - only a human at a terminal sees it. Set ENGINI_NO_UPDATE_CHECK=1 - or the conventional NO_UPDATE_NOTIFIER=1 - to disable it entirely.

Commands at a glance

engini login | logout | whoami            # auth
engini tools list | get | call | result   # discover, execute & drill into results
engini applications list | get            # browse connector apps
engini connect [<app>]                    # create a connection (interactive / agent-resumable)
engini connections list | get             # inspect connections
engini connections create | delete | check | refresh | objects | select-objects   # primitives
engini connections sign-in-url | oauth-complete   # OAuth2 start / finish primitives
engini toolsets list | get | create | update | delete   # scope what an agent may call
engini mcp list | get | activate | deactivate           # the MCP servers your account exposes
engini mcp connections add|rm | tools list|set | workflows add|rm   # configure one
engini triggers types | list | get | create | enable | disable | delete   # fire on a change
engini triggers events | events get | events replay | listen              # what fired
engini triggers destinations set|add|list|show|enable|rm|rotate-secret    # where it is delivered

Quickstart

engini login --api-key eng_…              # or bare `engini login` to paste it interactively
engini applications list --available      # discover connector apps
engini tools list --application monday    # discover tools
engini connect monday                     # create a connection (guided)
engini tools call monday_create_item --args '{}' --connection 3
engini tools call gmail_send_mail --args '{}' --file attachmentsarray=@report.pdf
engini tools result <handle> --select items.email   # drill into a large result

Universal flags

Every command accepts:

Flag	Effect
`--json`	Pretty JSON output (JSON is also automatic when output is piped)
`--quiet`	Suppress non-essential output
`--schema`	Print the command’s argument/output schema as JSON - agents introspect instead of parsing help text
`--dry-run`	On mutating commands: preview what would happen without executing

Authentication & configuration

Two ways to authenticate:

engini login --api-key eng_… - stores the credential in a 0600 TOML config file (~/.config/engini/config.toml; %APPDATA%\engini\config.toml on Windows), alongside api_url (default https://api.engini.io).
Environment variables - ENGINI_API_KEY (preferred) or ENGINI_API_TOKEN; no login needed. Useful for CI and agents.

Verify with engini whoami (exit code 3 means the credential is missing/invalid). Point at another environment with engini login --api-url <url>. What the two credential types mean: Authentication.

Errors & big results

Failures print a structured JSON error (with a hint where applicable) and exit with a stable code - 2 usage, 3 auth, 4 not found, 5 needs-input, 124 timeout. Full table: machine contract.
API rate limiting surfaces as an error - honor Retry-After per the rate-limit rules.
List commands return complete results (pagination is handled for you). Large tool outputs become a result handle - drill in with engini tools result <handle> instead of re-fetching.

Full per-command reference: CLI commands.

​Upgrading

​Commands at a glance

​Quickstart

​Universal flags

​Authentication & configuration

​Errors & big results

Upgrading

Commands at a glance

Quickstart

Universal flags

Authentication & configuration

Errors & big results