agnic

CLI for AgnicPay — AI agent wallet for x402 API access, AI gateway, and on-chain identity.

Install

npm install -g agnic

Or run directly:

npx agnic@latest --help

Quick Start

# Login via browser (OAuth2 + PKCE)
agnic auth login

# Check balance
agnic balance

# Search x402 APIs
agnic x402 search "sentiment analysis"

# Pay for an x402 API
agnic x402 pay https://api.example.com/data

# Chat with an AI model
agnic ai chat --model openai/gpt-4o --prompt "Explain quantum computing"

# Generate an image
agnic ai image --prompt "A sunset over mountains" --output sunset.png

# Check agent identity
agnic agent-identity

Authentication

Three methods (in priority order):

| Method | Example | |--------|---------| | --token flag | agnic balance --token agnic_tok_sk_live_... | | AGNIC_TOKEN env var | export AGNIC_TOKEN=agnic_tok_sk_live_... | | OAuth login | agnic auth login (opens browser) |

Tokens are stored at ~/.agnic/config.json with 0600 permissions.

Commands

| Command | Description | |---------|-------------| | agnic auth login | Login via browser (OAuth2 + PKCE) | | agnic auth logout | Remove stored credentials | | agnic status | Check auth and wallet status | | agnic balance | Check USDC balance | | agnic address | Show wallet address | | agnic x402 search <query> | Search x402-enabled APIs | | agnic x402 pay <url> | Make an x402 payment request | | agnic ai models | List 340+ available AI models | | agnic ai chat | Chat with any AI model | | agnic ai image | Generate an image with AI | | agnic agent-identity | Show ERC-8004 identity and trust score | | agnic email address | Show agent email address | | agnic email setup | Create agent email alias | | agnic email inbox | Check agent inbox | | agnic email send | Send email from agent | | agnic email reply | Reply to an inbox message |

All commands support --json for machine-readable output.

AI Gateway

# List models (filter by provider)
agnic ai models --provider openai
agnic ai models --search llama

# Chat with any model
agnic ai chat --model openai/gpt-4o --prompt "Hello world"
agnic ai chat --model meta-llama/llama-3.3-70b --prompt "Summarize this" --json

# Generate images
agnic ai image --prompt "A cat in space" --output cat.png
agnic ai image --prompt "Logo design" --model openai/gpt-5-image --aspect-ratio 16:9 --output logo.png

Image models: google/gemini-2.5-flash-image (default), google/gemini-3-pro-image-preview, openai/gpt-5-image, black-forest-labs/flux.2-max, black-forest-labs/flux.2-klein-4b

x402 Options

agnic x402 search "weather" --category Data --limit 5
agnic x402 pay https://api.example.com/data --method POST --body '{"query":"test"}'

Example: Agent Script

#!/bin/bash
BALANCE=$(agnic balance --network base --json | jq -r '.[0].balance')
echo "Balance: $BALANCE USDC"

agnic ai chat --model openai/gpt-4o --prompt "What is the weather like?" --json
agnic ai image --prompt "Weather forecast visualization" --output forecast.png
agnic x402 pay https://api.example.com/analysis --json

Documentation

Full docs at docs.agnic.ai/docs/agnicpay-features/cli

License

MIT