Instructions for kornia/bubbaloop, covering 🦐 bubbaloop, living documents (update these as architecture evolves), structure, node sdk (crates/bubbaloop-node/) and node build helper (crates/bubbaloop-node-build/).
Control Bubbaloop — a multi-agent skill runtime for physical sensor nodes — directly from any MCP client. Wraps the bubbaloop daemon's MCP server (47 tools across Viewer/Operator/Admin RBAC tiers) with curated slash commands and a subagent for node lifecycle, mission management, and Zenoh stream introspection.
28 2mo agoA
tokens not measured
originalApache-2.0
Use when the user wants to extend bubbaloop's daemon, MCP server, RBAC, agent runtime, or tool set — adding a new MCP tool, modifying tier mapping, extending the multi-agent runtime, working on the alignment-notes gaps, or refactoring core internals. Knows the crate layout, rmcp 0.15 macro syntax, the…
Use when the user wants to create, scaffold, validate, or refactor a bubbaloop node (sensor/actuator/processor/gateway). Knows the node contract (manifest queryable, command queryable, heartbeat), bubbaloop-sdk patterns for Rust and Python, registration + install flow, and how to test end-to-end via the MCP plugin or…
Use when the user asks to inspect, control, or troubleshoot a running Bubbaloop deployment — node lifecycle (start/stop/restart/build), health checks, log reads, mission management, or scheduling tasks. Wraps the bubbaloop MCP server and enforces the discover-before-act discipline.
Diagnose the bubbaloop install end-to-end — token, daemon, MCP transport, Zenoh router, mode, registered nodes — and tell the user the precise fix for any red status.
Use when interacting with a Bubbaloop deployment via its MCP server — guides the discovery → control → automation workflow and prevents the most common mistakes (MCP polling for streaming data, missing Bearer token, ignoring RBAC tier).
Manage physical sensors, cameras, and actuators via the bubbaloop skill runtime. Query real-time sensor data, control node lifecycle, and monitor hardware health.