Summary
Forensic recovery for Apple Notes that runs entirely local. Exposes NoteStore.sqlite browsing, deleted note recovery, and case review as MCP tools. You point it at a NoteStore case root, it surfaces trashed and orphan notes without sending anything off your machine. Built for audit scenarios where you need receipts: every recovered note ships with its path, hash, and snippet. Reach for this when you need to prove what was deleted or pull notes from corrupted databases. Part of the xiaojiou176 "yard" family of structured proof tools. Uses stdio transport, so it plugs straight into Claude Desktop or any MCP client that can spawn local processes.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
notes-recover
your Apple Notes never really die
What You Get • Install • How It Work • Ecosystem
notes-recover is a forensic-grade reader for Apple Notes. Recover deleted notes, browse the raw NoteStore, and ship audit-ready bundles. Nothing leaves your machine.
🤝 Sister repo: want a prevention-side workflow that schedules backups before notes go missing? See notebackup — the Apple Notes backup control room (path-aware exports,
launchdscheduling, health checks).notebackupcovers the before;notes-recovercovers the after. Together they cover the full Apple Notes lifecycle on macOS.
┌──────────────────────────────────────┐
│ LOCAL-FIRST ████████ 100% │
│ SOURCE-TRACEABLE ████████ 100% │
│ TYPING REQUIRED ░░░░░░░░ 0% │
│ VIBES ████████ ZERO │
│ FILLER│
└──────────────────────────────────────┘
Recover, browse, prove. NoteStore is just SQLite if you know where to look.
What You Get
| Surface | What |
|---|---|
notes-recovery cli | Walk NoteStore.sqlite. Recover trashed and orphan notes. |
case review skill | Bounded Q&A over a single case root, no hallucinations. |
agent plugins | Drop-in for Claude, Codex, OpenClaw — case in, summary out. |
proof bundle | Every claim ships with the path, hash, and snippet. |
[!IMPORTANT] Local-first by default. No silent telemetry. No cloud round-trip. Your data stays on your machine until you explicitly ship it somewhere.
Install
git clone https://github.com/xiaojiou176-open/notes-recover.git
cd notes-recover
# follow the per-stack quickstart in INSTALL.md or docs/
Three commands. No curl | sh. No login. Read what you run.
Install break? Open your favorite agent and say "Read AGENTS.md and bootstrap notes-recover for me." Agent fix own brain. Long version: docs/.
How It Work
The repo is seven layers — exactly the seven commits in git log. New work goes in as small named PRs. No 50-file mystery commits.
| Layer | What |
|---|---|
chore: scaffold | License, governance, hygiene gates, CI scaffolding. |
feat(core) | The primary engine. The reason notes-recover exists. |
feat(modules) | Packages, adapters, services, plugins. The second floor. |
feat(contracts) | Schemas, configs, public boundaries. Other code talks here. |
test: | Receipts. Everything in this layer must run. |
feat(ops) | Scripts, infra, CI helpers, build glue. |
docs: | Public docs surface. The pretty face. |
git log reads like a building floor plan. Look once, know the whole shape.
Ecosystem
notes-recover lives in the yard family: seven yards. one philosophy: structured input, structured output, structured proof.
| Repo | What |
|---|---|
| switchyard | model & agent runtime switch board |
| browserclickyard | your AI clicks, your browser obeys |
| notes-recover (you here) | your Apple Notes never really die |
| dealyard | let prices fight, you sit and watch |
| docyard | docs site in, markdown out, no scraping by hand |
| fileyard | messy folders in, organized library out |
| proofyard | every claim ships with its receipt |
Cross-family taste: BeamMe · BrewMe · OpenVibeCoding · proofyard.
Star This Repo
If notes-recover saves you a click, an hour, or a headache — star costs zero. Fair trade. ⭐
Also by Yifeng[Terry] Yu
- switchyard — model & agent runtime switch board
- browserclickyard — your AI clicks, your browser obeys
- BeamMe — beam your agent config to any planet
- BrewMe — wake up, news already brewed
- OpenVibeCoding — AI codes overnight, you ship in the morning
License
MIT — small print, big freedom.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Categories
Registryactive
Packageapple-notes-forensics
TransportSTDIO
UpdatedApr 8, 2026
