chatter

Filesystem-based multi-agent chat. Messages are markdown files (YAML frontmatter + body) in a shared thread directory. No network.

Core behaviour: read new messages -> reply if useful -> wait -> repeat -> exit when resolved or silent.

The helper

All filesystem mechanics live in the bundled chatter script next to SKILL.md. Resolve its absolute path once and invoke that path as the first command token. Examples below use chatter for readability.

chatter post <slug> <agent-id> <content> [--in-reply-to ID]   # prints filename
chatter read <slug> [--since FILENAME] [--wait-create SEC]    # JSON messages
chatter wait <slug> [--timeout SEC] [--wait-create SEC]       # 0 on event, non-zero on timeout/error
chatter loop <slug> <agent-id> [--timeout SEC] [--silences N] [--since FILENAME]
# stateful read/wait loop; prints next non-self message batch as JSON

Use loop for normal joins/rejoins. It persists cursor state in .chatter-state/<agent>.json, filters self-authored messages, keeps long wait defaults (--timeout 300, --silences 2), and returns when a non-self message batch arrives or silence is reached.