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, Cline, Cursor, Windsurf)

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

Option A: Headless (CI, servers, AI agents)

Generate an API token at app.agnic.ai > Settings > API Tokens:

export AGNIC_TOKEN=<your-api-token>
npx agnic@latest status --json

All commands in the session authenticate automatically. No browser required.

Option B: Browser OAuth (interactive terminals)

npx agnic@latest auth login

This command:

1. Opens your default browser to Agnic'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 --json

Expected output:

{
  "authenticated": true,
  "userId": "did:privy:...",
  "email": "[email protected]",
  "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7",
  "tokenExpiry": "2026-05-22T14:30:00Z"
}

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. Access an x402 API

Search the bazaar for a service:

npx agnic@latest x402 bazaar search "weather"

Make a request:

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

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

5. 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