CLI Commands Reference

Full reference for aep CLI commands.

Account

CommandDescription
aep deployDeploy a new AEP account
aep addressGet predicted account address
aep balanceGet account deposit (EntryPoint balance)
aep freezeFreeze account (blocks all operations)
aep unfreezeUnfreeze account

deploy

aep deploy --factory <address> [--owner <address>] [--salt <hex>] [-r <rpc>] [-k <private-key>]

Deploy a new AEP account. Owner derived from PRIVATE_KEY when --owner omitted.

address

aep address --factory <address> [--owner <address>] [--salt <hex>] [-r <rpc>]

Get predicted CREATE2 address before deploy.


Config

CommandDescription
aep config validateValidate ~/.aep/config.json

Policy

CommandDescription
aep modulesList policy module addresses
aep policy-getGet BudgetPolicy state (caps and spend)
aep policy-setSet BudgetPolicy caps (owner only)
aep rate-limitRateLimitPolicy configuration
aep counterpartyCounterpartyPolicy (allowlist, blocklist, min-reputation)
aep check-policyCheck if payment would pass policy (x402)

policy-set

aep policy-set -m <module> --max-per-tx <n> --max-daily <n> [--max-weekly <n>] [--full --max-per-task <n> --task-window <s>]

rate-limit set

aep rate-limit set -m <module> --max-tx <n> --window-seconds <s>

counterparty

Subcommands: add-block, remove-block, add-allow, remove-allow, set-use-allow-list, set-use-agent-allow-list, set-min-reputation, add-agent-allow, clear-agent-allow, add-verified-agent, remove-verified-agent.


Execution

CommandDescription
aep executeBuild, sign, submit UserOp via bundler
aep execute -t <recipient> -v <amount> -d <calldata> [--bundler <url>]

Intent Resolution

CommandDescription
aep resolveResolve intent to execution plan
aep resolve '{"capability":"image-generation","budget":{"max_per_unit":"0.01","max_total":"1.00"}}'

Use --api-url <url> to call a remote REST API (x402 paywall if that server has treasury configured).


Graph & Analytics

CommandDescription
aep graph syncSync economic graph to SQLite
aep analyticsAccount analytics
aep credit-scoreCredit score for account
aep recommendationsProvider recommendations

Fleet

CommandDescription
aep fleet listList configured fleets
aep fleet summary <id>Fleet aggregate analytics
aep fleet alerts <id>Fleet on-chain alerts
aep fleet freeze <id>Freeze all accounts in fleet

Monitor

CommandDescription
aep monitorOn-chain event monitoring

Watches for Frozen, DefaultDeclared, BreachDeclared, PolicyRecordSpendFailed, UserOperationRevertReason. Optional webhook POST via config.


Economic Relationships

CommandDescription
aep creditCredit facility (create, deposit, draw, repay, etc.)
aep escrowConditional escrow (create, fund, release, etc.)
aep splitterRevenue splitter (create, distribute)
aep slaSLA contract (create, stake, declare breach, unstake)

Provider

CommandDescription
aep provider probe <url>Probe provider x402 endpoint
aep provider probe --agent-id <id>Probe by ERC-8004 agent ID

Global Options

OptionDescription
-r, --rpc <url>RPC URL
-k, --private-key <key>Private key (env: PRIVATE_KEY)