Developer CLI & Workflows

The zirzir CLI gives developers and AI agents terminal access to the full Zirzir orchestrator.

---

🔑 Browser OAuth Loopback Flow

sequenceDiagram
    autonumber
    actor Dev as Developer / Agent
    participant CLI as 💻 Zirzir CLI
    participant Browser as 🌐 Web Browser
    participant Dashboard as 📊 Developer Dashboard

    Dev->>CLI: $ zirzir login
    CLI->>CLI: Starts temporary loopback server on 127.0.0.1:4545
    CLI->>Browser: Opens http://localhost:8080/cli/auth?port=4545&token=xyz
    Browser->>Dashboard: Authenticates with developer session
    Dashboard->>Browser: User clicks 'Authorize CLI'
    Browser->>CLI: POST http://127.0.0.1:4545/callback with API credentials
    CLI->>CLI: Saves credentials to ~/.zirzir/config.json
    CLI-->>Dev: ✅ Authenticated as 'Development Team' (zz_test_...)

---

⚡ Core CLI Commands

1. Test Charges Directly from Terminal

zirzir charge --amount 350 --currency ETB --provider telebirr --phone 0911223344

2. Create Hosted Payment Links

zirzir link create --amount 1250 --currency ETB --title "Freelance Consultation"

3. Create Subscriptions

zirzir sub create --plan plan_pro_monthly --provider telebirr --phone 0911223344

4. Simulate Webhook Events (Zero Money Spent)

zirzir trigger payment.succeeded --provider telebirr --amount 500.0
zirzir trigger payment.succeeded --provider mpesa --amount 1200.0

5. Forward Webhooks to Localhost

zirzir listen --forward-to http://localhost:3000/api/webhooks