agent-wallet-policy

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

1|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/Lightupwrld/Cycuxio --skill agent-wallet-policy-lightupwrld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-wallet-policy
Source: https://github.com/Lightupwrld/Cycuxio/tree/main/.agents/skills/agent-wallet-policy
Command: npx skills add https://github.com/Lightupwrld/Cycuxio --skill agent-wallet-policy-lightupwrld

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Circle agent wallets enforce per-transaction, daily, weekly, and monthly USDC spending caps, but setting or resetting those limits requires an interactive OTP flow that an AI agent must never touch. This Skill lets you inspect current limits directly and safely hands off limit changes to your own terminal without the OTP ever passing through the agent. ## Core Features & Use Cases - View spending limits: Run circle wallet limit --address <addr> --chain BASE --output json to read per-tx, daily, weekly, and monthly USDC caps with no OTP required. - Safe limit changes: Generates a verbatim circle wallet limit set or reset command for you to run in your own terminal, keeping the 6-digit email OTP entirely outside the agent's context. - Validation and troubleshooting: Enforces monotonic limits (per-tx ≤ daily ≤ weekly ≤ monthly), mainnet-only chains, and agent-wallet-only policies, with fixes for common OTP and prefix-mismatch errors. - Use Case: You want to cap an autonomous agent wallet at $1 per transaction and $50 per month. The Skill confirms the values with you, hands you the exact CLI command, and verifies the new caps after you complete the OTP prompt. ## Quick Start Ask the agent to show the current spending limits on your Circle agent wallet on Base mainnet.

Frequently Asked Questions about agent-wallet-policy

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

FAQPage Schema
How do I check spending limits on a Circle agent wallet?

Run `circle wallet limit --address <addr> --chain BASE --output json` to view current per-transaction, daily, weekly, and monthly USDC caps. This is a read-only call that requires no OTP and moves no funds.

How do I set spending limits on a Circle agent wallet?

Run `circle wallet limit set` with --per-tx, --daily, --weekly, and --monthly values in your own terminal. The CLI emails a 6-digit OTP that you enter at the prompt; the agent should never see or relay this code.

Can I set spending policies on testnet chains?

No, spending policies are mainnet-only. Attempting to set a policy on a testnet chain returns an error, so use a mainnet chain value such as BASE or MATIC.

Why does circle wallet limit set fail with a monotonic error?

Limits must be monotonic: per-tx must be less than or equal to daily, daily to weekly, and weekly to monthly. Re-check your values so each tier does not exceed the next higher tier.

What should I do if I receive multiple OTP emails?

Use only the most recent OTP, since re-running the command invalidates earlier codes. Each set or reset invocation generates a fresh prefix, so an OTP from a previous run will be rejected.

Do spending policies work on local Circle wallets?

No, spending policies apply only to agent wallets created via `circle wallet create`. Attempting to set a policy on a local non-agent wallet returns an error.