Skip to content
AIOS

Quickstart

Start with an individual workspace. It is useful on its own and does not require a Team Brain.

  1. Inspect before installing

    If AIOS may already be on this machine, run the read-only inspection from an existing toolkit or workspace:

    Terminal window
    aios onboard --inspect --json

    Review the workspace candidates, Git cleanliness, toolkit state, and Brain configuration before changing anything.

  2. Create or repair your individual workspace

    Follow Individual workspace setup. A fresh workspace uses the consultant, employee, or business-owner context. An existing workspace should be upgraded or repaired, not scaffolded over.

    During guided setup, AIOS may ask whether you are actively building a codebase with AI. This is a separate capability choice: Yes enables the optional GitHub Actions workflow that reports merge-time code health to the Team Brain; No is the default and does not add it. You can enable it later with aios update --with-ci-workflow.

  3. Validate it locally

    Terminal window
    /path/to/aios-workspace/validation/validate-all.sh /path/to/your-name-workspace

  4. Choose whether you need shared memory

    You can stop after step 3. If a team already has a Brain, follow Join a Team Brain. If you are the team administrator, follow Team admin setup.