Skip to content
Maia OS

Getting started

Maia is in the architecture and consolidation phase. There is no production installer, hosted signup, or implemented desktop product. Work from the repository on Node 24.19.0 and pnpm 11.20.0.

What you can do today

  1. Clone vllnt/maia-os.
  2. Use Node 24.19.0. Other Node versions are not the reference runtime.
  3. Install with pnpm 11.20.0 and follow the repository development notes.
  4. Run the local node as documented by @maia/node.
  5. Use source-callable maia commands against that node.

The CLI does not start or stop the node. Project registration records one canonical Git repository and a local-main workspace. Public JSON uses opaque location identifiers.

Implemented control path

maia-node -> protocol -> @maia/sdk -> built maia CLI

Installed discovery is maia help --json. Treat that output, plus the CLI README, as the executable grammar. Workflow notes live in the CLI guide. Planned families live in the CLI roadmap. This site does not duplicate command flags.

What not to expect

  • No Skill, Teammate, Room, Routine, or Runtime Extension product surface
  • No approval or resource-admission UI
  • No offline Skill bundle synchronization
  • No implemented Desktop or mobile ADE
  • No enabled terminal or session-start product path

Continue with Concepts, Node, Protocol, SDK, the CLI notes, or Product Surfaces.