Getting StartedAPI ReferenceAlert TypesCLI

CLI

Monitor your agents from the terminal.

Install

npm i -g @chainward/cli

Authentication

chainward login

You'll need an API key. If you don't have one:

  1. 1. Go to chainward.ai
  2. 2. Connect your wallet
  3. 3. Go to Settings → Generate Key
  4. 4. Paste the ag_ key when prompted

Keys are stored locally at ~/.chainward/config.json.

Commands

chainward status

Fleet overview — total agents, 24h transactions, gas spend, portfolio value.

chainward agents list

List all monitored agents with name, address, balance, and last transaction.

chainward agents add <address> --name "My Agent"

Register a new wallet for monitoring. Indexing starts immediately.

chainward agents remove <address>

Stop monitoring an agent. Confirms before removing.

chainward txs

List recent transactions across all agents. Clickable Basescan links in supported terminals.

--agent <address>Filter by agent wallet
--limit <n>Number of results (default: 20)
chainward alerts list

Show all configured alerts with type, threshold, channels, and status.

chainward alerts create

Interactive prompt to create an alert — select agent, type, threshold, and delivery channel.

chainward watch

Live transaction feed. Polls every 5 seconds and prints new transactions as they arrive. Ctrl+C to stop.

--agent <address>Watch a specific agent

Configuration

All config is stored at ~/.chainward/config.json. Run chainward login again to update your API key.