Machines CLI

Simple command-line interface for Machines cards, disposable cards, and MCP host setup.

Quick start

Recommended default (install once globally):

npm i -g @machines-cash/cli
machines
machines login
machines home
machines update

One-off fallback (no global install):

npx machines-cash@latest
npx machines-cash@latest home
npx machines-cash@latest login
npx machines-cash@latest login --browser
npx machines-cash@latest login --browser --no-launch-browser
npx machines-cash@latest login --browser --no-home
npx machines-cash@latest logout
npx machines-cash@latest user create --name=john --lastname=doe --birth-date=1990-01-01 --country-of-issue=US --national-id=123456789 [email protected] --line1="123 main st" --city="new york" --region=NY --postal-code=10001 --country-code=US --occupation=SELFEMP --annual-salary="50k-99k" --account-purpose=testing --expected-monthly-volume="under-$1k"
npx machines-cash@latest create user --name=john --lastname=doe --birth-date=1990-01-01 --country-of-issue=US --national-id=123456789 [email protected] --line1="123 main st" --city="new york" --region=NY --postal-code=10001 --country-code=US --occupation=SELFEMP --annual-salary="50k-99k" --account-purpose=testing --expected-monthly-volume="under-$1k" --open --wait
npx machines-cash@latest user create --from-file ./kyc-user.json --open --wait
npx machines-cash@latest user create --payload '{"firstName":"john","lastName":"doe","birthDate":"1990-01-01","countryOfIssue":"US","nationalId":"123456789","email":"[email protected]","address":{"line1":"123 main st","city":"new york","region":"NY","postalCode":"10001","countryCode":"US"},"occupation":"SELFEMP","annualSalary":"50000-75000","accountPurpose":"testing","expectedMonthlyVolume":"0-1000"}'
npx machines-cash@latest user create --interactive
npx machines-cash@latest kyc questionnaire
npx machines-cash@latest kyc status
npx machines-cash@latest kyc open --no-launch-browser
npx machines-cash@latest kyc wait --interval-seconds 5 --timeout-seconds 900
npx machines-cash@latest balance
npx machines-cash@latest deposit assets
npx machines-cash@latest deposit preview --token ETH --network eth --amount 500 --amount-currency usd
npx machines-cash@latest deposit create --token USDC --network base --amount 25
npx machines-cash@latest deposit create --token ETH --network eth --amount 500 --amount-currency usd --watch --save-address --label treasury
npx machines-cash@latest deposit list
npx machines-cash@latest deposit show --id deposit-123
npx machines-cash@latest deposit watch --id deposit-123 --interval-seconds 5 --timeout-seconds 1200
npx machines-cash@latest deposit refresh --id deposit-123
npx machines-cash@latest card create --name "ads-bot" --limit 250 --frequency per30DayPeriod
npx machines-cash@latest card create --name "ads-bot" --reveal
npx machines-cash@latest card list
npx machines-cash@latest card reveal --last4 4242
npx machines-cash@latest card update --last4 4242 --name "ads-bot-v2"
npx machines-cash@latest card lock --last4 4242
npx machines-cash@latest card unlock --last4 4242
npx machines-cash@latest card limit set --last4 4242 --amount 500 --frequency per30DayPeriod
npx machines-cash@latest card delete --last4 4242
npx machines-cash@latest disposable create --amount-cents 5000 --auto-cancel-after-auth
npx machines-cash@latest mcp install --host codex
npx machines-cash@latest mcp auth login
npx machines-cash@latest doctor
npx machines-cash@latest update
npx machines-cash@latest completion zsh

Canonical package name:

npx @machines-cash/cli
npx @machines-cash/cli home
npx @machines-cash/cli login
npx @machines-cash/cli login --browser
npx @machines-cash/cli login --browser --no-launch-browser
npx @machines-cash/cli login --browser --no-home
npx @machines-cash/cli logout
npx @machines-cash/cli user create --name=john --lastname=doe --birth-date=1990-01-01 --country-of-issue=US --national-id=123456789 [email protected] --line1="123 main st" --city="new york" --region=NY --postal-code=10001 --country-code=US --occupation=SELFEMP --annual-salary="50k-99k" --account-purpose=testing --expected-monthly-volume="under-$1k"
npx @machines-cash/cli create user --name=john --lastname=doe --birth-date=1990-01-01 --country-of-issue=US --national-id=123456789 [email protected] --line1="123 main st" --city="new york" --region=NY --postal-code=10001 --country-code=US --occupation=SELFEMP --annual-salary="50k-99k" --account-purpose=testing --expected-monthly-volume="under-$1k" --open --wait
npx @machines-cash/cli user create --from-file ./kyc-user.json --open --wait
npx @machines-cash/cli user create --payload '{"firstName":"john","lastName":"doe","birthDate":"1990-01-01","countryOfIssue":"US","nationalId":"123456789","email":"[email protected]","address":{"line1":"123 main st","city":"new york","region":"NY","postalCode":"10001","countryCode":"US"},"occupation":"SELFEMP","annualSalary":"50000-75000","accountPurpose":"testing","expectedMonthlyVolume":"0-1000"}'
npx @machines-cash/cli user create --interactive
npx @machines-cash/cli kyc questionnaire
npx @machines-cash/cli kyc status
npx @machines-cash/cli kyc open --no-launch-browser
npx @machines-cash/cli kyc wait --interval-seconds 5 --timeout-seconds 900
npx @machines-cash/cli balance
npx @machines-cash/cli deposit assets
npx @machines-cash/cli deposit preview --token ETH --network eth --amount 500 --amount-currency usd
npx @machines-cash/cli deposit create --token USDC --network base --amount 25
npx @machines-cash/cli deposit create --token ETH --network eth --amount 500 --amount-currency usd --watch --save-address --label treasury
npx @machines-cash/cli deposit list
npx @machines-cash/cli deposit show --id deposit-123
npx @machines-cash/cli deposit watch --id deposit-123 --interval-seconds 5 --timeout-seconds 1200
npx @machines-cash/cli deposit refresh --id deposit-123
npx @machines-cash/cli card create --name "ads-bot" --limit 250 --frequency per30DayPeriod
npx @machines-cash/cli card create --name "ads-bot" --reveal
npx @machines-cash/cli card list
npx @machines-cash/cli card reveal --last4 4242
npx @machines-cash/cli card update --last4 4242 --name "ads-bot-v2"
npx @machines-cash/cli card lock --last4 4242
npx @machines-cash/cli card unlock --last4 4242
npx @machines-cash/cli card limit set --last4 4242 --amount 500 --frequency per30DayPeriod
npx @machines-cash/cli card delete --last4 4242
npx @machines-cash/cli disposable create --amount-cents 5000 --auto-cancel-after-auth
npx @machines-cash/cli mcp install --host codex
npx @machines-cash/cli mcp auth login
npx @machines-cash/cli doctor
npx @machines-cash/cli update
npx @machines-cash/cli completion bash

Notes

• machines (no args) opens guided home on interactive terminals.
• after your first login, run machines or machines home to reopen the action menu.
• home includes balance, which shows Rain spending power and the guided add money flow.
• signed-in users stay in a focused KYC flow until verification is complete.
• Writes execute directly.
• --json returns machine-friendly output.
• --non-interactive disables prompts and fails on missing required args.
• --yes skips confirmations for destructive operations (for example, card delete).
• --no-color forces plain output.
• Financial writes auto-attach idempotency keys.
• User auth is saved at ~/.machines/cli/auth.json.
• MCP auth is saved at ~/.machines/cli/mcp-auth.json.
• update checks npm for a newer release of the package you installed (@machines-cash/cli or machines-cash) and installs that package globally when available.
• login defaults to browser auth. Use --no-launch-browser when you want to open the URL manually.
• if you are already signed in, login reuses the saved auth and reopens home instead of forcing a new browser round-trip.
• after browser login on interactive terminals, CLI opens guided home automatically.
• pass --no-home to return directly to shell after login.
• Browser login opens the hosted web app handoff page (https://app.machines.cash/auth/cli) by default.
• Override hosted web app URL with MACHINES_WEB_APP_URL.
• login --agent keeps fully CLI-based signature auth for agents and automation.
• Login provisions full user API scopes by default (no scope flags required).
• Provider-token exchange remains available for embedded-app handoff (--id-token or --access-token).
• user create submits full KYC application in one command; create user is an alias for agent-friendly grammar.
• if required profile fields are missing and you are in an interactive terminal, user create now offers two paths and defaults to browser-first KYC.
• user create --browser opens the web KYC flow directly.
• direct user create still requires phone fields.
• user create --interactive and kyc questionnaire run a guided KYC wizard with numbered choices.
• Input normalization is automatic for common formats:
  • phone +1 (415) 555-0100 -> phoneCountryCode=1, phoneNumber=4155550100
  • birth date 01/31/1990 -> 1990-01-31
  • country codes u.s. -> US
  • salary/volume labels like 50k-99k or under $1k are mapped to API-safe values
• kyc status|open|wait supports hosted verification handoff and polling until approval.
• balance shows Rain spending power only.
• deposit covers crypto deposit addresses only:
  • deposit assets lists available tokens and networks
  • deposit preview estimates what you send / receive
  • deposit create creates a deposit address
  • deposit create --watch stays attached and polls status
  • deposit list|show|watch|refresh manages existing deposits
• home add money resumes an active deposit when one is already in progress.
• mcp doctor validates installed host configs, not just file existence.
• Flags support both --key value and --key=value.
• Generate shell completion with machines completion bash|zsh|fish.

Testing

npm test

Coverage includes:

• login modes (browser, agent, saved-session reuse)
• user create + KYC status/open/wait flows
• balance + crypto deposit flows (assets, preview, create, list, show, watch, refresh, save-address)
• card lifecycle (create, list, reveal, update, lock, unlock, limit, delete)
• disposable card creation
• MCP install + doctor