> ## 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.

# Integration recipes

> Copy practical Agent, Pipeline, OAuth, wallet, React, and widget patterns into an Aomi integration.

Recipes are runnable developer integrations. For examples of products already built with Aomi, see [Case studies](/docs/examples/overview).

## Headless TypeScript

<CardGroup cols={2}>
  <Card title="Guest Agent" icon="message" href="/docs/integrate/client-sdk#quickstart">
    Make two stateful Node.js turns without configuring OAuth.
  </Card>

  <Card title="Agent events" icon="wave-square" href="/docs/integrate/agent#observe-a-run">
    Render action revisions, simulation evidence, and completion.
  </Card>

  <Card title="Pipeline Build" icon="diagram-project" href="/docs/integrate/pipeline#build-a-transaction-with-pipeline">
    Discover an operation, validate arguments, simulate, and review.
  </Card>

  <Card title="Device OAuth" icon="key" href="/docs/integrate/authentication#oauth-for-a-service-or-cli">
    Authorize a CLI, bot, or server process with a public client.
  </Card>
</CardGroup>

## Signing and UI

<CardGroup cols={2}>
  <Card title="Manual wallet approval" icon="signature" href="/docs/integrate/actions-and-signing#review-an-agent-request">
    Keep the request visible and resolve it only after user approval.
  </Card>

  <Card title="Custom React UI" icon="react" href="/docs/integrate/ui/headless-library">
    Compose your own chat, thread, and action components.
  </Card>

  <Card title="Widget integration" icon="window" href="/docs/integrate/ui/widget">
    Embed the complete interface with origin-bound authentication.
  </Card>

  <Card title="Raw HTTP" icon="code" href="/docs/api-reference/agent">
    Use exact-resource OAuth from a non-TypeScript service.
  </Card>
</CardGroup>

## Runnable source

The Aomi repository contains complete examples under [`apps/examples`](https://github.com/aomi-labs/aomi/tree/main/apps/examples):

* `headless-client/src/agent/guest.ts`
* `headless-client/src/pipeline/guest.ts`
* `headless-client/src/walkthrough.ts`
* `headless-client/src/oauth/device.ts`
* `headless-client/src/oauth/supplied-token.ts`
* `headless-client/src/wallet-terminal.ts`

The widget consumer example lives one level up, at [`apps/widget-consumer`](https://github.com/aomi-labs/aomi/tree/main/apps/widget-consumer).

Use the tag matching your installed `@aomi-labs/client` version. Avoid copying examples from an unreleased branch into production code.