git404hub

what is onemind.md fr?

lazardanlucian/onemind.md — explained in plain English

Analysis updated 2026-05-18

11Audience · developerComplexity · 2/5Setup · easy

tl;dr

A spec that gives a git repo persistent memory of an AI agent's decisions, stored invisibly using git internals.

vibe map

mindmap
  root((onemind.md))
    What it does
      Stores agent memory in git
      Uses a hidden ref
      Invisible to git status
    Tech stack
      Git plumbing
      commit-tree
      update-ref
    Use cases
      Record decisions
      Track rejected ideas
      Resume agent sessions
    Audience
      Developers
      AI agent builders

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 make with this?

VIBE 1

Let an AI coding agent record why it made a decision so the reasoning is not lost later.

VIBE 2

Track ideas an agent tried and rejected so future work does not repeat the same dead ends.

VIBE 3

Pick up an AI agent's previous work session exactly where it left off using stored context.

VIBE 4

Carry a project's decision history along automatically whenever the repo is cloned.

what's the stack?

Git

how it stacks up fr

lazardanlucian/onemind.md100/stock-analysis-markov100/tab-organizer
Stars111111
LanguageJavaJavaScript
Last pushed2016-12-252021-03-01
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/53/51/5
Audiencedeveloperresearchergeneral

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

how do i run it?

Difficulty · easy time til it works · 5min

No database or extra service is needed, it relies entirely on git plumbing commands.

The README does not state a license.

in plain english

onemind.md is a one-file specification that gives a git repository a kind of memory, using nothing but git's own internal building blocks. The idea is that an AI coding agent working in a repo can record its decisions, the ideas it tried and rejected, and other context, and store all of that as git objects on a hidden reference called refs/mind/main. This hidden reference does not show up in your working folder, does not create a mind folder you can see, and does not touch git status, so it stays completely separate from your normal commits and branches. The point of storing this information is to answer questions that normally get lost, such as why a certain approach was chosen, what was tried and rejected already so nobody wastes time repeating it, and what the previous work session figured out so the next one can continue from there. Because the memory is stored as git objects, it travels with the repository automatically. Anyone who clones the repo gets the mind along with the code, with no separate database or service required. The project sets some safety rules for how this memory should be used: nothing should ever be written to the visible working tree, secrets or personal information should never be stored in it, entries should only be added and never rewritten, with corrections handled through git notes instead, and there is a soft size limit of 1 gigabyte by default, with old entries meant to be pruned over time. The README also points to a separate document describing an abstract version of the idea that could work with tools other than git. A live example of how it looks in use is shown in an animated GIF in the repository.

prompts (copy fr)

prompt 1
Implement the onemind.md spec in this repository so my agent can record its decisions.
prompt 2
Show me the git log of the hidden mind ref to see why a past decision was made.
prompt 3
Explain how onemind.md keeps recorded thoughts separate from my normal git commits.
prompt 4
Adapt the ONEMIND-DIY spec so a non-git tool can store agent memory the same way.

Frequently asked questions

what is onemind.md fr?

A spec that gives a git repo persistent memory of an AI agent's decisions, stored invisibly using git internals.

What license does onemind.md use?

The README does not state a license.

How hard is onemind.md to set up?

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

Who is onemind.md for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.