@nimba/cli

The command line for Nimba — modern Salesforce DevOps orchestration in TypeScript. Connect an org, load layered nimba.yml config, and run tasks and flows locally or in CI.

Nimba targets the same problem space as legacy Python Salesforce tooling — metadata deploys, org setup, dependency management, CI, and releases — with a modern TypeScript stack. nimba.yml is a compatible superset of cumulusci.yml.

Install

npm install -g @nimba/cli

Quick start

# Scaffold a nimba.yml (or migrate an existing cumulusci.yml)
nimba init                       # add --from-cumulusci to import cumulusci.yml

# Authorize an org
nimba org login --org dev        # interactive web; or JWT / auth-url for CI

# Inspect and run
nimba flow list
nimba flow info dev_org
nimba flow run dev_org --org dev

nimba task list
nimba task run deploy --org dev

Commands

nimba init [--yes] [--force] [--from-cumulusci]
nimba flow list | info <flow> | run <flow> [--org <alias>]
nimba task list | run <task> [--org <alias>]
nimba deploy   [--org <alias>] --path <dir>
nimba retrieve --org <alias> --metadata <type:name>
nimba org login  --org <alias>   [--jwt-key-file --client-id --username | --auth-url | web]
nimba org create <alias> | list | delete <alias>

How it works

The CLI is a thin client over @nimba/runtime — the same engine the MCP and HTTP servers drive — so flows behave identically everywhere.

Requirements

• Node.js >= 22.19

Links

• Nimba on GitHub