# Use agent wallet

> Use agent wallet is an open-source agent skill for finance and payments. Set up and manage a Circle agent wallet through the `circle` CLI. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/circlefin/skills/tree/master/plugins/circle/skills/use-agent-wallet
- **Repository:** https://github.com/circlefin/skills
- **GitHub stars:** 168
- **License:** Apache-2.0
- **Skill name:** use-agent-wallet
- **Collection:** https://github.com/circlefin/skills
- **Categories:** finance and payments
- **Listing updated:** 2026-11-17

## About

Set up and manage a Circle agent wallet through the `circle` CLI. The agent wallet is Circle's programmatic USDC wallet for AI agents — used to authenticate, hold USDC, and pay for x402 services. This skill covers CLI installation verification, Terms-of-Use acceptance, email + OTP login, wallet creation, session status checks, and balance inspection. Use whenever the user wants to set up, log in to, or inspect the state of their Circle agent wallet, or whenever a downstream skill (like paying for an x402 service or funding the wallet) needs the wallet bootstrapped first. Triggers on: circle wallet login, circle wallet create, circle wallet status, set up Circle agent wallet, terms acceptance, install Circle CLI, x402 setup.

## When your agent uses it

> Set up and manage a Circle agent wallet through the `circle` CLI. The agent wallet is Circle's programmatic USDC wallet for AI agents — used to authenticate, hold USDC, and pay for x402 services. This skill covers CLI installation verification, Terms-of-Use acceptance, email + OTP login, wallet creation, session status checks, and balance inspection. Use whenever the user wants to set up, log in to, or inspect the state of their Circle agent wallet, or whenever a downstream skill (like paying for an x402 service or funding the wallet) needs the wallet bootstrapped first. Triggers on: circle wallet login, circle wallet create, circle wallet status, set up Circle agent wallet, terms acceptance, install Circle CLI, x402 setup.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Instructions only, no scripts](https://github.com/circlefin/skills/tree/HEAD/plugins/circle/skills/use-agent-wallet)
- [License: Apache-2.0](https://github.com/circlefin/skills/tree/HEAD/plugins/circle/skills/use-agent-wallet)

## Install

### Claude Code

This skill ships in the `circle-skills` plugin. In Claude Code, add the marketplace and install the plugin (it may include other skills too):

```sh
/plugin marketplace add circlefin/skills
/plugin install circle-skills@circle
```

Or copy only this skill to `~/.claude/skills/use-agent-wallet`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/circlefin/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/use-agent-wallet &&
cp -R "$tmp/plugins/circle/skills/use-agent-wallet" ~/.claude/skills/use-agent-wallet &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/use-agent-wallet` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/use-agent-wallet` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/circlefin/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/use-agent-wallet &&
cp -R "$tmp/plugins/circle/skills/use-agent-wallet" ~/.agents/skills/use-agent-wallet &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/use-agent-wallet` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/use-agent-wallet` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/circlefin/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/use-agent-wallet &&
cp -R "$tmp/plugins/circle/skills/use-agent-wallet" ~/.cursor/skills/use-agent-wallet &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/use-agent-wallet` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/circlefin/skills.git --path plugins/circle/skills/use-agent-wallet
```

Or copy the folder to `~/.gemini/skills/use-agent-wallet` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/use-agent-wallet`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/circlefin/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/use-agent-wallet &&
cp -R "$tmp/plugins/circle/skills/use-agent-wallet" ~/.copilot/skills/use-agent-wallet &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/use-agent-wallet` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/circlefin/skills.git
```

Then copy `skills/plugins/circle/skills/use-agent-wallet` into your agent's skills folder as `use-agent-wallet`. Agents that support SKILL.md read one folder per skill.

## FAQ

### How do I install Use agent wallet in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/use-agent-wallet to use it in all your projects, or to .claude/skills/use-agent-wallet in one project. Or install the circle-skills plugin, which includes it: /plugin marketplace add circlefin/skills, then /plugin install circle-skills@circle.

### Does Use agent wallet run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use Use agent wallet?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

### What are the best alternatives to Use agent wallet?

The closest alternatives to Use agent wallet are Lightweight charts react components, Crypto protocol diagram, Upgrade stripe, Stripe best practices and Stripe implementation planner.

## Alternatives

- [Lightweight charts react components](https://ai-powered.com/skills/lightweight-charts-react-components): Lightweight charts react components is an open-source agent skill for finance and payments.
- [Crypto protocol diagram](https://ai-powered.com/skills/crypto-protocol-diagram): Crypto protocol diagram is an open-source agent skill for finance and payments.
- [Upgrade stripe](https://ai-powered.com/skills/upgrade-stripe): Upgrade stripe is an open-source agent skill for finance and payments.
- [Stripe best practices](https://ai-powered.com/skills/stripe-best-practices): Stripe best practices is an open-source agent skill for finance and payments.
- [Stripe implementation planner](https://ai-powered.com/skills/stripe-implementation-planner): Stripe implementation planner is an open-source agent skill for finance and payments.
- [Connect recommend](https://ai-powered.com/skills/connect-recommend): Connect recommend is an open-source agent skill for finance and payments.
- [Stripe docs](https://ai-powered.com/skills/stripe-docs): Stripe docs is an open-source agent skill for finance and payments.
- [Stripe directory](https://ai-powered.com/skills/stripe-directory): Stripe directory is an open-source agent skill for finance and payments.

---
Source: https://ai-powered.com/skills/use-agent-wallet
