[mh]mhproto

Machine–Human Protocol Published development preview

A shared contract for
humans and agents.

Agents write the code. People still have to understand it.
Review each feature’s behaviour, API and checks before it’s built, and keep them in view as it changes.

Explore the demo
npm install -D mhproto@next

0.8.0-preview.0 on npm ↗ Release notes Get started → Watch the 42-second walkthrough ↓

Node 22+. Local files. Your repository. No hosted service required.

Inside a contractOpen full demo

Daily case

Loads today’s puzzle and any saved play. The page shows the introduction or resumes the current phase.

URL/daily

API

GET/daily/todayOpen endpoint

Load today’s case and saved play.

Request

Query

GetTodayQuery {
date: string;
deviceId: string;
}

Response 200

DailyTodayResponse {
case: DailyCaseView | null;
play: DailyPlayState | null;
streak: integer;
}

Expand to read fields. Follow a type to see where it’s used.

Behaviour

A missing case shows an unavailable state. An existing play resumes without starting another.

Checks

23 linked checks passed in the saved local pilot.

One feature. Types, rules and checks connected.View changes

42-second walkthrough

Describe it. Review it. Hand it off. Verify it.

One feature from the demo: its endpoint and linked types, a change between iterations, the context an agent reads and its verification status.

  1. 01

    Agree

    Behaviour, interfaces and examples.
    A contract you can review before coding.

  2. 02

    Review

    Linked types and iteration diffs.
    See exactly what changed.

  3. 03

    Verify

    Checks tied to the contract.
    Keep passing, failing and stale distinct.

Start small

One feature.
One shared understanding.

Adopt a feature you already have, or describe the next one. Five repository-local skills help Codex and Claude discover, specify, implement, verify and reconcile it.

Read the getting-started guide
Install from npm · Agent options 
npm install -D mhproto@next
npx mhproto init --agent codex
npx mhproto view

Node 22+. Development preview · 0.8.0-preview.0 on npm ↗