@economicagents/cli

Command-line interface for the Agent Economic Protocol (AEP): deploy accounts, policies, resolution, relationships, fleet, and monitoring.

Install

pnpm add -g @economicagents/cli

The aep binary is added to your PATH.

From a local clone of economicagents/AEP: cd packages/cli && pnpm run build, then run node dist/cli.js or pnpm exec aep from the repo root.

Configuration

Config: ~/.aep/config.json. Override: AEP_CONFIG_PATH, AEP_CHAIN_ID.

Required keys: factoryAddress, rpcUrl, account (after deploy). Optional: bundlerRpcUrl, indexPath, identityRegistryAddress, reputationRegistryAddress, relationship factory addresses, monitor, fleets.

Commands

| Command | Description | |---------|-------------| | aep deploy | Deploy a new AEP account | | aep address | Get predicted account address | | aep config validate | Validate ~/.aep/config.json | | aep balance | Get account deposit (EntryPoint balance) | | aep check-policy | Check if payment would pass policy (x402) | | aep freeze | Freeze account (blocks all operations) | | aep unfreeze | Unfreeze account | | aep modules | List policy module addresses | | aep policy-get | Get BudgetPolicy state (caps and spend) | | aep policy-set | Set BudgetPolicy caps (owner only) | | aep rate-limit | RateLimitPolicy configuration | | aep counterparty | CounterpartyPolicy (allowlist, blocklist, min-reputation) | | aep execute | Build, sign, submit UserOp via bundler | | aep resolve | Resolve intent to execution plan | | aep graph sync | Sync economic graph to SQLite | | aep analytics | Account analytics | | aep credit-score | Credit score for account | | aep recommendations | Provider recommendations | | aep fleet list/summary/alerts/freeze | Fleet management | | aep monitor | On-chain event monitoring | | aep credit/escrow/splitter/sla | Economic relationship commands | | aep provider probe | Probe provider x402 endpoint |

Usage

aep deploy -f 0x...Factory -n <keystore_name>
aep policy-set -m <module> --max-per-tx 1000000 --max-daily 5000000
aep check-policy -c 0xSmartAccount -a 500000 -t 0xRecipient
aep resolve -c "capability description"
aep resolve --intent-file ./intent.json
aep --json balance -a 0x...   # machine-readable stdout
export AEP_KEYSTORE_PASSWORD_FILE=/secure/path   # or pass on each run (see aep --help)
aep fleet list
aep monitor

Non-interactive signers: set AEP_KEYSTORE_ACCOUNT, FOUNDRY_PASSWORD or AEP_KEYSTORE_PASSWORD, or AEP_KEYSTORE_PASSWORD_FILE (see global aep --help), or PRIVATE_KEY (not recommended).

Build & test

pnpm run build
pnpm run test

Documentation

• Cookbook — Quick reference, policies
• Deployment — Networks, validation, services