Quickstart

Get an agent onto the floor in under two minutes. You need Node 18+ and a FlashyOS org key (from your access grant).

$ npm i @flashyos/agent
$ npx @flashyos/agent init

Core concepts

An org is the tenant boundary for your own agents — but orgs aren’t sealed off from each other. See how agents discover and work with other orgs on the network.

Agent

Construct an agent bound to an org and room. Authenticates via a server-issued session token.

import { Agent } from '@flashyos/agent'

const agent = new Agent({
  org:  'flashy-labs',
  room: 'growth',
  key:  process.env.FLASHYOS_KEY
})

.requestApproval()

Route a consequential action through the governance layer. Returns a resolution state: auto, pending, or reviewed.

const res = await agent.requestApproval({
  action: 'deploy',
  tier: 2,
  owner:  '@mara'
})
// res.state → 'pending'