> ## Documentation Index
> Fetch the complete documentation index at: https://aomi.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> What an Aomi App is, the four steps from idea to live, and where to start.

An Aomi App turns your API into tools an AI agent can call inside a real chat. Follow this section and you will ship one, with the agent calling your tool on demand.

## What is an Aomi App?

An App is a small Rust plugin. You wrap your API as a set of tools, compile it to a shared library, and the Aomi runtime loads it while it is running. No restart.

You write the tools. The platform handles the hard parts:

* **non-custodial wallets.** Your users keep their own keys. Your App never holds them.
* **simulate first.** Every transaction is simulated before anyone signs, so the agent shows the real outcome before it commits.

You declare the App with one macro, `dyn_aomi_app!`, and one config file, `aomi.toml`. That is the whole contract.

## From idea to live in four steps

```mermaid theme={null}
graph LR
    A[1. Write] --> B[2. Build] --> C[3. Deploy] --> D[4. Activate]
```

1. **Write** your tools in a Rust crate with `aomi.toml` and `src/lib.rs`.
2. **Build** it with `cargo build --release`.
3. **Deploy** with `aomi-build deploy`. The backend builds your plugin and cuts a release.
4. **Activate** with `aomi-build activate`, using your activation token. Your App loads onto the live runtime.

The [Quickstart](/docs/build/quickstart) walks all four end to end in about ten minutes.

## Start here

<CardGroup cols={2}>
  <Card title="Quickstart" href="/docs/build/quickstart">
    Ship your first App, start to finish.
  </Card>

  <Card title="Building an App" href="/docs/reference/building-apps">
    The anatomy: the macro, the tools, and `aomi.toml`.
  </Card>

  <Card title="The SDK" href="/docs/reference/sdk-api">
    The Rust plugin SDK you build your tools against.
  </Card>

  <Card title="The builder toolchain" href="/docs/reference/cli-toolchain">
    The two binaries: `aomi-build` and `aomi-run`.
  </Card>

  <Card title="Deploy and activate" href="/docs/build/deploy-cli">
    The full shipping process when the quickstart is not enough.
  </Card>

  <Card title="Use the client CLI" href="/docs/reference/cli">
    Chat with your App from the terminal.
  </Card>
</CardGroup>