MOSH is a modular, offline-first protocol for building smart home systems that are private, reliable, and resilient—designed specifically for embedded devices like the Teensy, ESP32, and nRF52.

This wiki is your central hub for all things MOSH: from getting started with basic nodes to understanding how to extend the protocol and contribute back.

Project Vision

Project Overview

Protocol Overview

Bridge – A node that relays messages between different transports.

Coordinator – The primary logic node that manages the local network.

Gateway – A node that interfaces with external systems (e.g., internet, phone app, MQTT).

Peripheral – A node that performs a dedicated function (like sensing or controlling).

Mosh Core

Element Manager

Virtual Wire Manager

Transport Manager

Element Library

Sensor Library

Transports

Hardware Support Matrix

MOSH Coordinator (Waveshare 7-inch Display Development Board)

Bridge

Gateway

Movement Detection (Waveshare ESP32 With Display and QMI8658 IMU)

Human Detection (Waveshare Human Micro-Motion Detection mmWave Sensor)

MOSH is an evolving protocol, and your contributions are welcome.

How to Contribute

Code Style Guide

Submit a Proposal

MOSH is designed to be:

Offline-first – No cloud dependency

Modular – Pick the features and transports you need

Private by Design – No hidden telemetry

Built for Real Hardware – Optimized for constrained MCUs

Need help or have a question? Open a Discussion or file an Issue