Skip to content

v3.0.0 β€” The One With The Engine That Will Now Be Able to Update Itself (Without Touching Your Notes) πŸ”„

Choose a tag to compare

@tpierrain tpierrain released this 14 Jun 22:46
· 119 commits to main since this release
f22068f

πŸ“¦ How to install β€” don't download the archives below. Your brain is generated by cloning this launcher, not by unzipping it (the installer reads the repo via git, so it needs the git history). Follow the README β†’ Install: git clone … && node installer.mjs. The "Source code (zip/tar.gz)" assets at the bottom are added automatically by GitHub and can be ignored.


πŸ”„ The headline: your brain now upgrades its own engine β€” without ever touching your notes

From v3.0.0, every generated second brain ships with a built-in, opt-in updater (update-engine). Ask in plain words β€” "update your engine, please" β€” confirm, done. No terminal, no re-running the installer, no new folder.

  • Self-carried updater. The brain carries its own update-engine + libs (it can upgrade even the updater).
  • engine-manifest.json = the readable map. Spells out what counts as engine (upgradable) vs what is yours (off-limits), and records where a newer engine is pulled from.
  • Throw-away errand. Fetches a disposable copy of the newer engine into a temp folder, applies only the engine pieces, deletes the temp folder. Nothing lingers.
  • Reindexes only if the index format changed β€” otherwise your search keeps working untouched.
  • Cross-platform parity (macOS Β· Linux Β· Windows) is a release gate (ADR 0015).
  • Offline version display β€” the brain can see its own engine version (this git tag) with no phone-home, so it may even offer the update on its own.

Sacred β€” never touched by an update: your notes, your .env keys, your CLAUDE.md constitution, your settings, and your custom skills.

First clean semver release (ADR 0017). V1/V2 were legacy tags.