Platform Developers Docs API Network Security Roadmap Contact
v1.4 - stable

The IVO CLI.

Scaffold a node, tail webhooks, replay events, run the sandbox locally - all without leaving your terminal.

Install

Pick your package manager.

install
# npm
npm install -g @ivo/cli

# Homebrew
brew install ivo-cli/tap/ivo

# curl (Linux/macOS)
curl -fsSL https://get.ivo.cy | sh

# verify
ivo --version
# => ivo/1.4.2 darwin-arm64 node-20.10.0
First run prompts you to log in via the browser. The CLI stores a refresh token in your OS keychain - never on disk in plaintext.
Commands

The 12 things you'll use most.

ivo login

Browser-based OAuth flow. Stores a refresh token in the OS keychain.

ivo init

Scaffold a new node project, addon, or SDK consumer in seconds.

ivo tasks list

Filter by status, project, worker. Pipe to jq, grep, anything.

ivo tasks create

Create a task from a YAML file or inline flags. Funds escrow on the spot.

ivo webhooks tail

Live webhook stream to your terminal - perfect for local dev.

ivo webhooks replay

Replay any past event by ID. Useful when your handler crashed.

ivo node start

Boot a local IVO node against the sandbox federation. Hot-reloads.

ivo node deploy

Push your node config + addon code to your live WHMCS install.

ivo wallet

Read balances, list payouts, initiate a withdrawal interactively.

ivo logs

Tail server-side logs scoped to your node, filtered by event type.

ivo openapi

Pull the latest OpenAPI spec, validate against your handler shapes.

ivo doctor

Self-diagnostic - keychain access, network, API health, schema drift.

Cheatsheet

From zero to your first task.

terminal
# 1. log in (opens browser)
$ ivo login

# 2. switch to the sandbox environment
$ ivo env use sandbox

# 3. create a project from a yaml file
$ ivo projects create --file demo.yaml

# 4. post your first task
$ ivo tasks create \
    --project prj_demo \
    --title "Translate landing page to Greek" \
    --budget 120 --currency EUR

# 5. tail webhooks while you build your handler
$ ivo webhooks tail --types task.*

Full reference at /api-docs. Source on GitHub. File issues there or via contact.