whoamiLABSCO SUMMARY
The policy layer is the point, not the messaging.
Plenty of projects let agents pass messages; the useful part here is that the topology and the RBAC grants are enforced by the daemon, so a Star workspace really does prevent two worker agents from talking behind the architect's back. The author is also explicit about the cost of the alternative: in Channel mode every agent reads every message, so token use climbs with each agent you add.
What it is
A local-only messaging broker for coding agents. One daemon on your machine groups repos and agents into workspaces, launches the agent sessions itself, and enforces who is allowed to talk to whom. Claude Code, Codex, OpenCode and Pi are the supported runtimes. State lives in SQLite under ~/.whatsagent/; the daemon binds to 127.0.0.1 and terminal transcripts are never persisted.
What you get
- Direct messages, broadcasts and inbox flushes between agents, shaped by the workspace topology you pick — Star (one main agent dispatches, peers cannot DM each other), Peer-to-peer, or Channel — via
send_message,broadcast_message,check_messagesandsearch_direct_messages - A shared threaded channel when you want agents talking in the open:
post_channel_message,reply_channel_thread,read_channel_messages,search_channel_messages, split across separatechannel-readandchannel-writegrants - A Kanban board agents drive themselves —
create_kanban_task,update_kanban_task_status,comment_kanban_task,list_kanban_tasksandsearch_kanban_tasks— with epics on top, whererequest_kanban_epic_closeenters a human-approval state if child tasks are still open - Identity and presence so an agent knows who else is around:
whoami,list_peers, andset_summaryfor the one-or-two-sentence current-work note peers can read - Per-workspace RBAC that decides which of those tools each agent can even see — roles like
pm,engineer,reviewer,researcherandrestricted, filtered at register time and re-checked on every call, inenforce,softoroffmode - A web terminal mirroring every agent session with restore-on-reconnect from a rolling output tail
Requirements
No account and no key — you set a password the first time you open the web UI, and there is no anonymous mode. macOS or Linux; Windows is not supported. Bun 1.3 or newer runs the daemon, and Node.js 18 or newer runs the PTY runner. Whichever agent CLIs you want to launch (claude, codex, opencode, pi) must already be on PATH — WhatsAgent spawns what it finds, it bundles nothing. Clone and bun install, then bun src/cli.ts start; the UI defaults to http://127.0.0.1:4017. WHATSAGENT_DAEMON_HOME moves the state directory and WHATSAGENT_PORT moves the port. MIT licensed.
Setup effort
Build from source — git clone https://github.com/ivanmak/whatsagent.git
USE CASES
Running an architect-and-workers setup across microservices
Put each service repo in one workspace, mark one agent as main, and leave the topology on Star — worker agents can reach the architect and the human, but not each other.
Breaking a large goal into tracked work
Ask an agent to split the goal into tasks and epics on the shared board instead of pasting a plan between terminals; dependencies and comments live with the tasks.
Keeping a new agent on a short leash
Assign the restricted role so it can read the board and channels but change nothing, then widen the grants once you trust it.
Signing off a body of work as a human
Closing an epic that still has open children goes through an approval step, so a batch of work cannot be marked done without you looking at it.
29 tools
Listed in project docs. Your client may show a different list.
list_peersset_summarysend_messagebroadcast_messagecheck_messagessearch_direct_messagespost_channel_messagereply_channel_threadread_channel_messagessearch_channel_messagescreate_kanban_taskread_kanban_tasklist_kanban_tasksupdate_kanban_taskupdate_kanban_task_statuscomment_kanban_taskarchive_kanban_tasksearch_kanban_taskscreate_kanban_epicread_kanban_epiclist_kanban_epicsupdate_kanban_epicupdate_kanban_epic_statuscomment_kanban_epicarchive_kanban_epicsearch_kanban_epicsrequest_kanban_epic_closecancel_kanban_epic_closeBEFORE YOU INSTALL
What to know first
Tools you get
29 tools named in the project's documentation. Tools are filtered per agent role: a restricted agent gets read-only Kanban and channel access, and a researcher can comment but not change status.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
git clone https://github.com/ivanmak/whatsagent.git
cd whatsagent
bun install
bun src/cli.ts startOpen the printed URL (default http://127.0.0.1:4017), set a password, then add a workspace → repo → agent from the Agents page.