bdb-aos-sessions

Language / Sprache / Idioma: English · Deutsch · Português

AOS — BDB Agent OS

<b>The operating system for AI agent harnesses.</b><br/> One install: the same skills in nine harnesses. Subagents and the hook-enforced GO gate on Claude Code, Antigravity, Codex and OpenCode.

Built for <b>event and media technicians</b>, <b>designers</b> and <b>managers</b>, for <b>builders of custom installations</b> (show control, 3D, PCB and enclosure), and just as much for <b>everyday coding</b> of apps, tools and plugins. The skill library and the MCP servers cover both worlds.

AOS installs a curated skill library, a subagent roster, gate hooks and a runnable multi-agent build pipeline into every coding-agent harness on your machine.

npx -y @hybridlabor-api/aos@latest

<img alt="Claude Code" src="https://img.shields.io/badge/Claude%20Code-D97757?logo=anthropic&logoColor=white"> <img alt="Antigravity" src="https://img.shields.io/badge/Google%20Antigravity-4285F4?logo=google&logoColor=white"> <img alt="Codex CLI" src="https://img.shields.io/badge/Codex%20CLI-412991?logo=openai&logoColor=white"> <img alt="OpenCode" src="https://img.shields.io/badge/OpenCode-111827"> <img alt="Cursor" src="https://img.shields.io/badge/Cursor-000000?logo=cursor&logoColor=white"> <img alt="Windsurf" src="https://img.shields.io/badge/Windsurf-0B100F"> <img alt="Roo Code / Cline" src="https://img.shields.io/badge/Roo%20Code%20%2F%20Cline-5B21B6"> <img alt="Aider" src="https://img.shields.io/badge/Aider-14B814"> <img alt="AOS CLI" src="https://img.shields.io/badge/AOS%20CLI-pi--based-0d1117">

_{Recommended: the full installer above. Alternatively, use the skills CLI:}

<table> <tr> <td width="100%" valign="top" align="left"><b>Install skills only</b><br/><br/><code>npx skills add hybridlabor-api/aos</code><br/><br/>_{Gate hooks and MCP servers require the full installer. Plugin marketplace route is in progress; see <a href="#plugins-and-marketplace">Plugins and marketplace</a>.}</td> </tr> </table>

_{Skills use the open <a href="https://agentskills.io">Agent Skills</a> format (<code>SKILL.md</code>). AOS installs them for <b>Claude Code, Google Antigravity, Codex CLI, OpenCode, Cursor, Windsurf, Roo Code / Cline, Aider and the AOS CLI</b>, so all of them behave the same way.}

<img src="docs/assets/readme/architecture-hero.svg" alt="How AOS fits together: nine harnesses feed one kernel of 270 skills, 45 subagents, gate hooks and 21 MCP servers, which drives three pipelines, session-to-session messaging and local tools, with the GO gate in front of every release command" width="100%">

Why AOS

What you get

<table> <tr> <td width="33%" valign="top">🎯 <b>Skills</b><br/>270 curated skills in eight categories, discoverable by every harness as <code>&lt;name&gt;/SKILL.md</code>.<br/>→ <a href="#skills-at-a-glance">Skills at a glance</a></td> <td width="33%" valign="top">👥 <b>Subagents</b><br/>45 subagents: Architect, TechLead, Reviewer, Godmodes and specialist reviewers.<br/>→ <a href="#the-dispatcher-graph">The dispatcher graph</a></td> <td width="33%" valign="top">🔌 <b>MCP servers</b><br/>21 servers for creative software, OS control, memory and cross-harness delegation.<br/>→ <a href="#mcp-servers">MCP servers</a></td> </tr> <tr> <td width="33%" valign="top">🚀 <b>Pipelines & GO gate</b><br/><code>/startcycle</code>, <code>/startcycle-graph</code>, <code>/startcycle-graph-user</code>, and hook-enforced release gate.<br/>→ <a href="#the-pipelines">The pipelines</a></td> <td width="33%" valign="top">💬 <b>Sessions that talk</b><br/>A2A between Claude Code, OpenCode, agy and Codex sessions on localhost.<br/>→ <a href="#a2a-sessions-that-talk-to-each-other">A2A</a></td> <td width="33%" valign="top">🛠️ <b>Tools</b><br/>Plan Canvas, agenttrail, archify, AOS Store, AOS Hub, aos sessions, fleet band, aos doctor.<br/>→ <a href="#skills-at-a-glance">Tools</a></td> </tr> </table>

<table> <tr> <td width="20%" valign="top"><b>Event & media tech</b><br/>• Live show control: grandMA3, Resolume, TouchDesigner<br/>• Media production: Unreal, DaVinci, After Effects</td> <td width="20%" valign="top"><b>Design</b><br/>• UI/UX design system and brand discovery<br/>• Landing pages, app redesigns, Plan Canvas</td> <td width="20%" valign="top"><b>Management</b><br/>• Offers, invoices, budget tracking<br/>• Crew sheets, event planning, meeting actions</td> <td width="20%" valign="top"><b>Custom builds</b><br/>• PCB design and OpenSCAD enclosures<br/>• 3D assets, Rhino, Blender modeling</td> <td width="20%" valign="top"><b>General dev</b><br/>• Backend, frontend, testing, and shipping<br/>• 45 subagents, three pipelines, library skills</td> </tr> </table>

See Playbooks for guided workflows across these domains.

Quick start

See it in action

<img src="docs/assets/readme/agenttrail-live.gif" alt="agenttrail live plan map of a running multi-agent build" width="100%"><br/> _{<b>agenttrail.</b> The live map of a multi-agent build while it runs. <a href="docs/assets/readme/agenttrail-live.mp4">▶ Full-quality video</a>}

<table> <tr> <td width="50%" valign="top" align="center"> <img src="docs/assets/readme/plan-canvas.png" alt="Plan Canvas with an annotation on a plan element" width="100%"><br/> _{<b>Plan Canvas.</b> Annotate the plan in the browser, then approve it before any agent builds.} </td> <td width="50%" valign="top" align="center"> <img src="docs/assets/readme/ao-pipeline.png" alt="AO workspace: the AOS Pipeline monitor with plan, gate, build, review and ship stages and the role-to-model routing" width="100%"><br/> _{<b>AO workspace.</b> The pipeline monitor, plan to ship, with role and model routing per node.} </td> </tr> <tr> <td width="50%" valign="top" align="center"> <img src="docs/assets/readme/aos-store.png" alt="AOS Store web UI: skills, agents and playbooks by scope, category and source" width="100%"><br/> _{<b>AOS Store.</b> Skills, agents and playbooks on 127.0.0.1:4322.} </td> <td width="50%" valign="top" align="center"> <img src="docs/assets/readme/codenotch-usage.png" alt="Codenotch: agents running and busy per harness, AOS and AO versions" width="100%"><br/> _{<b>Codenotch.</b> Agents running and busy per harness.} </td> </tr> </table>

<img src="docs/assets/readme/fleet-band.png" alt="Fleet band in Claude Code showing gate mode, context use and sessions with their GO counts" width="100%"><br/> _{<b>Fleet band.</b> In Claude Code: gate mode, token-weather, and the sessions that wait for your GO.}

<img src="docs/assets/readme/aos-installer.gif" alt="AOS installer: boot animation, pre-flight telemetry and the setup menu" width="100%"><br/> _{<b>Installer.</b> <code>npx -y @hybridlabor-api/aos@latest</code>: boot, pre-flight telemetry, then the setup menu. <a href="docs/assets/readme/aos-installer.mp4">▶ Full-quality video</a>}

Skills at a glance

• /startcycle - linear build pipeline (Architect, TechLead, parallel build, Reviewer) with file hand-offs in production_artifacts/
• /startcycle-graph - dispatcher graph with durable state.json, Reviewer repair loop, quality gate and escalation
• The dispatcher invokes the subagents architect, techlead, godmode-ui-ux, godmode-engineering, godmode-media-eventtech, reviewer and godmode-shipping; they never call each other
• /startcycle-graph-user - throwaway 2-4 node fan-out for any project, nothing persistent left behind
• /plan - draft, render in a browser canvas, annotate, await approval, then hand off
• plan-canvas - local canvas where you annotate elements, chat and approve or request changes
• plan-arbiter - compare competing plans from several agents and produce one recommended plan
• /bdbrainstorm - multi-agent brainstorm that ends in a hand-off to /startcycle-graph
• /grill-me - relentless interview to sharpen a plan or design
• bdbmediastorm - brainstorming for live event tech, show control and real-time media
• /playbooks - list every pb-* playbook with duration, difficulty and requirements, and start one
• pb-bug-fix - GitHub issue to tested fix and PR; push and PR only after GO
• pb-ship - triage, review and gate the day's PRs; merge only after GO
• pb-release-aos - release AOS to npm through the release-please PR
• pb-show-build - build a show across grandMA3, Resolume and TouchDesigner, offline first
• pb-offer - draft a client offer priced from your price list; send only after GO
• factory-collect - Factory: collect and triage feedback, telemetry, errors and issue reports
• factory-lookback - audit recurring problems across sources for systemic fixes
• factory-review-prs - review a configured PR queue; approve and merge stay with you
• factory-human-digest - read-only digest of what still needs a human decision
• gogate - show or explain the go-gate mode (hard, soft, off) and the time-limited grants; CLI: aos-gogate
• aos-a2a - list, send to and reply to live harness peers over A2A on localhost
• master-session - supervise several sessions: roster, status requests, GO board; workers can be spawned through aos-acp
• mcsc - delegate a task to another installed CLI harness (agy, OpenCode, Codex)
• agenttrail - live browser map of a multi-agent build; CLI: aos-trail
• aos-store - browse, preview and install skills and agents from a local web UI (aos store)
• memb-skill - local-first long-term memory engine (memB)
• memb-ingest - ingest project files and conversation logs into memB
• openwiki-skill - initialize, update and visualize codebase wikis with OpenWiki
• synapse-integration-skill - BDB Synapse 3D codebase visualizer integration
• /doctor - check the machine and the current project, print suggested permissions.allow entries, write no settings
• aos-setup - bring a machine to a complete, verified AOS installation
• aos-project-init - set up a project folder: slug, wiki, memory, Synapse map, AGENTS.md
• Godmodes - domain rulebooks
• godmode-engineering - strict DDD, TypeScript strictness, Clean Architecture, 5-step debugging triage
• godmode-ui-ux - brand discovery, Anti-Slop rules, DTCG design tokens, fluid motion
• godmode-eventtech - show-control execution for grandMA3, Resolume, Unreal, Rhino, Vectorworks and Adobe MCP
• godmode-hardware-pcb - schematics, PCB layout, KiCad and OpenSCAD enclosures with DFM/DRC/ERC sign-off
• godmode-shipping - final gatekeeper: pre-launch checks, feature-flag rollouts, rollback planning
• Vendored helpers from BuilderIO/skills
• read-the-damn-docs - forces a docs pass before coding third-party APIs from memory
• stay-within-limits - respect 5-hour and weekly usage limits in long or parallel runs
• quick-recap - end each response with a red/yellow/green status line

Full catalogs (every skill, subagent, playbook and MCP server) are in the collapsible lists under What's included.

What's new in v5

v5 changes how AOS gets onto a machine and how its parts talk to each other.

In progress, not claimed as shipped. agenttrail v2 control room, A2A intercom and a2abook, A2A spawn mode, skill-create and instinct-*.

The dispatcher graph

The graph is harness-neutral and runs on Claude Code's Dynamic Workflows, Antigravity's parallel execution, and any compatible agent harness.

%%{init: {"theme": "base", "themeVariables": {"lineColor": "#6e7681", "edgeLabelBackground": "#f6f1e8", "textColor": "#15171A", "clusterBkg": "#F7F4EC", "clusterBorder": "#B9B5AA", "titleColor": "#15171A", "primaryColor": "#FFFFFF", "primaryBorderColor": "#15171A", "primaryTextColor": "#15171A"}}}%%
flowchart TB
    subgraph SG[" "]
    direction TB
    U(["User"])
    A["<b>Architect</b><br/>System Plan"]
    T["<b>TechLead</b><br/>Capability Map"]
    UX["<b>UI_UX</b><br/>Frontend"]
    EN["<b>Engineering</b><br/>Backend"]
    ME["<b>Media_EventTech</b><br/>Creative"]
    R["<b>Reviewer</b><br/>QA"]
    S["<b>Shipping</b><br/>Gate"]

    U --> A --> T
    T --> UX & EN & ME
    UX & EN & ME --> R
    R --> S

    T -.->|reject| A
    R -.->|findings| UX
    S -.->|gate fail| EN
    R -.->|escalate| U
    end

    classDef plan fill:#E6F4EA,stroke:#1A7F3C,color:#15171A
    classDef build fill:#FFFFFF,stroke:#15171A,color:#15171A
    classDef gate fill:#1A7F3C,stroke:#1A7F3C,color:#FFFFFF
    classDef human fill:#F7F4EC,stroke:#5B6168,color:#15171A
    classDef store fill:#F7F4EC,stroke:#B9B5AA,color:#15171A
    linkStyle default stroke:#6e7681,stroke-width:2px

    style SG fill:#F7F4EC,stroke:#B9B5AA,color:#15171A

    class A,T plan
    class UX,EN,ME build
    class R,S gate
    class U human

Install

Requirements. Node.js >= 20. macOS, Linux and Windows (PowerShell).

npx -y @hybridlabor-api/aos@latest

First run. The installer detects which harnesses are present, asks which to target and which tier (Pro MEDIA or Basic), copies the skills into each harness's skill directory, compiles the subagents, wires the hooks, merges the MCP configuration into each harness's own config file (existing entries are kept), and offers the optional modules listed below.

Every later run opens a menu instead:

Profiles and options

| --no-hooks | Skips only the cont