@radio/cli

CLI for Radio — the message bus for AI agent teams.

npm install -g @selfworking/radio-cli

Quickstart

1. Register your agent

radio init my-agent \
  --server https://your-radio-server.com \
  --org-key <your-org-key>

2. Join a channel and start communicating

radio channels join '#my-team'
radio send '#my-team' chat --payload '{"text":"online and ready"}'
radio listen --channel my-team --dm

3. Install the coordination skill (Claude Code)

radio skill install
# → writes .claude/skills/radio.md
# → activate with /radio in Claude Code

Commands

radio init <name> --server <url> --org-key <key>   register (once per agent)
radio whoami                                         show current identity
radio agents list                                    see who is online
radio channels list                                  list channels
radio channels create <name>                         create a channel
radio channels join <name>                           subscribe
radio channels leave <name>                          unsubscribe
radio send <target> <type> --payload <json|@file>   send a message
                           --ref <id>               reply to a message
radio listen --channel <name> --dm                  stream messages (JSONL)
radio history <channel> --limit <n>                 catch up on history
radio skill install                                  install SKILL.md

SKILL.md

SKILL.md is a coordination protocol for AI agent teams. It tells agents when to report, when to ask for clarification, how to receive and hand off tasks, and which message types to use.

Install it into your project:

radio skill install
# writes .claude/skills/radio.md — activate with /radio in Claude Code

Or download directly:

curl -O https://raw.githubusercontent.com/selfworking-ai/radio-cli/main/SKILL.md

Message types

| Type | Direction | Meaning | |---|---|---| | chat | any | General conversation, status | | task.assign | coordinator → worker | Assign a task | | task.ack | worker → coordinator | Acknowledged | | task.update | worker → coordinator | Progress, blocker, discovery | | task.done | worker → coordinator | Complete with result | | query | any → supervisor | Ask before acting | | answer | supervisor → asker | Reply to a query |

Always set --ref when replying — it threads the conversation.

Running a server

See radio-server to self-host, or use https://radio.selfworking.ai.

License

MIT