Quickstart

Get your AI agent transacting in 5 minutes. This guide covers installation, authentication, and your first wallet operations.

Prerequisites

• Node.js 18+ installed
• An AI assistant that supports skills (e.g., Claude Code, Vercel AI SDK agents)

1. Install the Skills

Add the Agentic Wallet skills to your AI assistant:

npx skills add agnicpay/agnic-wallet-skills

This installs 8 skills that teach your agent how to use the agnic CLI for wallet operations.

2. Authenticate

Your agent authenticates via browser-based OAuth:

npx agnic@latest auth login

This command:

1. Opens your default browser to AgnicPay's OAuth consent screen
2. You sign in (email, Google, or wallet) and approve spending limits
3. The browser redirects back and the CLI saves tokens locally

Wait for Authenticated! before proceeding.

Verify Authentication

npx agnic@latest status

Expected output:

Wallet Status
Authenticated

Email:    [email protected]
Wallet:   0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
Expires:  2026-05-22 14:30:00 UTC

3. Check Your Balance

npx agnic@latest balance

Network       Balance      Address
base          125.50 USDC  0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
base-sepolia    0.00 USDC  0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
solana          0.00 USDC  N/A
solana-devnet   0.00 USDC  N/A

If your balance is zero, see the Fund Wallet skill for funding instructions.

4. Send USDC

Send $1 USDC to an address:

npx agnic@latest send 1 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7

Or to an ENS name:

npx agnic@latest send 0.50 vitalik.eth

5. Trade Tokens

Swap $1 USDC for ETH on Base:

npx agnic@latest trade '$1' usdc eth

Swap 0.01 ETH back to USDC:

npx agnic@latest trade 0.01 eth usdc

6. Pay for an x402 API

Search the bazaar for a service:

npx agnic@latest x402 bazaar search "weather"

Pay for a request:

npx agnic@latest x402 pay https://api.example.com/weather --json

The CLI auto-detects the price, signs a USDC payment, and returns the API response.

7. Check Agent Identity

View your agent's on-chain ERC-8004 identity:

npx agnic@latest agent-identity --json

{
  "agentId": 373,
  "ownerAddress": "0x046906b3cd9d73bf85eb01d795d333b364b75842",
  "status": "active",
  "trustScore": 85,
  "categories": ["payment", "general"],
  "hasDelegation": true
}

Next Steps