synapse-a2a

# Synapse A2A Communication

Inter-agent communication framework via Google A2A Protocol.

## Quick Reference

| Task | Command |
|------|---------|
| List agents | `synapse list` |
| Watch agents (Rich TUI) | `synapse list --watch` (interactive, shows TRANSPORT) |
| Watch agents (plain) | `synapse list --watch --no-rich` |
| Send message | `synapse send <target> "<message>" --from <sender>` |
| Wait for reply | `synapse send <target> "<message>" --response --from <sender>` |
| Reply to request | `synapse send <target> "<response>" --reply-to <task_id> --from <sender>` |
| Emergency stop | `synapse send <target> "STOP" --priority 5 --from <sender>` |
| Stop agent | `synapse stop <profile\|id>` |
| Check file locks | `synapse file-safety locks` |
| View history | `synapse history list` |
| Initialize settings | `synapse init` |
| Edit settings (TUI) | `synapse config` |
| View settings | `synapse config show [--scope user\|project]` |
| Show instructions | `synapse instructions show <agent>` |
| Send instructions | `synapse instructions send <agent> [--preview]` |
| Version info | `synapse --version` |

**Tip:** Run `synapse list` before sending to verify the target agent is READY.

## Sending Messages (Recommended)

**Use `synapse send` command for inter-agent communication.** This works reliably from any environment including sandboxed agents.

```bash
synapse send gemini "Please review this code" --from claude
synapse send claude "What is the status?" --from codex
synapse send codex-8120 "Fix this bug" --priority 3 --from gemini
```

**Important:** Always use `--from` to identify yourself so the recipient knows who sent the message and can reply.

**Target Resolution (Matching Priority):**
1. Exact ID: `synapse-claude-8100` (direct match)
2. Type-port: `claude-8100`, `codex-8120` (shorthand)
3. Type only: `claude`, `gemini`, `codex` (only if single instance)

**Note:** When multiple agents of the same type are running, type-only targets (e.g., `claude`) will fail