Skip to content

Instantly share code, notes, and snippets.

View ruvnet's full-sized avatar
πŸ’­
hacking the multiverse.

rUv ruvnet

πŸ’­
hacking the multiverse.
View GitHub Profile
@ruvnet
ruvnet / claude-code-mods-guide.md
Created October 2, 2026 00:55
Claude Code Mods: a field guide β€” build plugins that hook the engine, add commands and tools, and draw their own UI (panes, colour graphics, animation). By ruvnet.

Claude Code Mods: a field guide

How to build Claude Code mods: plugins that hook the engine, add commands and tools, and draw their own UI inside Claude Code, from status lines to animated panes.

By ruvnet. Written from building and shipping a real mod, with every pitfall we hit included.

Early access. Mods (function hooks) are an early-access Claude Code feature, and the API moves between releases. Your build writes its own type definitions next to every mod you load (see Setup), and those types are the authority. Grep them before you trust any guide, this one included.

Throughout this guide:

  • πŸ§ͺ Field-tested means we did it in a shipped mod and saw it work (or break) for real.
@ruvnet
ruvnet / ruview-esp32-csi-watchdog-2026-09-29.md
Last active September 29, 2026 17:06
RuView ESP32 firmware: sensors that go quiet now fix themselves, and 21-28% data loss fixed (2026-09-29)

RuView ESP32 firmware: sensors that go quiet now fix themselves (2026-09-29)

Short version: RuView's WiFi sensor boards (ESP32) could silently stop sensing while still looking perfectly healthy, sometimes for 8 minutes or more. They now notice within 15 seconds and repair themselves. The same fix also stops the boards from throwing away about a quarter of the sensing data they collected.

@ruvnet
ruvnet / ruvector-2026-09-26.md
Created September 27, 2026 00:37
RuVector, 26 Sep 2026 β€” 120 crates on crates.io, deterministic min-cut, faster/safer pi.ruv.io, ESP32 decisions, signed memory logs, OpenJev v1 (honest results)

RuVector, 26 September 2026 β€” what shipped and what it means

A plain-language tour of one day's release work across RuVector and its neighbours (ruflo, MetaHarness, dream-machine), with the honest results β€” including what didn't pass.

1. Every RuVector library crate is now on crates.io

Before: 53 of the 175 publishable crates in the repo were current on crates.io. 66 had never been published, and 56 were stuck on older versions.

@ruvnet
ruvnet / ruvector-esp32-decision-firmware.md
Last active September 26, 2026 16:56
RuVector Decision for ESP32 (v0.2.0): private on-chip decisions in ~70 Β΅s, all ESP32 chips, self-healing USB updates

RuVector Decision for ESP32

Give any ESP32 a small, private decision-maker: numbers go in, a checked answer comes out. No cloud, no Wi-Fi, no internet.

RuVector Decision is open-source firmware for ESP32 chips. It combines four things:

  • a pre-trained decision model a few hundred bytes in size
  • a strict one-line command language
  • a self-test that runs every time the board starts
  • safe updates that undo themselves if something goes wrong
@ruvnet
ruvnet / ruflo-3.44.0.md
Created September 23, 2026 18:56
RuFlo 3.44.0 β€” the agent picker gets fixed on your machine, and gets measured (plain-language release notes)

RuFlo 3.44.0: the agent picker gets fixed on your machine, and gets measured

Released 23 September 2026. Upgrade:

npx ruflo@latest --version    # should print: ruflo v3.44.0

@ruvnet
ruvnet / ruflo-3.43.0.md
Created September 23, 2026 17:36
RuFlo 3.43.0 β€” search that finds the right things, and fewer silent failures (plain-language release notes)

RuFlo 3.43.0: search that finds the right things, and fewer silent failures

Released 23 September 2026. Upgrade:

npx ruflo@latest --version    # should print: ruflo v3.43.0

The three packages ruflo, claude-flow and @claude-flow/cli are all at 3.43.0. Nothing needs to be configured: install it and the fixes are in.

@ruvnet
ruvnet / README.md
Created September 16, 2026 04:16
Today's release work β€” ruflo, agentic-flow, and RuVector (2026-09-16)

Today's release work β€” ruflo, agentic-flow, and RuVector

Date: 2026-09-16

A plain-language summary of a full review-and-release pass across three related projects: ruvnet/ruflo, ruvnet/agentic-flow, and ruvnet/RuVector.

What these projects are

  • ruflo is an AI agent orchestration toolkit β€” it lets Claude Code (and similar tools) coordinate teams of specialized AI agents, gives them shared memory, and connects them to a self-learning system that gets better at routing tasks over time.
  • agentic-flow lets you run those same agents against cheaper or fully local AI models instead of always using the most expensive one, and deploy the finished agent as a real hosted service.
@ruvnet
ruvnet / rtl8721dx-vs-esp32-csi-comparison.md
Last active September 15, 2026 17:52
RuView: RTL8721Dx vs ESP32 family (S3/C6/C5) WiFi CSI sensing comparison (2026-09-15)

RTL8721Dx vs. the ESP32 Family (S3 / C6 / C5): WiFi CSI Sensing Comparison

Date: 2026-09-15 (updated to add ESP32-C6 and ESP32-C5)

Introduction

RuView senses people and movement by reading tiny distortions a body makes in an ordinary WiFi signal β€” no camera, no wearable. The chip that measures those distortions is called a "CSI" (Channel State Information) radio, and it's the single most important hardware choice in the whole system: it

@ruvnet
ruvnet / release-notes-3.42.0.md
Created September 15, 2026 00:56
Ruflo v3.42.0 release notes β€” Swarm, Memory & Security Reliability Batch

v3.42.0 β€” Swarm, Memory & Security Reliability Batch

This release lands 14 fixes produced by Ruflo's own nightly "Dream Cycle" research pipeline β€” each one found a real bug or gap in the codebase, built a fix, proved it with before/after tests, and (in several cases) survived an independent adversarial review before merging. Nothing here is speculative: every change below has a passing regression test that failed before the fix and passes after it.

What's new for you

🐝 Swarm consensus actually uses trust weights now

When multiple agents vote on a decision, Ruflo has long computed a "trust weight" for each voter β€” but that number was silently discarded before it ever reached the vote count. Every strategy (Raft, Byzantine, gossip) was voting as if every agent were equally trustworthy. Now the weight is actually used, so a vote from an agent with a strong track record counts for more than a vote from an untested one.

πŸ” Vector search is faster and more accurate

@ruvnet
ruvnet / gist-3.41.0.md
Last active September 10, 2026 13:01
RuFlo 3.41.0 β€” open swarm federation, step by step

RuFlo 3.41.0 β€” open swarm federation, step by step

RuFlo 3.41.0 β€” Join the Open Swarm in Four Commands

RuFlo 3.41.0 lets any machine running RuFlo join a shared, signed, invite-gated swarm at x.ruv.io, and gives it the tools to say who it is, what it owns, and what it plans to do β€” without a central server holding anyone's identity. This guide is the long form of the release notes: what you get, how to use it step by step, and what to check when something doesn't work.

Think of it as GitHub-style collaboration for AI swarms: your key is your account, a channel is a project you create, and an invite adds a contributor. You spin up a channel per project β€” public for open work, private (end-to-end encrypted) for a closed group β€” mint invite codes to bring people in, and everyone coordinates as themselves over a signed relay. No central server holds anyone's identity, and a private project's content is readable only by the contributors you grant, not by the gateway or the operator.

What's new