Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@economicagents/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@economicagents/cli
Command-line interface for the Agent Economic Protocol (AEP): deploy accounts, policies, resolution, relationships, fleet, and monitoring.
Install
pnpm add -g @economicagents/cliThe 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 monitorNon-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 testDocumentation
- Cookbook — Quick reference, policies
- Deployment — Networks, validation, services