npm i -g @agentwallet/cli

The Agent CLI.

Provision wallets, inspect logs, manage policies, and approve spend right from your terminal. No dashboards required. Built for developers shipping fleets.

# Install the CLI
$ npm i -g @agentwallet/cli

# Initialize with your API key via magic link
$ aw login
✓ Logged in as [email protected]
✓ Context set to workspace: prod-cluster-1

COMMAND REFERENCE

Manage the fleet from the shell.

aw provision

Spin up a new wallet for an agent with a single command. Binds the wallet to a principal and provisions a virtual card, USDC address, and MCP endpoint atomically.

Flags: --agent, --principal, --daily-cap

$ aw provision --agent recruiter-bot-01 --principal user_yk_42

✓ Wallet provisioned: wlt_8Hk29p

Card: 4242 0815 **** 1126USDC: 0x8a2...efInbox: [email protected]MCP: mcp.agentwallet.ai/wlt_8Hk29p

$ aw logs wlt_8Hk29p --tail

[info] 10:42:01 Policy evaluated: pass

[auth] 10:42:02 AP2 signature verified (user_yk_42)

[info] 10:42:03 Payment cleared: $18.00 to OpenAI

[deny] 10:45:11 Velocity cap exceeded: daily limit ($2,500)

aw logs

Tail the immutable audit logs for an agent to see every transaction, policy evaluation, and principal signature in real-time. Crucial for debugging MCP tool calls.

Flags: --tail, --since, --level

aw policy & approvals

Mutate spending caps and merchant rules on the fly. Review queued approvals directly from the shell without logging into the dashboard.

aw policy set [wallet_id]

aw approvals list | approve | deny

$ aw policy set wlt_8Hk29p --daily-usd 500

✓ Policy updated to $500/day

$ aw approvals list

Pending [app_91x]: $1,200 to AWS (requires force-approve)

$ aw approvals approve app_91x --force

✓ Approved via override (signed by [email protected])

Full Command Surface

aw fleet list

List all active agent wallets

aw card create

Issue a new virtual PAN

aw spend

Execute a manual test payment

aw inbox list

Read agent emails & OTPs

aw mandate sign

Sign an AP2 scope

aw mcp tail

Watch raw MCP JSON-RPC

Configuration & CI/CD

1Environment Variables

The CLI respects standard environment variables for CI/CD automation.

Variable	Description
AW_API_KEY	Your secret API key (req for CI)
AW_WORKSPACE	Target workspace ID
AW_FORMAT	`json` or `text` (default)

2GitHub Actions YAML

Automate wallet provisioning as part of your agent deployment pipeline.

steps:

- name: Install AgentWallet CLI

run: npm i -g @agentwallet/cli

- name: Provision Agent Wallet

env:

AW_API_KEY: ${{ secrets.AW_API_KEY }}

run: |

WALLET_ID=$(aw provision --agent $GITHUB_SHA --format json | jq -r .id)

echo "WALLET_ID=$WALLET_ID" >> $GITHUB_ENV

Compare us to the alternatives.

Compare to Link →Compare to Circle →