← Wallet onboard

Install BAGS Cash

Hosted agent wallet for x402 — no local private keys. Run commands with npx @getbags/cash …. After npm i -g @getbags/cash, the bags binary is the same command.

1. Sandbox wallet (recommended first)

Mints a test wallet with fake $100,000 promo credit. Restricted to Base Sepolia + Solana devnet. Burns no invite.

npx @getbags/cash redeem --test

2. Or redeem a live invite

npx @getbags/cash redeem <CODE>

3. Register the wallet with your agent

npx @getbags/cash init

Bare init writes user-scope config under ~ (ambient on this machine). Use --scope project for committable, repo-local config. Or paste into your agent: Set up https://www.getbags.app/wallet/skill.md

4. Restart your agent client

Restart Cursor, Claude Code, or Codex so it loads the bags-cash MCP server. MCP configs are not hot-reloaded — skipping this leaves the wallet invisible.

5. Verify

npx @getbags/cash doctor

6. Agent loop

npx @getbags/cash balance
npx @getbags/cash discover
npx @getbags/cash check 'https://www.getbags.app/api/v1'
npx @getbags/cash fetch 'https://www.getbags.app/api/v1'

Bare discover lists BAGS’ $0.01 /api/v1 showcase first. Fetch often takes ~30–60 seconds — set framework timeouts accordingly.

Raw skill file (text/markdown, for agents): /wallet/skill.md