Quick Start

Set up a team of agents in 2 minutes.

1. Install

cargo install aide-sh

2. Initialize your team

aide init

This walks you through:

  • Scanning for projects
  • Selecting which ones become agents
  • Creating a team HQ (coordinator workspace)

At the end you get:

✓ myteam-hq created

  cd myteam-hq && claude

3. Open the HQ

cd myteam-hq && claude

You're now in a Claude session as the team coordinator. The HQ has:

  • CLAUDE.md — tells Claude it's a coordinator, not a coder
  • .claude/agents/ — dispatch wrappers for each member
  • memory/ — centralized memory (SSOT), auto-synced after each dispatch

4. Dispatch work

From the HQ session:

aide dispatch my-agent "review the latest PR and leave comments"
# dispatched: org/my-agent#42
# wait: aide wait https://github.com/org/my-agent/issues/42

The agent runs in a separate claude -p process with its own token budget. Your HQ session only sees the bounded summary — not the 50k tokens the agent burned.

5. Check results

aide wait https://github.com/org/my-agent/issues/42
# STATUS: success
# TOKENS: 18432/200000
# NOTES: Reviewed PR, left 3 comments on error handling.

After the agent finishes, its output is automatically distilled into memory/my-agent/context.md and git-committed to the HQ repo.

6. Automate with triggers

Set [trigger] in the agent's Aidefile:

[trigger]
on = "issue"

Start the daemon:

aide up

Now the agent wakes up whenever a GitHub Issue is opened with the matching label — no manual dispatch needed.

What's next?