the memory for an ADHD developerSTOP RELEARNING YOUR OWN PROJECT
Plain markdown files your AI agent keeps updated. Come back and it already knows where you left off.
$ npx cognitiveos init
02 / The Problem
Lost context becomes lost momentum.
THE 30 MINUTE TAX
15-30
minutes lost reopening context. Not coding.
Recovering.
Structure beats willpower.
03 / Beyond CLAUDE.md
Instructions are not session state.
RULES DO NOT REMEMBER WHERE YOU STOPPED
CLAUDE.md
the map + routes
where things live
mostly static
STATE.md
where you are
rewritten by agent
current every session
CONTEXT.md
one per zone
the workspace's manual
how to work in it
A productivity system asks you to maintain it. This maintains itself.
0xnull, the keeper, writes STATE.md and repairs drift, so you never do the bookkeeping.
04 / How It Works
Come back. Your agent already knows.
YOUR AGENT READS THE FILES FIRST
Plain markdown next to your code. Your agent updates it as you work, and reads it back before it touches anything.
Hooks save your state when you close the session and load it when you open. You never run a save command. Disappear for two weeks and it still knows where you were.
05 / Six Zones
One folder per cognitive mode.
SIX ZONES ONE BRAIN
- brain-dump/
- queue/
- focus/
- projects/
- ideas/
- someday/
focus/ holds exactly one task. The agent refuses a second. check fails loudly if two appear.
06 / Commands
Session hooks for Claude Code + Antigravity. Skill files for all four.
INIT ONCE KEEP THE THREAD
cognitiveos init
scaffold once
cognitiveos start
show the handoff
cognitiveos dump
capture a thought
cognitiveos check
verify the install
cognitiveos install-skill
add skills to your agents
Works with: Claude Code, Codex, Cursor, Antigravity.
Session hooks: Claude Code, Antigravity. Skill files: all four.
07 / Open Source
FREE • OPEN SOURCE • YOURS.
MIT licensed. No servers, accounts, or database.
Just markdown on your machine.
08 / Start
Install the structure. Keep the thread.
OPEN YOUR LAPTOP KNOW WHAT TO DO
$ npx cognitiveos initAlready have a project? cd in and run init. It adds files next to your code and never touches your code.