DEV Community

Aditya Chavan
Aditya Chavan

Posted on

Building a Self-Managing Notes System for Claude Code

I got tired of Claude losing context every time a session ended, so I built a plugin that gives it a persistent, self-maintained notebook for each project.

What it does:

  • Claude keeps its own notes on the project as it works (architecture decisions, gotchas, TODOs, etc.)
  • Notes persist across sessions — no more re-explaining the same context every time you start a new chat
  • Hooks into the Claude Code lifecycle to keep notes fresh and relevant automatically
  • Lightweight, no external dependencies beyond Node

Repo: https://github.com/git-aditya-star/project-notes

Explainer page: https://git-aditya-star.github.io/project-notes/project-notes-explained.html

Would love feedback — especially if anyone tries it on a large/messy codebase and something breaks, or if the note-freshness logic feels off. Also open to feature requests.

(Full disclosure: I'm the author, sharing because I think others might find it useful.)

Top comments (0)