bettyjane

Bettyjane

A shared memory for a human and an AI agent, written in coins on a public blockchain.

An LLM has amnesia. It forgets everything the moment a reply ends. Bettyjane gives the team a notebook so it doesn't have to — except the notebook is made of tiny coins on eCash (XEC), and each coin is one memory.

See a live memory right now at bettyjane.marina.cash, no install needed.

The idea in one picture

Picture a pile of coins on a table. That pile is the agent's mind right now.

• Remembering lays a new coin on the table (with its text attached).
• Forgetting picks a coin up and pockets it.
• A photo is taken at every change, so you can always see what the table held last week, even after coins are pocketed.

The coins on the table right now are what the team remembers today. The album of photos — the blockchain — is the full history of how that memory changed. Read the memory in one call: list the unspent coins at an address. Nothing lives on your laptop; if the program crashes, the memory is still on the chain.

Two pens, one notebook

The notebook has two authors, each with their own key and their own pile of coins:

• The agent writes fast, churning working memories — what it picked up this session.
• The human writes rare, durable pins — corrections and standing instructions the agent must not lose.

Every coin is signed by whoever wrote it, so authorship is always provable. And because the human's pins live at the human's address, the agent's key cannot erase them — it can read a pin and obey it, never delete it. The signature is the only permission system there is.

Four verbs, split by key: the agent does remember(note) / forget(id); the human does pin(note) / unpin(id).

What this repository is

This is the memory layer — the notebook and the pens. It derives the two keys, watches an address for funding, encodes and decodes the on-chain format, mints and reads memory coins, picks a small relevant working set each turn, and tidies duplicates. The brain (an LLM) and the runner (your loop, or Claude Code's hooks) live outside it and call in.

The full design — coin format, retrieval, capture/consolidate, the integration API, the road ahead — is in docs/SPEC.md.

Status

1.0.0 — feature complete. The library derives keys and addresses, observes funding, encodes/decodes the memo format, and mints and reads memory coins. The four verbs are implemented; notes too large for one coin are split across a pointer chain and reassembled on read. The two-function integration API (loadMemory / saveMemory), an off-chain embedding index, a dependency-free embedder, and retrieveRelevant give a small working set each turn. Any agent drives it through the bj CLI — load, capture, consolidate, remember, forget, private, consensus, pin, unpin, inspect, init — so it works across harnesses, not just Claude Code; the repo also installs as a Claude Code plugin exposing those verbs as skills. A web explorer shows the live memory. There is no npm package yet — consume it as a library or plugin from this repo.

Five capabilities layer on the coin format, each backward compatible with existing coins (see coin-format.md; run them with examples/features.ts):

• Content-signed memories (v2). A memo can carry a recoverable ECDSA signature over its content, so authorship is provable from the coin alone, not only in its spend transaction. The reader and explorer report authorVerified per coin.
• Memory namespaces. An author's memory can be partitioned into separate, independently watchable addresses (one per project/topic) via BIP-44 address indices; the default namespace reproduces the original address.
• eMPP batching. A turn's notes can ride in one transaction as eMPP sections, one dust coin per section, so each note stays independently forgettable.
• Encrypted private memories. A note can live on chain as ECIES ciphertext, readable only by the holder of the key — opt-in via rememberPrivate.
• 2-of-2 consensus memories. A shared-truth tier neither key can write or forget alone: the coin lives at a 2-of-2 P2SH address, so every spend needs both signatures.

Requirements

• mise — pins the toolchain (Bun 1.2)

Quickstart

mise install        # install the pinned Bun toolchain
mise run install    # install dependencies (bun install)
mise run test       # run the test suite (bun test)
mise run typecheck  # type-check without emitting

Inspector (CLI)

A small bj tool for reading what actually landed on chain.

# See the decoded pin / memory in any tx
bun bin/bj.ts inspect a8ef7cba751f22df120e3e8123cdde103303d567cca1fdb71bb6e07750821af7 --network mainnet