The xpander CLI is your command-line for managing agents, scaffolding local projects, and deploying containers to xpander.ai’s cloud. It covers four areas:Documentation Index
Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt
Use this file to discover all available pages before exploring further.
| Area | What it does |
|---|---|
| Control plane | Create, edit, delete, invoke agents in the cloud. |
| Local development | Scaffold framework templates and run agents locally. |
| Cloud deployment | Build and deploy Docker containers, stream logs, restart, stop. |
| NeMo sync | Pull/push agent model configuration to/from local NeMo config. |
Install
Requirements: Node.js 20+, Python 3.12+.~/.xpander/credentials and scoped per profile (default profile is default).
First command
Global options
These apply to every command (and toxpander 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 deploy [agent] | d | Shortcut for agent deploy. |
xpander restart [agent] | – | Shortcut for agent restart. |
xpander stop [agent] | – | Shortcut for agent stop. |
xpander initialize [agent] | i | Shortcut for agent init. |
xpander dev [agent] | – | Shortcut for agent dev. |
xpander logs [agent] | – | Shortcut for agent logs. |
xpander invoke [agent] [msg] | – | Shortcut for agent invoke. |
xpander secrets-sync | – | Sync local .env to deployed agent. |
xpander nemo | – | Sync agent model config with local NeMo config (pull / push). |
xpander help [command] | – | Print help for a command. |
xpander deploy) and inside the agent namespace (xpander agent deploy). Both forms are documented in Agent Commands.
Where to next
Agent Commands
Every command under
xpander agent: control plane, local dev, deployment, graph, tools, NeMo.Auth & Config
login, configure, profile, secrets-sync.Shortcuts
x a n, x a d, and friends.