@ecomweb/cli

Agent-friendly CLI for the ecomweb platform. Manage your store, products, orders, and more from the command line.

Quick Start

# Interactive setup wizard (recommended for first-time users)
npx @ecomweb/cli setup

# Or install globally
npm install -g @ecomweb/cli
ecomweb setup

The setup wizard walks you through:

1. Create account — enter your email, receive a verification code
2. Verify email — enter the 6-digit code
3. Set up store — pick an existing store or create a new one
4. Ready! — API key is generated and saved automatically

Usage

# Products
ecomweb products list
ecomweb products get <id>
ecomweb products create --stdin < product.json

# Orders
ecomweb orders list --status pending
ecomweb orders get <id>
ecomweb orders update-status <id> --status confirmed

# Blog
ecomweb blog-posts list
ecomweb blog-posts create --stdin < post.json

# All commands
ecomweb --help
ecomweb <topic> --help

Non-Interactive Auth

For CI/CD or scripting, use the flag-based commands instead of the wizard:

ecomweb auth register --email [email protected]
ecomweb auth verify --email [email protected] --code 123456
ecomweb init --store-name "My Store"

Output Formats

ecomweb products list                    # JSON (default)
ecomweb products list --output table     # Table
ecomweb products list --output csv       # CSV
ecomweb products list --fields id,name   # Select fields
ecomweb products list --quiet            # Suppress metadata

Configuration

Config is stored in ~/.config/ecomweb/ with file permissions 0600.

ecomweb stores list               # List your stores
ecomweb stores switch <id>        # Switch active store
ecomweb auth status               # Check auth status

Profiles

ecomweb setup --profile staging           # Create a named profile
ecomweb products list --profile staging   # Use it

Environment Variables

| Variable | Description | |----------|-------------| | ECOMWEB_API_KEY | API key (overrides config) | | ECOMWEB_STORE_ID | Store ID (overrides config) | | ECOMWEB_API_URL | API base URL (overrides default) |

Requirements

• Node.js >= 18.0.0

License

MIT