CLI Reference

The aios CLI is a zero-dependency Node.js script (scripts/aios.mjs, Node ≥ 18). Install it from aios-workspace:

# From inside an aios-workspace clone:
npm link   # or add to PATH: export PATH="$PWD/bin:$PATH"

Configure your workspace’s aios.yaml:

version: 1
brain_url: https://your-brain.example.com
api_key: aios_<key_id>_<secret>
team: your-team-slug
sync:
  tiers: [team, external]
  include:
    - 0-context
    - 2-work
    - 3-log
    - 4-shared

Commands

`aios status`

Preview what would be pushed without sending anything.

aios status
# → Lists files that are new, modified, or unchanged since last push

`aios push`

Push tier-eligible content to the Team Brain.

aios push                    # push everything eligible
aios push --dry-run          # preview only (same as status)
aios push 2-work/retro.md   # push specific path(s)

Only files whose frontmatter audience maps to team or external are sent. Files without frontmatter are skipped with a warning.

`aios pull`

Fetch team updates from the brain into 1-inbox/from-brain/.

aios pull
# → Downloads items updated since last pull, writes to 1-inbox/from-brain/
# → Also fetches task rows and writes them to 3-log/tasks-from-brain.md

`aios query`

Natural-language query against the Team Brain. Streams the answer.

aios query "what blocked sprint 1?"
aios query "who owns the auth decision?"

`aios export-okf`

Export a tier-filtered OKF (Open Knowledge Framework) bundle from the brain to a local directory.

aios export-okf              # exports to .aios/okf/
aios export-okf ./my-bundle  # exports to specified directory

`aios pull-bundle`

Pull the OKF link graph from the brain into .aios/bundle.json for offline traversal.

aios pull-bundle
# → Use /okf-traverse inside Claude Code to query offline

`aios graph`

Traverse the local OKF bundle and print the link graph.

aios graph
aios graph --from 2-work/retro.md   # start from a specific node

`aios assess-codebase`

Score a repo’s AEM agent-readiness (L0–L5) offline; optionally record the scan in the Team Brain.

aios assess-codebase                 # score the current repo (offline)
aios assess-codebase ./path          # score another repo
aios assess-codebase --push          # also POST to /api/v1/codebases (team-tier key)

`aios analyze`

Build an Agentic Engineering Maturity report from your local agent-session logs (Claude, Codex, Cursor): it computes structural signals (delegation, verification, cost, …) and places you on the AEM Spine. With --push, the daily aggregate goes to the brain — ratios and counts only, never raw session text.

aios analyze                         # last 7 days, printed
aios analyze --since 30d --report     # longer window + full report
aios analyze --push                  # also POST to /api/v1/metrics (team-tier key)

`aios relay`

Run an automated Opus ↔ Cursor plan/review loop over a task: Opus plans, Cursor executes, Opus reviews, repeating for N rounds (default 3).

aios relay "add rate-limit tests"            # 3 rounds, /review-plan
aios relay "refactor parser" --rounds 2       # custom round count
aios relay "tidy imports" --dry-run           # plan/review without writing

Environment variables

Variable	Description
`AIOS_API_KEY`	Overrides `api_key` in `aios.yaml`
`AIOS_BRAIN_URL`	Overrides `brain_url` in `aios.yaml`
`AIOS_TEAM`	Overrides `team` in `aios.yaml`