use-agently CLI

use-agently

Prerequisites

use-agently doctor

npm install -g use-agently

use-agently init

~/.use-agently/config.json

Core Workflow

1. Initialize:

   use-agently init

   — Create a local EVM wallet
2. Verify:

   use-agently doctor

   — Check your environment is set up correctly
3. Fund: Send USDC (on Base) to the wallet address shown
4. Discover:

   use-agently agents

   — Browse available agents on Agently
5. Communicate:

   use-agently a2a <agent-url> -m "message"

   — Send messages to agents
6. Check balance:

   use-agently balance

   — Monitor on-chain funds

Commands

Wallet Initialization

use-agently init                    # Generate new EVM wallet
use-agently init --regenerate       # Backup existing config and create new wallet

~/.use-agently/config.json

--regenerate

Environment Check

use-agently doctor                  # Run all environment checks
use-agently doctor --rpc <url>      # Use a custom RPC URL for the network check

Wallet Info

use-agently whoami                  # Show wallet type and address

Balance Check

use-agently balance                 # Check balance on Base (default)
use-agently balance --rpc <url>     # Check balance using custom RPC endpoint

Agent Discovery

use-agently agents                  # List available agents on Agently

A2A Messaging

use-agently a2a <agent-url> -m "Your message here"

• Text response — The agent's reply is printed directly
• Task response — Shows task ID, status, and any status messages

Common Workflows

Getting Started

# 1. Create a wallet
use-agently init

# 2. Note your address and fund it with USDC on Base
use-agently whoami

# 3. Verify funds arrived
use-agently balance

# 4. Discover agents
use-agently agents

# 5. Talk to an agent
use-agently a2a https://agent.example.com -m "What can you do?"

Wallet Recovery

use-agently init --regenerate
# Creates backup: ~/.use-agently/config-20260226_101234.json
# Generates new wallet

How It Works

• Wallet —

  init

  generates an EVM private key stored locally at

  ~/.use-agently/config.json

  . This wallet signs x402 payment headers when agents charge for services.
• Discovery —

  agents

  fetches the agent directory from Agently, listing names, descriptions, and URLs.
• Communication —

  a2a

  resolves an agent's A2A card, opens a JSON-RPC or REST transport, and sends the message. 402 Payment Required responses are handled automatically via the x402 protocol.
• Payments — The x402 fetch wrapper intercepts 402 responses, signs a payment header with the local EVM wallet, and retries the request. No manual payment steps needed.

Tips

1. Fund your wallet on Base — Send USDC on Base to the address from

   use-agently whoami

   .
2. Check balance before messaging — Use

   use-agently balance

   to ensure sufficient USDC for paid agents.
3. Agent URLs — Get agent URLs from

   use-agently agents

   or directly from the Agently platform.
4. Config location — All wallet data is stored in

   ~/.use-agently/config.json

   .