> ## Documentation Index
> Fetch the complete documentation index at: https://aomilabs-victor-docs-redirect-build-overview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Use the CLI

> Start using Aomi from your terminal with the @aomi-labs/client package and the aomi command: install, verify, and run your first chat and trade.

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

<Tabs>
  <Tab title="Global (npm)">
    ```bash theme={null}
    npm install -g @aomi-labs/client
    aomi --version
    ```

    After a global install, run every command as `aomi <command>`.
  </Tab>

  <Tab title="Run once (npx)">
    ```bash theme={null}
    npx @aomi-labs/client --version
    ```

    No install. Substitute `npx @aomi-labs/client` everywhere this guide writes `aomi`.
  </Tab>

  <Tab title="pnpm">
    ```bash theme={null}
    pnpm add @aomi-labs/client
    pnpm exec aomi --version
    ```
  </Tab>
</Tabs>

## Verify

Check the version, then send your first prompt.

```bash theme={null}
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.

<Steps>
  <Step title="Chat to queue the transaction">
    ```bash theme={null}
    aomi chat "swap 1 ETH for USDC" --public-key 0xYourAddress
    ```

    When the agent needs a signature, the request is queued locally as `tx-1`.
  </Step>

  <Step title="List pending transactions">
    ```bash theme={null}
    aomi tx list
    ```

    You see `tx-1` with its destination, value, and chain.
  </Step>

  <Step title="Simulate before you sign">
    ```bash theme={null}
    aomi tx simulate tx-1
    ```

    This runs the transaction on a forked chain so you see the outcome before any funds move.
  </Step>

  <Step title="Sign and submit">
    ```bash theme={null}
    aomi tx sign tx-1 --private-key 0xYourPrivateKey
    ```

    The CLI signs, submits, prints the hash, and tells the backend.
  </Step>
</Steps>

That is the whole flow. For the full command surface, see the [CLI reference](/reference/cli). For how a trade moves from prompt to onchain, see [Trade execution](/trade/execution).

<Check>
  You can now use Aomi from your terminal: chat with the agent, simulate transactions, and sign them.
</Check>

## Next steps

<CardGroup cols={3}>
  <Card title="Build your own App" href="/build/quickstart" icon="cube">
    Scaffold an Agentic Application with the Rust SDK and ship it.
  </Card>

  <Card title="Trade by chat" href="/trade/index" icon="arrows-rotate">
    Learn the full trade flow: swaps, transfers, and simulation.
  </Card>

  <Card title="Add the chat widget" href="/guides/frontend-setup" icon="window">
    Drop the Aomi chat widget into a frontend.
  </Card>
</CardGroup>