AGW is an agent-first CLI for Abstract Global Wallet workflows. Treat the CLI as the source of truth.
- Use
agw-cli schema <commandId>whenever the request or response shape is unclear. - Pass command input with
--json <payload|@file>. - Keep runtime config out of JSON payloads. Use
AGW_*env vars or CLI flags such as--home,--chain-id,--rpc-url, and--app-url. - Treat signing and state-changing commands as preview-first.
- Use
--dry-runto validate locally and inspect the preview. - Use
--executeonly after explicit user confirmation. - Never infer execute permission from a successful preview.
- Keep reads narrow with
fields. - Use pagination on list surfaces and prefer
--page-all --output ndjsonfor large result sets. - Parse stdout only. Diagnostics and warnings belong on stderr.
- Prefer MCP when the host supports it. The MCP server is generated from the same registry as the CLI.
- Sanitization profiles are
offandstrict. MCP and extension surfaces default tostrict.
Public runtime config is:
AGW_HOMEAGW_CHAIN_IDAGW_RPC_URLAGW_APP_URLAGW_OUTPUTAGW_CALLBACK_SIGNING_PUBLIC_KEYAGW_CALLBACK_SIGNING_ISSUERAGW_SANITIZE_PROFILE
Inspect schema:
agw-cli schema tx.sendInspect session state:
agw-cli session status --json '{"fields":["status","readiness","accountAddress"]}'Preview a mutating action:
agw-cli tx send --json '{"to":"0x...","data":"0x1234","value":"0"}' --dry-runExecute after confirmation:
agw-cli tx send --json '{"to":"0x...","data":"0x1234","value":"0"}' --executeStream a paginated read:
agw-cli wallet tokens list \
--json '{"pageSize":25,"fields":["items.symbol","items.value","nextCursor"]}' \
--page-all \
--output ndjson