Skip to content

Releases: yinanli1917-cloud/searching-apple-notes

Searching Apple Notes — v1.0

Choose a tag to compare

@yinanli1917-cloud yinanli1917-cloud released this 26 Apr 20:19

The first stable release of searching-apple-notes as a Claude Code Skill.

Talk to Claude in plain English or Chinese, and it answers from your Apple Notes — semantically, locally, with no API keys and no MCP setup.

用中文或英文跟 Claude 说话,它直接从你的 Apple Notes 给你答案——语义检索、全本地、不需要 API key、不需要配置 MCP。

What's in v1.0

  • Claude Code Skill at skills/ — drop-in, auto-loads search and note-writing capabilities into any Claude Code conversation
  • BGE-M3 embeddings — native Chinese-English mixed-content semantic search, 100+ languages
  • Local-first — all data and inference stay on your Mac; the only network call is the one-time BGE-M3 model download from Hugging Face
  • ChromaDB vector store — local, persistent, no external services
  • Bilingual README + FAQ + llms.txt — discoverable by humans and AI

Install

git clone https://github.com/yinanli1917-cloud/searching-apple-notes.git ~/Library/Mobile\ Documents/com~apple~CloudDocs/claude-skills/searching-apple-notes
cd ~/Library/Mobile\ Documents/com~apple~CloudDocs/claude-skills/searching-apple-notes
pip install -r requirements.txt
python scripts/sync_index.py    # one-time index build

Then in any Claude Code session, ask: "find my notes about [topic]" — Claude does the rest.

Notes

  • Older MCP server + cloud deployment code (Cloudflare Worker, Railway, Fly.io, Poke AI) has been moved to legacy/. The skill replaces the need for any hosted service.
  • The MCP server is still locally runnable from scripts/server.py if you prefer the Claude Desktop / Poke route.