Machines CLI lets you manage your Machines account from the terminal. Use it for login, identity verification, balance checks, crypto deposits, card management, agentic payments, and connecting AI apps.
Prerequisites
- Node.js 18+
- A Machines account
Install
npm i -g @machines-cash/cli
machines to open the guided menu, or use commands directly.
Don’t want a global install? Use npx machines-cash@latest <command> for one-off commands.
Quick start
Log in
Opens your browser to authenticate. Your session is saved locally for future commands. Verify your identity
machines user create --browser
Add money
machines deposit create --token USDC --network base --amount 25
Create a card
machines card create --name "ads-bot" --limit 250 --frequency per30DayPeriod
Buy something
machines buy "https://www.amazon.com/dp/B0DGHMNQ5Q" --wait
Commands
Login
machines login # browser login
machines login --no-launch-browser # prints URL instead of opening browser
machines login --agent # CLI-only login for agents with wallets
machines logout # sign out
Balance and deposits
machines balance # check spending power
machines deposit assets # list supported tokens and networks
machines deposit create --token USDC --network base --amount 25
machines deposit show --id <deposit-id> # check one deposit
machines deposit watch --id <deposit-id> # poll until complete
Send only the exact token on the exact network shown. If a memo appears, include it exactly. CLI deposits are crypto only.
Identity verification
Browser-based (recommended):
machines user create --browser
machines kyc status
machines user create --from-file ./kyc-user.json --open --wait
Cards
machines card create --name "ads-bot" --limit 250 --frequency per30DayPeriod
machines card list
machines card reveal --last4 4242
machines card update --last4 4242 --name "ads-bot-v2"
machines card limit set --last4 4242 --amount 500 --frequency per30DayPeriod
machines card lock --last4 4242
machines card unlock --last4 4242
machines card delete --last4 4242
machines disposable create --amount-cents 5000 --auto-cancel-after-auth
Agentic payments
machines search "apple airpods pro"
machines search "kindle paperwhite"
machines search "ninja air fryer"
machines buy "https://www.amazon.com/dp/B0DGHMNQ5Q"
machines buy "https://www.amazon.com/dp/B0DGHMNQ5Q" --card "<card-label-or-last4>" --wait
machines agent status <action-id>
machines agent confirm <action-id>
machines agent 3ds <action-id> --code <code>
- shopping defaults to Amazon right now
machines search is the preferred commandmachines browser still works as a compatibility alias- if
--card is omitted, Machines uses your default active card and stored billing profile
--wait and --watch keep polling until the action pauses or finishes- use
--payment-card-file <path|-> only for direct testing; never pass raw card numbers in flags
More examples:
machines search "lego botanical orchid"
machines search "anker usb c charger"
machines buy "https://www.amazon.com/dp/B0DGHMNQ5Q" --wait --json
Connect an AI app
machines mcp install --host codex # or: claude, copilot, chatgpt
machines mcp auth login
machines mcp doctor # check connection health
Agent output
Add --json to any command for structured output:
machines card list --json
machines buy "https://www.amazon.com/dp/B0DGHMNQ5Q" --wait --json
Troubleshooting
| Problem | Fix |
|---|
| Browser didn’t open | Use --no-launch-browser and open the URL manually |
user not found | Complete identity verification first |
machines: command not found | Run npm i -g @machines-cash/cli or use npx machines-cash@latest |
| Need full command list | Run machines --help |
Next steps
