CLI

Monitor your agents from the terminal. Same data as the dashboard, piped into stdout.

Install

npm i -g @chainward/cli

Authentication

chainward login

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

Go to chainward.ai
Connect your wallet
Open Settings → Generate Key
Paste the ag_ key when prompted

Keys are stored locally at ~/.chainward/config.json. Run chainward login again any time to replace the key.

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"

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. Delete the file to wipe your local session, or run chainward login to replace the key.