Skillget

mhproto

agent
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • exec() — Shell command execution in examples/plugin-sql/index.mjs
  • network request — Outbound network request in scripts/audit-mermaid.mjs
  • exec() — Shell command execution in scripts/mermaid-build.mjs
  • network request — Outbound network request in scripts/mermaid-build.mjs
  • exec() — Shell command execution in scripts/prepare-release.mjs
  • spawnSync — Synchronous process spawning in scripts/prepare-release.mjs
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Machine–Human Protocol: a shared contract workspace for humans and coding agents

README.md

MHProto

Put the contract first. See what a feature does, its API and its checks before agents build it,
and keep it visible as the code changes.

For teams building with Claude Code, Codex and other coding agents, especially full-stack features where frontend and backend share an API.

npm (next)
CI
License: MIT

Live demo · How it works · Docs

42-second walkthrough of MHProto. The same rule ID links a feature's Markdown rules, OpenAPI operation, example and test. The browser viewer shows the feature, an endpoint page, a type page listing every endpoint that uses it, and the changes since the last snapshot. The terminal prints the compact context packet an agent reads for one endpoint. The viewer then shows 10 of 10 linked checks passing. The video ends with npm install -D mhproto@next.

What you get

  • See it: every feature as linked pages: behaviour, endpoints, types, rules and examples. Product, design, frontend and backend read the same thing.
  • Change it early: snapshot the contract, edit it, and review what changed before any code moves.
  • Keep it true: checks link tests to rules, so you see what's passing, failing, stale or untested.
  • Hand it off: your agent builds from the same contract, one endpoint at a time.

npx mhproto build exports the whole contract as one HTML file anyone can open. It all runs from
plain files in your repo: no hosted service, no account and no AI calls.

Quick start

npm install -D mhproto@next        # Node 22+
npx mhproto init --agent claude    # or --agent codex, or --agent all
npx mhproto view                   # serves http://127.0.0.1:4317

Replace the generated example with one real feature, or ask your agent to "use mhproto-discover
to draft a contract for one feature".

Next: How it works follows one feature end to end, with real files and
output. The reference guide covers every command.

0.9.0-preview.0 · development preview · Feedback ·
Contributing · MIT (third-party notices)

Reviews (0)

No results found