aomi documentation
SaferSkills independently audited docs (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Documentation for Aomi — the blockchain harness for agentic AI.
The docs are organized into six sections. Read them in order if you're new, or jump to what you need.
Quickstart for end users:
| Page | What it covers |
|---|---|
getting-started/quickstart.mdx | Install AomiFrame in a Next.js app, set env vars, run |
getting-started/web-app.mdx | Use Aomi at chat.aomi.dev — composer, control bar, threads |
getting-started/telegram.mdx | @aomi_sendit_bot — slash commands, panels, wallet |
getting-started/discord.mdx | Discord bot (coming soon) |
getting-started/ios.mdx | iOS app (coming soon) |
getting-started/playground.mdx | Live AomiFrame configurator |
Integration walkthroughs for builders:
| Page | What it covers |
|---|---|
guides/integration.mdx | Full-stack pipeline — APIs → tools → app → deploy |
guides/frontend-setup.mdx | Widget install walkthrough — shadcn, env vars, AomiFrame, layout |
guides/widget-installation.mdx | shadcn registry install, compound components, control bar |
guides/widget/aomi-frame.mdx | AomiFrame props, compound API, layout diagram |
guides/widget/components.mdx | Catalog of all registry components |
guides/widget/configuration.mdx | Env vars, props, control state, backend endpoints |
guides/widget/theming.mdx | CSS variables, dark mode, customizations |
guides/headless-library.mdx | @aomi-labs/react full reference — providers, hooks, API client, BackendApi |
guides/headless/hooks.mdx | Full API reference — useAomiRuntime, useUser, useControl, etc. |
guides/headless/build-custom-ui.mdx | Tutorial: message list, input, thread switcher |
guides/cli-usage.mdx | aomi chat, app, model, chain, session commands |
guides/custom-tools.mdx | Rust SDK tool macro, registration, scheduler |
guides/evals-testing.mdx | Testing layers — tool unit tests, test.json e2e journeys, smoke tests, AomiBench |
guides/execution.mdx | Transaction lifecycle — Anvil forks, simulation, wallet integration |
guides/script-generation.mdx | ForgeExecutor, ExecutionPlan, SourceFetcher, ScriptAssembler |
guides/troubleshooting.mdx | Common CLI, execution, UI, and API issues |
Architectural deep-dives:
| Page | What it covers |
|---|---|
concepts/what-is-aomi.mdx | Agentic Applications, auth, safety defaults |
concepts/how-it-works.mdx | Full platform pipeline — APIs → tools → deploy → request flow |
concepts/architecture.mdx | Platform overview, transaction pipeline, integration paths |
concepts/non-custodial-wallets.mdx | Simulation-first flow, Para/wagmi setup, wallet integration code |
concepts/key-concepts.mdx | Core concepts explained concisely |
Real-world integrations:
| Page | What it covers |
|---|---|
examples/polymarket.mdx | Prediction market tools (Gamma, Data API, CLOB) |
examples/defi-aggregators.mdx | DeFi tools (DefiLlama, 0x, LI.FI, CoW) |
examples/x-apis.mdx | X API v2 tools (search, timeline, trends) |
examples/metamask.mdx | Embedding Aomi in wallet UIs (coming soon) |
Full API, CLI, SDK, and protocol reference:
| Page | What it covers |
|---|---|
reference/sdk-api.mdx | ChatAppBuilder, streaming, ChatCommand variants, SystemEventQueue, custom tools, multi-step tools |
reference/cli.mdx | Full CLI reference — commands, secrets, signing modes, session state, all flags |
reference/simulation.mdx | Anvil forks, ForkProvider, batch simulation |
reference/account-abstraction.mdx | Session keys, gas sponsorship, ERC-4337 |
reference/runtime.mdx | App turn lifecycle, model/tool loop, transaction harness, wallet callbacks, SSE streaming |
| Page | What it covers |
|---|---|
resources/changelog.mdx | Platform changelog |
resources/faq.mdx | Frequently asked questions |
docs.aomi.dev/
├── docs.json # Navigation + theme config
├── index.mdx # Landing page
├── getting-started/
│ ├── quickstart.mdx
│ ├── playground.mdx
│ ├── web-app.mdx
│ ├── telegram.mdx
│ ├── discord.mdx
│ └── ios.mdx
├── guides/
│ ├── integration.mdx
│ ├── frontend-setup.mdx
│ ├── widget-installation.mdx
│ ├── widget/
│ │ ├── aomi-frame.mdx
│ │ ├── components.mdx
│ │ ├── configuration.mdx
│ │ └── theming.mdx
│ ├── headless-library.mdx
│ ├── headless/
│ │ ├── hooks.mdx
│ │ └── build-custom-ui.mdx
│ ├── cli-usage.mdx
│ ├── custom-tools.mdx
│ ├── evals-testing.mdx
│ ├── execution.mdx
│ ├── script-generation.mdx
│ └── troubleshooting.mdx
├── concepts/
│ ├── what-is-aomi.mdx
│ ├── how-it-works.mdx
│ ├── architecture.mdx
│ ├── non-custodial-wallets.mdx
│ └── key-concepts.mdx
├── examples/
│ ├── index.mdx
│ ├── polymarket.mdx
│ ├── defi-aggregators.mdx
│ ├── x-apis.mdx
│ └── metamask.mdx
├── reference/
│ ├── api-reference.mdx
│ ├── sessions.mdx
│ ├── building-apps.mdx
│ ├── apps-auth.mdx
│ ├── sdk-api.mdx
│ ├── cli.mdx
│ ├── simulation.mdx
│ ├── account-abstraction.mdx
│ └── runtime.mdx
├── resources/
│ ├── changelog.mdx
│ └── faq.mdx
├── images/
│ ├── architecture-overview.png
│ └── runtime-architecture.png
└── logo/
├── light.svg
└── dark.svgnpm i -g mint
mint devPreview at http://localhost:3000.
All content is in .mdx files with YAML frontmatter. Navigation is driven by docs.json.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.