CLI

Monitor your agents from the terminal: the same data as the dashboard, printed to your shell. You need Node.js and a ChainWard API key.

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 and sign in
Open Settings, click Generate key, give it read and write scopes (write is needed to add or remove agents and create alerts), then Create 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, transactions and gas spend in the last 24 hours, and 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 wallet on Base for monitoring. Indexing starts right away. If the address is a contract rather than a wallet, the CLI asks you to confirm.

chainward agents remove <address>

Stop monitoring an agent. Confirms before removing.

chainward txs

List recent transactions across all agents, with Basescan links you can click in terminals that support them.

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

Create an alert step by step: pick the agent, the alert type, the threshold and the delivery channel. Inactivity alerts can't be created from the CLI yet (the API rejects the request); create those in the dashboard.

chainward watch

Live transaction feed. Checks 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.