RAPP · programming language · RAPP rev-5

The wire that carries agents.

RAPP is the programming language for agents that keep a verifiable memory and talk over one exact wire. Five primitives, specified so independent implementations produce bytes each other can trust.

Quickstart — you never type code

Copy this prompt into your brainsurgeon — an agentic CLI like Claude Code or GitHub Copilot CLI — and watch it prove the spec while you sit back. Every task has a prompt like it in the prompt book.

You are my hands — I watch, you type. Clone https://github.com/kody-w/rapp-1 and prove
RAPP to me end to end: (1) run python3 conformance.py — I expect 16/16 PASS; (2) run
python3 realcheck.py — the spec against the live public estate — and explain the verdict
in plain English; (3) run python3 examples/01_hello_frame.py and walk me through the
frame it built, one line per key. Narrate as you go, show real output, and stop on any
red result — a red check is a finding, not something to patch around.

Or drive the machine yourself — the commands your brainsurgeon runs:

# clone, then watch the spec prove itself — and meet the real world
git clone https://github.com/kody-w/rapp-1 && cd rapp-1

python3 conformance.py     # 16/16 — controlled protocol vectors
python3 realcheck.py       # RAPP vs the REAL committed estate
python3 examples/01_hello_frame.py   # build & verify your first frame

Five primitives, one wire

Canonicalizationone value → exactly one sequence of bytes (RFC 8785 JCS)
Content addressingthe hash is the name, domain-separated so spaces never collide
Identitythe rappid — minted once, never a hash of a name
The frameone record that is both particle (worldline) and wave (wire)
The egga content-addressed package for a whole organism

Proven against the live public estate

46 / 46

committed frames whose addresses, chain links, and complete RAPP envelopes verified byte-for-byte in the captured 2026-08-20 audit; the 2026-08-26 re-observation of the grown estate accepted 50/50.

0 drift

across the synchronized frame and identity surfaces, re-audited on a weekly schedule. The earlier eight findings remain the book’s before-state evidence; green is generated by code, not prose.

The book — The RAPP Programming Language

  1. Prefacewhat it is, how to read it
  2. 1A Tutorial Introductionbuild a chain in one sitting
  3. 2Canonicalizationwhich bytes?
  4. 3Content Addressingdomain separation
  5. 4Identitythe rappid
  6. 5The Frameparticle & wave
  7. 6The WirePOST /chat
  8. 7The Eggportable handoff
  9. 8Trust & Signaturesauthorship
  10. 9Registry & Evolutionauthority
  11. 10Conformance & a Real Worldthe suite, the estate
  12. 11Implementing the Languagebuild a conforming core
  13. AReference Manualthe terse normative mirror
  14. BGlossary & Failure Atlasterms and refusal steps
  15. CSelected Exercise Solutionsworked answers