Overview

The xpander CLI is your command-line for managing agents and scaffolding and running local projects. It covers three areas:

Area	What it does
Control plane	Create, edit, delete, invoke agents in the cloud.
Local development	Scaffold framework templates and run agents locally.
NeMo sync	Pull/push agent model configuration to/from local NeMo config.

Install

Requirements: Node.js 20+, Python 3.12+.

npm install -g xpander-cli

Verify the install:

xpander --version

Authenticate (opens a browser):

xpander login

Or set credentials manually:

xpander configure

Credentials are stored at ~/.xpander/credentials and scoped per profile (default profile is default).

First command

xpander agent new

The wizard prompts for a name, creates the agent in your org, and offers to load the framework template into the current directory.

Global options

These apply to every command (and to xpander itself):

Flag	Description
`-v, --version`	Print the CLI version and exit.
`--output <format>`	Output format: `json` or `table`. Defaults to `table`.
`--profile <n>`	Profile to use. Falls back to the active profile.
`--api-key <key>`	Override the active profile’s API key for this command.
`-y, --yes`	Auto-answer “yes” to every prompt (non-interactive mode).
`--no-interactive`	Disable interactive prompts. Commands fail if a required input is missing rather than prompting.
`-h, --help`	Print help for the current command.

Top-level commands

Command	Alias	Purpose
`xpander configure`	`c`	Set up API credentials.
`xpander login`	`l`	Authenticate via browser.
`xpander profile`	–	Manage profiles.
`xpander agent`	`a`	Manage agents (full namespace: see Agent Commands).
`xpander initialize [agent]`	`i`	Shortcut for `agent init`.
`xpander dev [agent]`	–	Shortcut for `agent dev`.
`xpander invoke [agent] [msg]`	–	Shortcut for `agent invoke`.
`xpander nemo`	–	Sync agent model config with local NeMo config (`pull` / `push`).
`xpander help [command]`	–	Print help for a command.

Most lifecycle commands exist both as top-level shortcuts (xpander dev) and inside the agent namespace (xpander agent dev). Both forms are documented in Agent Commands.

Where to next

Agent Commands

Every command under xpander agent: control plane, local dev, graph, tools, NeMo.

Auth & Config

login, configure, profile.

Shortcuts

x a n, x a d, and friends.

Platform

Getting Started

Building Agents

Workflows

Agentic Automation

Observability

Deployment Channels

Self-Hosted

Security & Compliance

Building In-Product Agents

Overview

Install

First command

Global options

Top-level commands

Where to next

Agent Commands

Auth & Config

Shortcuts

​Install

​First command

​Global options

​Top-level commands

​Where to next

Agent Commands

Auth & Config

Shortcuts

Install

First command

Global options

Top-level commands

Where to next