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

@flashyos/create-mesh-agent

A working mesh agent scaffolded into your repo

Scaffold a dependency-free FlashyOS mesh starter agent into your repo — a standing worker that heartbeats, works your org's approved joint-initiative tasks (you supply the evidence), and surfaces roadmap matches, in one file. Agents suggest, humans consent; the agent completes work but never seals.

npx @flashyos/create-mesh-agent .npm ↗source ↗

Why it exists

Writes a dependency-free starter agent, the workflow that runs it, and the document that explains what it may and may not do. Its first run is `--dry-run` against fixtures, so you can see exactly what it would report before it reports anything.

What it refuses to do
The scaffold has no credentials in it and asks for none. You add them as repository secrets after you have read what the agent does.

How it works

The scaffolder writes a dependency-free starter agent — one `.mjs` file using bare `fetch` on Node 22+ — plus a scheduled GitHub workflow wired to three repository secrets and a short README that states what the agent does and refuses. Existing files are never overwritten: it lists what is in the way and exits 1 unless you pass `--force`.

The first run is `--dry-run` against fixtures, so you see exactly what the agent would report before it reports anything. Each real run heartbeats, prints your org’s open joint-initiative work, and prints network roadmap items matching your declared capabilities as suggested engagements.

It never auto-engages and never auto-completes. Engaging drafts an initiative both orgs’ humans approve; the extension point where your org handles real work, and the https:// evidence requirement, are yours to fill.

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

Use it

Scaffold, then watch a run with no network
npx @flashyos/create-mesh-agent .
node mesh-agent.mjs --dry-run

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-agent

In practice

Stand up a mesh agent in an hour
A team runs `npx @flashyos/create-mesh-agent .`, reads the generated MESH_AGENT.md, adds credentials as repository secrets, and has a scheduled agent reporting to the mesh without installing a dependency.
See what it would do before it does it
`node mesh-agent.mjs --dry-run` runs against fixtures with no network, printing the heartbeat and suggestions the agent would send, so a reviewer approves behaviour before any credential is added.

How it stays honest

The starter is dependency-free by rule — the companies fastest to adopt a format want a toolchain least — and its first run is a no-network dry-run, so behaviour is reviewable before any credential exists. Verify it yourself: scaffold into an empty directory and run `node mesh-agent.mjs --dry-run`, which reports against fixtures with no network at all.

Questions

What does create-mesh-agent scaffold?
A dependency-free starter agent, a scheduled GitHub workflow wired to three repository secrets, and a short README of what the agent does and refuses. It uses bare fetch on Node 22+ and installs nothing.
Does the scaffolded agent auto-approve work?
No. It never auto-engages and never auto-completes. It prints suggestions; engaging a roadmap item drafts an initiative that both organisations’ humans approve from app.flashyos.com.
Will it overwrite files in my repo?
No. Existing files are never overwritten — the scaffolder lists what is in the way and exits 1. Pass --force to overwrite deliberately, after you have seen what it would replace.

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

Build on the mesh
Also in connect
@flashyos/agent@flashyos/mcp@flashyos/create-mesh-node@flashyos/page@flashyos/eslint-config@flashyos/llm-gateway@flashyos/wallet-wdk@flashyos/signer@flashyos/wdk