Mobayilo CLI - Project Summary

Project Overview

Build a high-performance, scriptable CLI for the Mobayilo calling platform. The CLI will serve as a companion to the web app, allowing users to perform core actions (calling, billing, rate lookups) without leaving the terminal.

Core Features

Authentication: Persistent login using system keychain.
Calling: Trigger calls via “Click-to-Call” (connecting verified caller ID to destination).
Billing: Balance checks and Stripe-integrated top-ups.
Data Access: Rate lookups and contact management.
Updates: Built-in moby self-update command and release-aware upgrade notice.
Scripting: JSON output support for integration with other tools (e.g., jq).

Current Evolution

Phase 7 direction: Add a local moby-agent desktop runtime so moby call can use device audio (Twilio Voice JS) without requiring an active browser tab workflow.
Phase 7A delivered: Backend endpoint POST /api/cli/voice/token with CLI bearer auth, scope checks, short-lived token issuance, and identity resolver support for CLI voice identities.
Phase 7B in progress: Added moby agent run/status runtime and moby call --agent integration with callback fallback.
Docs/site alignment: Public quickstart and support docs now surface moby self-update as part of standard first-run and support flow.

Tech Stack

CLI Tool: Go, Kong, Keyring.
Backend: Rails API (Mobayilo Monolith).
Communication: REST API over HTTPS.

Inspiration

Inspired by gogcli and gh (GitHub CLI) for their speed, declarative command structure, and seamless authentication.