Skip to content

ecomxco/setup-cli

Repository files navigation

Setup CLIs

License: MIT Platform: macOS Node: ≥18 eComX Tooling

Scaffold agentic CLI scripts for every service in your stack — automatically, from your live environment.

Built by eComX — the Context-First AI development methodology for serious ecommerce operators.


What This Is

An AI-agent workflow that reads your connected services from /setup-environment and generates a fully-functional CLI script for each one. Every API endpoint becomes a terminal command. No dashboard clicking — everything is scriptable and agent-callable.

Philosophy: Every API endpoint your brand touches should be queryable from the terminal. Your AI agents should never need to open a browser.

When you're done, you have:

  • 📁 A scripts/ directory with one CLI per service
  • 🔗 Full read/write access to every connected API
  • 🤖 Agent-ready commands your BIOS and Axiom workflows can call directly
  • 📊 A unified dashboard pulling metrics from all services
  • 🛡️ Built-in rate limiting, pagination, and error handling

Services Supported

Category Services
🛒 E-Commerce Shopify (products, orders, customers, themes, content, discounts)
📢 Marketing & Ads Meta Ads, Meta Social (Facebook + Instagram), Google Ads
📧 Email Marketing Klaviyo (campaigns, flows, segments, profiles)
📊 Analytics GA4 (traffic, events, conversions, audiences)
💳 Payments Stripe (charges, subscriptions, invoices, payouts)
📬 Communication Gmail (inbox, send, drafts, labels)
📱 SMS Twilio (send, calls, phone numbers, usage)
🎧 Customer Support Gorgias (tickets, CSAT, macros)
📒 Accounting QuickBooks (invoices, P&L, balance sheet)
🔍 Monitoring Sentry (issues, releases, error rates)
🎨 Design Figma (files, components, exports), Notion (databases, pages)

Need a service not listed? Use --add custom — the agent will research the service's API, discover endpoints, and scaffold the CLI automatically.


Prerequisites

  • /setup-environment completed — credentials must be in Keychain
  • Node.js ≥ 18
  • An AI agent that can run workflows (Claude, Cursor, Antigravity, etc.)

Quick Start

# Clone the repo
git clone https://github.com/ecomxco/setup-cli.git
cd setup-cli

# Open WORKFLOW.md in your AI agent and run:
/setup-cli

Your agent will detect every connected service, scaffold CLIs with full endpoint coverage, and verify each one works.


How It Works

  1. Detect Services — Reads your .env.local (generated by /setup-environment) and identifies every connected service
  2. Authenticate Native CLIs — Runs auth flows for 1st-party tools (gh, vercel, supabase, shopify, wrangler)
  3. Initialize Project — Creates package.json and installs per-service SDKs
  4. Scaffold Custom CLIs — Generates scripts/{service}.js from the endpoint registry with full read/write coverage
  5. Validate — Runs a smoke test on every generated CLI to verify connectivity
  6. Generate Dashboard — Creates scripts/dashboard.js aggregating metrics from all services
  7. Document — Updates ENVIRONMENT.md with full CLI command reference

Modes

Command What It Does
/setup-cli Full setup — scaffold CLIs for all connected services
/setup-cli --add shopify Add one service from the built-in registry
/setup-cli --add custom Agent researches a new service and scaffolds the CLI
/setup-cli --verify Smoke test all generated CLIs

What Gets Generated

For each connected service, a scripts/{service}.js file with:

  • Full endpoint coverage — every read and write operation the API supports
  • Pagination — automatic cursor/offset handling for large datasets
  • Rate limiting — built-in backoff and retry for API rate limits
  • Output formatting--json, --csv, --table flags on every command
  • Dry-run--dry-run flag on all write operations
  • Error handling — human-readable error messages with actionable suggestions

Usage After Setup

# Pull all Shopify orders (JSON output, paginated)
node scripts/shopify.js orders --status any --limit 250 --json

# Get Klaviyo campaign performance (table format)
node scripts/klaviyo.js campaigns --last 30 --table

# Preview a Meta Ads campaign pause (dry run)
node scripts/meta-ads.js pause-campaign --id 12345 --dry-run

# Full briefing from unified dashboard
node scripts/dashboard.js --days 30

What's Next

Once your CLIs are set up:

→ /setup-data-warehouse   # Pull live data into your local warehouse
→ /setup-bios             # Generate your 33 BIOS intelligence specs
→ /plan-project           # Begin building with full context

Contributing

See CONTRIBUTING.md for how to add new services or improve CLI templates.

Security

See SECURITY.md for our responsible disclosure policy.

Support


License

MIT — © 2026 eCom XP LLC

About

Scaffold agentic CLI scripts for every service in your stack — full read/write API coverage, pagination, rate limiting, and output formatting for 13+ services.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors