CLI Reference

npm install -g xpander-cli
xpander login

# Full commands
xpander agent new
xpander agent deploy my-agent

# Shortcuts  
x a n                       # xpander agent new
x a d my-agent              # xpander agent deploy

xpander login                         # Authenticate with xpander.ai (opens browser)
xpander configure                     # Set up API credentials manually
xpander profile --list                # List all profiles
xpander profile --switch <name>       # Switch between organizations

xpander agent new                     # Create new agent in xpander.ai cloud
xpander agent new --name "bot" --folder "." --framework "agno"  # Non-interactive
xpander agent list                    # List all your agents (newest first)
xpander agent edit [agent]            # Edit agent configuration in browser
xpander agent delete [agent]          # Permanently delete agent from cloud
xpander agent invoke [agent] "message" # Test agent with a message via webhook

xpander agent init [agent]            # Download agent files to current folder
xpander agent dev [agent]             # Run agent locally for testing

xpander agent deploy [agent]          # Build & deploy agent as Docker container
xpander agent logs [agent]            # Stream real-time logs from cloud
xpander agent restart [agent]         # Restart deployed container
xpander agent stop [agent]            # Stop running container
xpander secrets-sync                  # Upload .env variables to deployed agents

xpander agent invoke                  # Interactive agent selection + message prompt
xpander agent invoke "Hello world"   # Interactive agent selection with message
xpander agent invoke my-agent "Hi"   # Test specific agent by name
xpander agent invoke --agent-name my-agent "Hi"    # Old syntax (backward compatible)
xpander agent invoke --agent-id <id> "Hi"          # Test specific agent by ID

# Quick testing workflow
x a invoke "test my new feature"      # Pick agent, test quickly
x a invoke notebook-agent "analyze data.csv"  # Direct agent testing
x a invoke --agent-id abc123 "status check"   # Test by exact ID

# Development workflow
x a d my-agent                        # Deploy updated code
x a invoke my-agent "test changes"    # Immediately test changes

# Authentication
x l                         # xpander login
x c                         # xpander configure

# Control Plane (Agent Management)
x a n                       # xpander agent new
x a e [agent]               # xpander agent edit (shows list if no agent)
x a del [agent]             # xpander agent delete (shows list if no agent)
x a invoke [agent] "msg"    # xpander agent invoke (shows list if no agent)

# Local Development
x a i [agent]               # xpander agent init (shows list if no agent)

# Cloud Deployment
x a d [agent]               # xpander agent deploy (shows list if no agent)
x a l [agent]               # xpander agent logs (shows list if no agent)

name: Deploy with Xpander
on:
  push:
    branches: [ main ]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
      with:
        node-version: '20'
    - uses: actions/setup-python@v4
      with:
        python-version: '3.12'
    - run: npm install -g xpander-cli
    - run: |
        xpander deploy --agent-id "${{ secrets.XPANDER_AGENT_ID }}" --api-key "${{ secrets.XPANDER_API_KEY }}" --confirm

# Login to different profiles/orgs
xpander login --profile production
xpander login --profile staging

# Use specific organization
xpander agent list --profile staging
xpander deploy --profile production

# Skip all prompts
xpander agent new --name "bot" --framework "agno" --folder "."
xpander init abc123 --framework "agno" --folder "."