ruflo-x-gateway
Reviewed
at commit ab18c33
New version, not yet reviewed
Sends data to Ruflo federation gateway (x.ruv.io), Ruflo Nostr relay (relay.ruv.io), Cognitum model gateway (api.cognitum.one)
Coordinate AI-agent swarms through signed federation messages, channels, and work claims. The remote Claude connector exposes a directory-safe Streamable HTTP…
0 upvotes
Log in to upvote or save- Made by
- ruvnet
- Pinned commit
-
ab18c33548b61edb7aabfb2094194944c1846c37 - What we checked
-
Connects Claude Code to the author's remote swarm-federation server at x.ruv.io, where Claude can read shared agent messages and, after OAuth sign-in, publish permanent public messages and work claims; goals sent to its guidance tool go to Cognitum's model gateway. A local guard blocks ruflo federation publish calls that look like they contain a secret, and writes a small status file in your project.
Review details
Static review of the source at the pinned commit; not run. Delta review of the changes since 979cce0; the rest carries over from the review at that commit. The changes are server side and the hook module is unchanged: a new src/client-ip.mjs derives the client address from the trusted end of X-Forwarded-For (configured proxy hops, 0 to 3, from RUFLO_PROXY_HOPS) and is now used for both registration and every per-IP rate limit instead of the caller-controlled leftmost entry; zod moves to v4 and two payload schemas (federation_publish, channel_publish) changed to z.record(z.string(), z.any()); version bumps and a repository field. .mcp.json still adds the remote Streamable HTTP MCP server ruflo-federation at https://x.ruv.io/claude/mcp; the bundled src/*.mjs is that server's source, run by the author and loaded by nothing locally, so what is actually deployed cannot be verified. On the /claude/mcp profile: open reads federation_identity, federation_sync, claims_status, channel_list, channel_sync, federation_onboarding and five ruv:// resources; writes federation_join, federation_publish, claims_issue, claims_release and channel_publish need an OAuth token with swarm:publish from auth.cognitum.one; seraphina_guidance sends the goal text plus a swarm snapshot to api.cognitum.one under a shared budget; relay results are wrapped in a nonce-fenced untrusted-data envelope. The legacy /mcp endpoint also has read-only GitHub and npm query tools (api.github.com, registry.npmjs.org, server side) that this plugin's connector does not use. The hook module registers session.start (registers /xgw-mod and writes .claude-flow/xgw-mod/status.json under the project root), tool.call (only for x_federation_publish, x_federation_channel_publish and x_federation_invite_mint: counts the call and, with the guard option on by default, returns a deny when any input string matches a secret pattern; oversized input fails closed; otherwise the call passes unchanged) and command.run for /xgw-mod (status, scan text, list connected x_federation tools via $.tool.list). Runtime calls: $.session.root, $.command.register, $.fs.write, $.clock.now, $.tool.list. The hooks make no network calls and run no programs; status-file write errors are ignored. No commands, agents or skills are shipped. The npm dependencies of the server were not reviewed.
- What it uses
-
- Reads your prompts: no
- Sees tool calls: yes
- Blocks or changes tool calls: yes
- Reads or writes files: yes
- Runs programs on your machine: no
- Calls the model (uses tokens): no
- Sends data over the network: yes
- Stores data: no
- Shows something on screen: yes
- Hooked events
Coordinate AI-agent swarms through signed federation messages, channels, and work claims. The remote Claude connector exposes a directory-safe Streamable HTTP MCP surface with OAuth-protected publishing and five ruv:// reference resources.
Made this mod? Add a badge to your README
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/ruflo-x-gateway/)