aide init

Interactive setup that creates a team HQ — the coordinator workspace for your agents.

Usage

# Interactive (recommended)
aide init

# Non-interactive (CI / scripting)
aide init --name myteam --members /path/to/agent-a,/path/to/agent-b

What it does

Prerequisites check — verifies gh and claude CLI are installed, checks GitHub auth
Scan for projects — finds directories with .git, Aidefile, src/, package.json, etc.
Select members — interactive multi-select of which projects to include as agents
Create HQ — builds the coordinator workspace:

myteam-hq/
├── CLAUDE.md              # coordinator instructions
├── .gitignore
├── .claude/agents/        # dispatch wrappers for each member
├── memory/
│   ├── _shared/           # team-level context
│   ├── agent-a/           # per-agent memory (auto-distilled)
│   └── agent-b/

Register agents — adds all members to ~/.aide/config.toml
Set HQ path — stores hq = "/path/to/myteam-hq" in config for memory sync

After init

cd myteam-hq && claude

This opens a Claude session as the team coordinator. From here you dispatch work:

aide dispatch agent-a "implement feature X"
aide dispatch agent-b "fix bug Y"
aide events   # check progress

The HQ session stays clean — agents do the heavy lifting in their own token budgets.

Flags

Flag	Description
`--name <name>`	Team name (creates `<name>-hq/`). Skips interactive prompt.
`--scan-dir <path>`	Directory to scan for projects (default: `~/projects`)
`--members <paths>`	Comma-separated paths to register as agents
`--vault <path>`	Path to vault file
`--skill-dir <path>`	Path to skill directory

When --name and --members are both provided, all interactive prompts are skipped.

What gets created for each member

Aidefile — if the project doesn't have one, a default is created
.claude/agents/ wrapper — in the HQ, a dispatch wrapper for each member
memory/<agent>/ — directory for auto-distilled memory (SSOT)
Registry entry — aide register so aide dispatch <name> works

Example

$ aide init

aide — your commander of agents
─────────────────────────────────

Checking prerequisites... ✓ gh CLI found
                         ✓ claude CLI found
✓ GitHub: logged in as yiidtw
  Where should we look for projects? ~/claude_projects
  Found 6 projects (4 with Aidefile, 2 without)

  Select members:
  ✓ crossmem-rs
  ✓ crossmem-web
  ✓ crossmem-chrome
    (use space to toggle, enter to confirm)

  Team name: crossmem

Creating crossmem-hq/
  ✓ git init
  ✓ CLAUDE.md
  ✓ .gitignore
  ✓ .claude/agents/ (3 wrappers)
  ✓ Registered 3 agents
  ✓ HQ registered in ~/.aide/config.toml
  ✓ memory/ (team SSOT)

✓ crossmem-hq created

  cd crossmem-hq && claude

aide.sh