Skip to main content

What is the Xpander CLI?

The xpander.ai CLI helps you build and manage AI agents with three core functions:
  1. 🎛️ Control Plane - Create and manage agents in xpander.ai’s cloud
  2. 🏗️ Local Development - Download framework templates to your machine
  3. ☁️ Cloud Deployment - Deploy agents as Docker containers and monitor them

Quick Setup

Requirements: Node.js 20+, Python 3.12+
# Install CLI
npm install -g xpander-cli

# Login (opens browser)
xpander login

Essential Commands

# Create new agent
x a n                       # Interactive creation
x a n --name "bot" --folder "." --framework "agno"  # Non-interactive

# Download agent to work locally  
x a i                       # Shows list to select from
x a i my-agent              # Download specific agent

# Deploy to cloud
x a d                       # Shows list to select from
x a d my-agent              # Deploy specific agent

# Monitor logs
x a l                       # Shows list to select from  
x a l my-agent              # Stream logs for specific agent

# Test agent with messages
x a invoke "Hello, test message"    # Interactive agent selection
x a invoke my-agent "Hello"         # Test specific agent by name
x a invoke --agent-id <id> "Hello"  # Test specific agent by ID

Typical Workflow

x l                         # 1. Login to xpander.ai
x a n                       # 2. Create new agent
x a i my-agent              # 3. Download agent files locally
# Edit your agent code...
x a d my-agent              # 4. Deploy updated agent
x a invoke my-agent "test"  # 5. Test deployed agent
x a l my-agent              # 6. Monitor logs

Next Steps