skills.rest
Lightupwrld
LightupwrldCOMMUNITY
Explore all skills by this author →
GitHub

use-agent-wallet

Set up and manage a Circle agent wallet through the circle CLI.

1|Updated Jul 20, 2026
Search Tags:#cli#x402#usdc#circle#agent wallet#crypto payments#otp login
One-click install
npx skills add https://github.com/Lightupwrld/Cycuxio --skill use-agent-wallet-lightupwrld
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: use-agent-wallet
Source: https://github.com/Lightupwrld/Cycuxio/tree/main/.agents/skills/use-agent-wallet
Command: npx skills add https://github.com/Lightupwrld/Cycuxio --skill use-agent-wallet-lightupwrld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @circle-fin/cli.

What problem does it solve? AI agents and developers need a programmatic USDC wallet to authenticate and pay for x402 services, but bootstrapping a Circle agent wallet involves CLI installation checks, Terms-of-Use consent, email + OTP login, wallet creation, and balance inspection across multiple steps. ## Core Features & Use Cases - CLI Bootstrap & Session Management: Verify the @circle-fin/cli installation, check login status with circle wallet status, and handle Terms-of-Use acceptance with explicit user consent. - Two-Step OTP Login: Authenticate non-interactively via circle wallet login --init and OTP verification, with request ID parsing and expiry handling. - Wallet Creation & Balance Inspection: Create agent-controlled SCA wallets across EVM chains and check USDC balances per chain and address. - Use Case: An AI agent needs to pay for a paid x402 API service. This skill walks through logging into Circle, creating the agent wallet, and confirming its USDC balance before handing off to funding or payment skills. ## Quick Start Ask the agent to set up your Circle agent wallet and check its USDC balance on Base.

Frequently Asked Questions about use-agent-wallet

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Circle agent wallet with the CLI?▼

Install the CLI with npm install -g @circle-fin/cli, accept the Terms of Use, log in via circle wallet login with your email and OTP, then run circle wallet create to generate agent wallets on supported EVM chains.

How do I log in to the Circle CLI non-interactively?▼

Run circle wallet login <email> --type agent --init to request an OTP, then complete with circle wallet login --request <request-id> --otp <code>. Request IDs expire after 10 minutes and are single-use.

How do I check my Circle agent wallet balance?▼

Run circle wallet balance --address <addr> --chain BASE --output json. The --chain flag is required for balance and list commands; use BASE as the default chain if none is specified.

Why does circle wallet status show a Terms acceptance error?▼

The Circle CLI hard-gates all wallet commands until Terms of Use are accepted on the machine. Run circle terms show --init to view the terms, obtain explicit user consent, then run circle terms accept.

What happens if my Circle wallet balance is zero USDC?▼

A zero balance means the wallet cannot pay for x402 services yet. Hand off to the fund-agent-wallet skill, which covers fiat on-ramp purchases, direct address transfers with QR codes, and Gateway deposits.

Related Skills

Explore More Software Engineering Skills→
levantuylevantuy
3

use-agent-wallet

Set up and inspect a Circle agent wallet through the circle CLI.

Community
Intermediate
levantuylevantuy
3

fund-agent-wallet

Fund Circle agent wallets with USDC via fiat on-ramp, crypto transfer, or Gateway deposit.

Community
Advanced
levantuylevantuy
3

agent-wallet-policy

View and configure USDC spending limits on Circle agent wallets via the circle CLI.

Community
Intermediate
TimeKastTimeKast

bash-linux

Provide tested Bash/Linux command patterns for chaining, searching, and automation.

Official
Basic