CLI Production Quickstart

Mobayilo CLI: Production Quickstart

Use this guide to run Mobayilo from terminal against production.

Prerequisites

• Install moby:

curl -fsSL https://mobycli.mobayilo.com/install.sh | sh

• You have a moby binary available in your PATH.
• You can sign in to your Mobayilo account in browser.

Update to latest before first use (and anytime after):

moby self-update
moby --version

1) Authenticate

Preferred (browser/device login):

moby auth login

Fallback (manual token login):

moby auth login --api-token <YOUR_TOKEN>

Check status:

moby auth status --json

2) Check account and rates

moby balance --json
moby rates US --json

3) Verify caller ID (required before CLI calling)

Request SMS code (number can be local or international format):

moby caller-id request 090-1872-1928 --country JP
# or
moby caller-id request +819018721928

CLI now prompts immediately for SMS code after request. If you skip the prompt, confirm later with:

moby caller-id confirm <SMS_CODE>

If needed, you can still override phone details manually:

moby caller-id confirm <SMS_CODE> --phone 09018721928 --country JP

Re-check status:

moby auth status --json

4) Place call

Place call directly (desktop audio is default):

moby call +14155550123
# or
moby call 090-1234-5678 --country Japan

CLI auto-starts local desktop agent when needed. Use --callback only when you explicitly want legacy phone callback mode.

5) Top up balance

moby topup 5

By default, CLI opens Stripe checkout in browser and prints the checkout URL. Use --no-open to skip auto-open.

Minimum top-up is $5.00 (amount must be at least 5).

Common errors

• authentication token required: run moby auth login again or pass --token.
• missing_caller_id: complete moby caller-id request and moby caller-id confirm <SMS_CODE>.
• positive_balance_required: add credits first (moby topup 5 ...).
• invalid_amount: amount is below the minimum (start at $5.00; some account types may require more).

Useful global flags

• --json for scriptable output.
• --token to override stored keychain token.
• --host to target non-production environments (advanced usage).

Manual token source (fallback mode)

If you need a manual token, generate it in web app:

• open Settings -> CLI access
• create token (scope + expiry)
• copy once and run moby auth login --api-token <YOUR_TOKEN>