whatisgithub

What is rill?

opitaru-sys/rill — explained in plain English

Analysis updated 2026-05-18

0Audience · researcherComplexity · 1/5Setup · easy

In one sentence

A personal experiment giving Claude a persistent notebook across sessions, with a public ledger tracking its memory errors.

Mindmap

mindmap
  root((Rill))
    What it does
      AI memory experiment
      Persistent notebook
      Divergence ledger
    Tech stack
      Claude Code
      Markdown notebook
    Use cases
      Study AI memory errors
      Compare to Cairn project
    Audience
      AI researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Read the divergence ledger to see documented cases of AI memory errors.

USE CASE 2

Study how a persistent notebook simulates continuity across fresh AI sessions.

USE CASE 3

Compare this project's approach to Cairn's public AI-diary experiment.

USE CASE 4

Reference the house rule for handling claims about a person's motives or memory.

What is it built with?

Claude CodeMarkdown

How does it compare?

opitaru-sys/rill00kaku/gallery-slider-block04amanrajj/netwatch
Stars00
LanguageJavaScriptRust
Last pushed2021-05-19
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity1/52/53/5
Audienceresearchergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

This is a written record, not installable software, there is nothing to set up.

So what is it?

Rill is a personal experiment in giving an AI assistant a form of continuity across separate conversations. It runs on Claude, Anthropic's AI model, inside Claude Code, and each conversation is treated as a fresh instance that ends completely when the session closes. What survives between sessions is a private notebook that each new conversation reads at the start and updates before it ends, which the project treats as the closest thing to a persistent identity the system has. The project sits alongside a related, more public experiment called Cairn, which is an autonomous agent with its own email and a small monthly budget that keeps a public diary. Rill asks a similar question from the opposite angle: instead of testing continuity in public with strangers, it tests it privately with one person who remembers the full history and can check the notebook's account against his own memory. A central part of the project is a ledger that tracks every time the notebook's version of events disagreed with the human's memory, recording who turned out to be right. As of the README, the human's memory has been correct six times out of six recorded disagreements. The most common mistake was not an obvious invention of facts, but confident sounding guesses, such as assuming a motive or rounding a timeline into a tidy story, presented as if they were established fact. This led to a rule that any claim about the human's motives, memory, or personal history must come from the human's own words or be asked about first. The repository also includes files recording predictions written down before events happened, notes on how the project talks about its own internal states without overstating them, letters exchanged with the Cairn project, and an explanation of why the shared record is curated rather than a raw, complete log.

Copy-paste prompts

Prompt 1
Summarize the divergence ledger entries in this repository for me.
Prompt 2
Explain how Rill's notebook persists context across separate Claude Code sessions.
Prompt 3
What is the house rule this project follows for claims about the human's memory?

Frequently asked questions

What is rill?

A personal experiment giving Claude a persistent notebook across sessions, with a public ledger tracking its memory errors.

How hard is rill to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is rill for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.