Skip to main content
The fastest way to use Aomi is the aomi command in your terminal. It ships in the @aomi-labs/client package, talks to a running Aomi backend, and lets you chat, simulate, and sign transactions without writing any code.

Install

npm install -g @aomi-labs/client
aomi --version
After a global install, run every command as aomi <command>.

Verify

Check the version, then send your first prompt.
aomi --version            # needs >= 0.1.30
aomi --prompt "what is the price of ETH?"
If you get a price back, the install works and you are talking to the backend.

Try a trade

A trade is a short, three part loop: chat to build the transaction, simulate it, then sign it. Pass --public-key so the agent knows your wallet address and can build the transaction.
1

Chat to queue the transaction

aomi chat "swap 1 ETH for USDC" --public-key 0xYourAddress
When the agent needs a signature, the request is queued locally as tx-1.
2

List pending transactions

aomi tx list
You see tx-1 with its destination, value, and chain.
3

Simulate before you sign

aomi tx simulate tx-1
This runs the transaction on a forked chain so you see the outcome before any funds move.
4

Sign and submit

aomi tx sign tx-1 --private-key 0xYourPrivateKey
The CLI signs, submits, prints the hash, and tells the backend.
That is the whole flow. For the full command surface, see the CLI reference. For how a trade moves from prompt to onchain, see Trade execution.
You can now use Aomi from your terminal: chat with the agent, simulate transactions, and sign them.

Next steps

Build your own App

Scaffold an Agentic Application with the Rust SDK and ship it.

Trade by chat

Learn the full trade flow: swaps, transfers, and simulation.

Add the chat widget

Drop the Aomi chat widget into a frontend.
Last modified on June 4, 2026