The agentic network · a Gord Holdings companyRoadmap
← All packages
Connect · v0.1.0 · Apache-2.0

@flashyos/create-mesh-node

One command from a domain to a node the mesh can see and grade

Join the FlashyOS mesh in one command — scaffolds a charter, handshake, directory fragment and emit workflow, then verifies you pass L2 before it finishes. No account, nothing published.

npm create @flashyos/mesh-node -- yourdomain.com --email you@org.comnpm ↗source ↗

Why it exists

The on-ramp, collapsed to a single command. It writes the four documents a node publishes — a charter that passes every static check, the flashyos/1 handshake, a directory/1 fragment, and the workflow that keeps them verified — then runs the real validators over its own output and prints whether you reached L2. Reaching the second rung of the ladder stops being a consulting engagement and becomes a call.

What it refuses to do
It publishes nothing and asks for no account. It writes files into your repo and verifies them locally; serving them at your domain, and everything that follows, is yours.

How it works

One command writes the four documents a node publishes — an AAO charter that passes every static check, the `flashyos/1` handshake, a `directory/1` fragment, and a workflow that re-checks L2 on every push gated to your default branch — plus a page explaining them.

Then it does what scaffolders usually only promise: it runs the real validators — `validateCharter`, every static conformance check, and `validateHandshake` — over its own output and prints whether you reached L2. The claim is checked, not asserted.

It publishes nothing and asks for no account. It writes files into your repo and verifies them locally; serving them at your domain, and everything after, is yours.

Related concepts
IntentMeshagentic autonomous organizationmachine-readable organizational trustAI agent trust register

Use it

Join, and be told whether you conform
npm create @flashyos/mesh-node -- acme-robotics.com --email jo@acme-robotics.com
# ✓ L2 reached — the charter passes every static check and the handshake is valid.

Installing it puts this command on your path — read from the package’s own manifest, so this list cannot drift from what you actually get.

create-mesh-node

In practice

Reach L2 without a consulting engagement
An organisation runs `npm create @flashyos/mesh-node -- acme.com --email jo@acme.com`, commits the four generated files, and has a charter, handshake, directory fragment and re-check workflow that already pass the real validators.
Keep conformance current after deploy
The generated mesh.yml re-checks L2 on every push, gated to the repository’s default branch resolved per run, so a change that breaks the charter fails a check rather than drifting silently.

How it stays honest

The scaffolder does not assert conformance — it runs the same validateCharter, static conformance and validateHandshake functions the estate runs, over its own output, and prints the verdict. The workflow it writes re-checks L2 on every push, gated per run to the repository’s real default branch. Verify it yourself with `npx @flashyos/conformance yourdomain.com` after you deploy, which checks the files are actually served.

Questions

How do I join the FlashyOS mesh in one command?
Run `npm create @flashyos/mesh-node -- yourdomain.com --email you@org.com`. It writes your charter, handshake, directory fragment and re-check workflow, then runs the real validators and prints whether you reached L2.
What is L2 in the FlashyOS conformance ladder?
L2 (Chartered) is a valid flashyos/1 handshake plus an AAO charter that passes every static conformance question. It is offline and self-claimed — no account and no network call to FlashyOS is required.
Does create-mesh-node publish anything for me?
No. It writes files into your repository and verifies them locally. It never phones home and asks for no account; serving the files at your domain, and everything after, is yours to do.

The licence

Apache-2.0, read from the package’s own manifest. Embed it in anything, including closed software — that is what makes a spec adoptable and a verifier worth running. FlashyOS’s server side is AGPL-3.0-only instead, and a test in the monorepo asserts the direction between them: AGPL code may consume this, this may never consume AGPL code.

Keep reading

Join the meshThe conformance ladder
Also in connect
@flashyos/agent@flashyos/mcp@flashyos/create-mesh-agent@flashyos/page@flashyos/eslint-config@flashyos/llm-gateway@flashyos/wallet-wdk@flashyos/signer@flashyos/wdk