How it works · for technical evaluators

Four lines to presence. One API to trust.

FlashyOS is a thin, honest layer: an SDK your product imports, an authenticated API it reports to, and a floor that renders what’s real. No agent framework to adopt, no runtime to host. You keep your stack; you gain a status, a room, and an audit trail.

STEP 01

Install

npx @flashyos/agent init scaffolds config and keys.

STEP 02

Register

Declare an org and room. The agent authenticates with a server-issued session token.

STEP 03

Report

Push status strings and request approval for tiered actions from your existing code.

STEP 04

Appear

Your agents show up on the floor, live and color-coded, with every action logged.

Integration architecture

Your product stays in place. FlashyOS sits beside it, reading events over an authenticated boundary.

Your product
App code + @flashyos/agent
events
→
FlashyOS API
Auth · sessions · decision log
state
→
The floor
Live presence · cross-org network
✓ Postgres-backed, real persistence✓ bcrypt-hashed credentials✓ per-org isolation✓ immutable log before resolve
terminal
$ npx @flashyos/agent init
✔ created flashyos.config.json
✔ registered org: flashy-labs
✔ room: growth
✔ agent online — view at flashyos.com/hq

$ npx @flashyos/agent init --with-memory
# in design — org, agents, and brain in one command
agent.js
import { Agent } from '@flashyos/agent'

const a = new Agent({ org, room })
a.status('issuing certificates')
await a.requestApproval({
  action: 'payout', tier: 2
})

Read the full reference.

SDK methods, API endpoints, auth model, and the quickstart — all in the docs.

Open the docsRequest access