aide dispatch / wait / events

Commands for inter-agent delegation and observability.

aide dispatch

aide dispatch <agent> "<task>"
aide dispatch reviewer "Review PR #42 for security issues"
aide dispatch --dry-run deployer "Ship v1.2.0"

# Auto-select the best agent using the RL bandit router
aide dispatch --auto "check GPU utilization on all nodes"

Creates a GitHub issue labeled for the target agent, spawns a detached aide run-issue background worker, and returns immediately with the issue reference and a wait command you can use to block on the result.

Flags

Output

Dispatched: https://github.com/org/repo/issues/99
Wait with: aide wait https://github.com/org/repo/issues/99

aide wait

aide wait <issue-url>
aide wait --timeout 30m https://github.com/org/repo/issues/99

Blocks until the target issue closes, then prints the bounded summary extracted from the closing comment.

Flags

Exit codes

Output

On success, prints the content of the <aide-summary> block from the issue's closing comment. This is the bounded summary controlled by the sub-agent's [output] config.

aide cancel

aide cancel <issue-ref>
aide cancel owner/repo#42
aide cancel https://github.com/org/repo/issues/42

Stops a running dispatch: sends SIGTERM to the background worker, posts a cancellation comment, and closes the issue.

What it does

1. Looks up the worker PID from the local SQLite state database
2. Sends SIGTERM to kill the claude -p process
3. Posts STATUS: cancelled (by user) as an issue comment
4. Closes the GitHub issue
5. Marks the run as cancelled in the state database
6. Logs a cancelled event to ~/.aide/events.jsonl

aide events

aide events
aide events --limit 20

Reads ~/.aide/events.jsonl and prints a timeline table of recent dispatch and completion events.

Flags

Example output

TIME            EVENT       AGENT       ISSUE   STATUS
2026-04-11 14:01 dispatch   reviewer    #99     running
2026-04-11 14:03 complete   reviewer    #99     success
2026-04-11 14:05 dispatch   deployer    #100    running

aide memory-sync

aide memory-sync <agent> --summary "STATUS: success ..."
cat output.txt | aide memory-sync <agent>

Manually triggers HQ memory distillation for an agent. Useful for backfilling history or re-syncing after a failed auto-sync.

What it does

1. Reads existing HQ memory/<agent>/context.md
2. Reads memory/_shared/ (team-level context)
3. Uses claude -p to merge old memory + new summary
4. Writes updated context.md
5. Git commits to HQ repo

If --summary is not provided, reads from stdin.

Requires hq to be set in ~/.aide/config.toml.

aide api

aide api
aide api --port 7979

Starts a local HTTP API server for programmatic access to aide state.

Flags

Endpoints

aide stats

aide stats

Prints a summary of today's activity from the local SQLite database:

Today (2026-04-11):
  Runs:   12
  Tokens: 847,230
  Agents: 3 (reviewer, deployer, helper)

aide status

aide status

Shows daemon health and last heartbeat:

Daemon: running (pid 12345)
Last heartbeat: 2s ago
Uptime: 4h 12m

aide install-service / aide uninstall-service

aide install-service
aide uninstall-service

Installs or removes the aide daemon as a system service so it starts automatically on login.

Platform support

After installing, the daemon starts on login and restarts on failure. Use aide uninstall-service to remove the service definition and stop the daemon.