use-agent-wallet
Installation
SKILL.md
Overview
The Circle CLI (@circle-fin/cli, command circle) provides a programmatic agent wallet — a non-custodial USDC wallet designed for AI agents to authenticate, hold balances, and pay for paid x402 services on Circle's marketplace. This skill is the bootstrap surface for that wallet: install check, terms acceptance, login, wallet creation, and status inspection. After bootstrap completes, downstream operations (paying for services, funding, spending policy) hand off to dedicated skills.
For an overview of the Circle CLI's full capability set — bridging, smart contract execution, transaction inspection, and more — see the use-circle-cli master skill. This skill is the narrower bootstrap/identity surface.
Workflow
- Verify the CLI is installed, then check session status with
circle wallet statusbefore anything else. - If the Terms-of-Use gate appears, complete the show-Terms-and-consent flow first — never accept on the user's behalf.
- If not logged in, run the two-step email + OTP login, then verify the session.
- List existing agent wallets, or create them if none exist (
--chaindefaults to ARC). - Check the wallet balance; if it is 0 USDC and the user wants to pay, hand off to
fund-agent-wallet. Otherwise bootstrap is complete.