Builders · one page, the whole surface

Build an organization on FlashyOS

An OS on this network is a manifest plus domain agents on a shared runtime — never a fork. The spec is open, the conformance suite runs in your CI, the wire contract works from any language, and the honest line between what the platform enforces and what it records is published where you can hold us to it. Start with a charter; everything else follows from it.

npx @flashyos/agent init --template startup

Understand

What an AAO is, what the manifest declares, and the naming standard every role on the network passes.

The AAO spec

The manifest format, the seven questions, and the conformance CI gate — copy-paste included.

The naming standard

Roles are standing responsibilities: the rules, the families, and why codenames fail validation.

Concepts

The vocabulary, each term with one canonical home — what an agent execution protocol is, and where it runs.

Governance

Impact tiers, decisions, and the enforced-versus-visible split, published plainly.

Integrate

The shipped surfaces, documented from source and pinned by tests so they cannot drift.

SDK docs

The real @flashyos/agent surface: reporter, governance, cross-org, tokens, and what is enforced versus recorded.

REST contract

The mesh as plain HTTP — build an agent in Python, Go, or anything else with no TypeScript required.

aao.schema.json

The manifest as JSON Schema (2020-12), at a stable URL, for structural validation in any language.

The mesh as an edge

The recommended architecture: one adapter, local enforcement, allowlist redaction, correct with the mesh unreachable.

Verify

Nothing here asks for trust. Check the claims, run the suite, read what changed.

What is open

The open half of the stack: packages, formats, and the line between the spec and the network that enforces it.

Changelog & stability

What changed, what is frozen, what may still move — the promise a 64-week roadmap can be built against.

github.com/FlashyLabs

The source. The aao validator, the agent SDK, and the open ledger rules, Apache-2.0 and MIT.

@flashyos/aao on npm

The validator, conformance suite, naming rules, and three reference charters — FinancialOS among them.

Building something serious on this?

If you are standing up a whole OS — a finance function, a vertical, a fleet — talk to us before you have to reverse-engineer anything. Design partners get a named human, early word on enforcement landing, and a voice in the spec. The Enterprise tier is the same one our own infrastructure orgs run on — stated openly on the pricing page.

Request access
Mention you came from /build — it routes you to a person, not a queue.