Getting Started

AIOS has two products with different owners and lifecycles:

Product	Ownership	Required?	Repository
Individual Workspace	One private git repo per person	Yes for workspace workflows; works offline	aios-workspace
Team Brain	One shared service per team	Optional; needed only for shared memory and team sync	aios-team-brain

People do not join another person's workspace

A Team Brain admin invites people to the Team Brain. Each invited person creates or repairs their own individual workspace, then connects it to the shared Brain. A personal workspace is never the team membership boundary.

Let your agent set it up

Choose your path

Set up my workspace

Create the private, local workspace you and your agents use every day. No Team Brain or invitation is required.

Individual workspace setup →

Join an existing team

Create or repair your own workspace, accept a Team Brain invitation, connect, and preview your first share.

Join a Team Brain →

Create a team

Deploy one Team Brain, establish the admin account, invite members, and let each person connect their own workspace.

Team admin setup →

Orient an agent

Give an agent the compact ecosystem map, source hierarchy, safety invariants, and verification commands.

Agent source map → · /llms.txt

Runtime requirements

The products do not share one runtime requirement:

• Individual Workspace: Node 22, git, and a machine you control.
• Team Brain: Node 20 or newer, Postgres, git, and a deployment target.

The workspace toolkit is cloned or installed per person. The Brain is deployed once per team.