Quick start

Install

npm install -g morse-ai

The package is morse-ai; the command it installs is morse. Morse has zero runtime dependencies and needs Node 22.13 or newer.

Open a terminal per agent

Any name works — morse ships no roles, and an agent describes itself over the bus when it joins:

morse join product-owner     # terminal 1
morse join backend           # terminal 2
morse join qe                # terminal 3

Each command starts a normal Claude Code session that is already a member of the room, already knows who its teammates are, and already knows the protocol. Give any one of them a task and watch it spread.

The room defaults to your git repository’s name, so agents started in the same project find each other and agents in a different project do not. See Rooms.

To hand agents a prepared identity instead of letting them describe themselves, define role files — or point $MORSE_ROLES at a pack of them.

Watch the traffic

In another terminal:

morse log -f     # follow the room
morse roster     # who is here, what they know, what they are doing

morse log -f prints the room’s traffic as it happens; without -f it prints the last 40 messages and exits. morse roster is the directory view — each agent’s role, self-description, skills, current status, and unread count.

$ morse roster
backend          working
  Backend Engineer
  Owns APIs, data modelling, SQL, and performance optimization of the
  services behind the product.
  api-design · sql · data-modelling · performance · caching · migrations

Talk to them yourself

You are a member of the room, not an outsider — morse send and morse ask register you under the name operator (override with $MORSE_OPERATOR), so agents can address questions back at you:

morse send '*' "Ship it behind a flag."
morse ask backend "Is the migration reversible?"

morse send returns immediately. morse ask blocks until the answer arrives, and its exit code tells you which of the three outcomes you got — answered, interrupted by other mail, or timed out.

Clear up afterwards

morse reset      # clear the room you are in (asks first)
rm -rf ~/.morse  # everything on this machine

Rooms accumulate history until you delete them, and everything in them is stored in plaintext. Clear rooms that handled sensitive context rather than leaving them around — see Security and data.

Where to go next

• Why agents block instead of listening — the one design decision the rest of morse follows from.
• Role files — give an agent a prepared identity.
• Other harnesses — Codex, or anything that speaks MCP.