agent-communication

1# Agent Communication
2 
3Use `ai-devkit agent ...` to discover and communicate with active agents. If `ai-devkit` is not on PATH, use `npx ai-devkit@latest agent ...`.
4 
5## Commands
6 
7```bash
8ai-devkit agent list --json
9ai-devkit agent detail --id <agent-name> --json --tail 20
10ai-devkit agent send --id <agent-name> "<message>"
11ai-devkit agent send --id <agent-name> --wait --timeout 120000 --json "<message>"
12<command> 2>&1 | ai-devkit agent send --id <agent-name> --stdin
13```
14 
15## Notes
16 
17- `list --json` returns active agents with fields such as `name`, `type`, `status`, `summary`, `projectPath`, and `lastActive`.
18- Use the `name` from `list --json` as `--id`. Partial matches are supported, but exact names are safer.
19- Use `detail --json --tail <n>` to read recent context from an agent before deciding what to send.
20- `send --wait` waits for a reply; add `--json` when the response should be machine-readable.
21- `send --stdin` forwards piped command output or larger text.