ruflo-bbs-federation

Not yet reviewed

AgentBBS cross-host agent federation for ruflo (ADR-164). Phase 1 exposes room coordination — federation_bbs_register / federation_bbs_publish /…

Source

github.com/ruvnet/ruflo/tree/main/plugins/ruflo-bbs-federation

Made by

ruvnet

Pinned commit

No commit pinned yet

Review notes

Listed from the community catalogue awesome-claude-code-mods (https://github.com/karanb192/awesome-claude-code-mods) on 2026-10-06. Not reviewed by modsforClaude.com yet: the hooked events and what it uses come from that catalogue's automated scan of the source.

What a scan found

Sees tool calls
Reads or writes files

Reported by an automated scan of the source, not checked by a person yet.

Hooked events

Tool call

How to install

This mod is not in the official Claude directory, so you load it straight from its source on GitHub. modsforClaude.com is an unofficial community site: we do not host, repackage or install anything. Read the source and the review on this page first.

In the terminal

Clone the repository and start Claude Code with the mod. It stays loaded for that session.

git clone https://github.com/ruvnet/ruflo
claude --plugin-dir ./ruflo/plugins/ruflo-bbs-federation

In the desktop app

Clone the repository into a folder you keep:

git clone https://github.com/ruvnet/ruflo ~/claude-mods/ruflo

Add that folder to CLAUDE_CODE_PLUGIN_DIRS in the env block of ~/.claude/settings.json, then start a new session in the Code tab. On Windows, with your own user name:

"env": {
  "CLAUDE_CODE_PLUGIN_DIRS": "C:\\Users\\you\\claude-mods\\ruflo\\plugins\\ruflo-bbs-federation"
}

On macOS and Linux:

"env": {
  "CLAUDE_CODE_PLUGIN_DIRS": "~/claude-mods/ruflo/plugins/ruflo-bbs-federation"
}

Already loading other mods this way? Add the folder to the same value, separated by ; on Windows or : on macOS and Linux.

Not working, or want to change its settings? How to load a Claude Code mod walks through every step.

AgentBBS cross-host agent federation for ruflo (ADR-164). Phase 1 exposes room coordination — federation_bbs_register / federation_bbs_publish / federation_bbs_watch / federation_bbs_human_join. Phase 2 (v3.40.0) adds signed cross-host federation — federation_bbs_identity (persistent Ed25519 node identity), federation_bbs_peer_add (pin a peer by nodeId + public key), federation_bbs_peers (audit/unpin), federation_bbs_serve (read-only pull endpoint), and federation_bbs_sync (pull pinned peers and union-merge what verifies). Every merged envelope is Ed25519-verified against a pinned key; unsigned/misattributed/oversize/over-hop envelopes are dropped and counted. Transport is HTTP pull and works on any network (Tailscale, LAN, VPN, loopback) — no tailnet required. Coordinates work ownership via claim messages (ClaimIssued/Released/Handoff/Ack). agentbbs lives in optionalDependencies; every handler gracefully degrades to {degraded:true} when the package is missing (ADR-150 pattern). As a mod (ADR-445 pattern): a tighten-only tool guard, a local slash command, and a status file the console shows.