notes-snapshot-control-room

notes-snapshot-control-room is a skill for Claude Code, Codex from xiaojiou176-open/notebackup. It costs 85 tokens per session (959 once invoked), scanned A, original, MIT.

A guide for connecting Apple Notes Snapshot, a local macOS Apple Notes backup tool, to a coding host.

In plain words
What is it for?
Use it to acquire and verify notesctl, prepare local state, wire MCP, and troubleshoot host connections.
Why use it?
It separates local backup, optional diagnosis, a same-machine web API, and read-only MCP connections so an attachment is not described as more complete than it is.

Skill for Claude CodeCodex

Which agent this was written for is unclear — built for openclaw. Also seen: mentions Claude Code; mentions Codex; built for openclaw.

Good fit Use it to acquire and verify notesctl, prepare local state, wire MCP, and troubleshoot host connections.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/xiaojiou176-open/notebackup/notes-snapshot-control-room
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add xiaojiou176-open/notebackup --skill notes-snapshot-control-room
Clone the repo
git clone --depth 1 https://github.com/xiaojiou176-open/notebackup

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for notes-snapshot-control-room

README.md
[![agentmods](https://agentmods.dev/badge/skills/xiaojiou176-open/notebackup/notes-snapshot-control-room/github.svg)](https://agentmods.dev/skills/xiaojiou176-open/notebackup/notes-snapshot-control-room)
Your own site
<a href="https://agentmods.dev/skills/xiaojiou176-open/notebackup/notes-snapshot-control-room"><img src="https://agentmods.dev/badge/skills/xiaojiou176-open/notebackup/notes-snapshot-control-room/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for notes-snapshot-control-room

Your own site · 80×15
<a href="https://agentmods.dev/skills/xiaojiou176-open/notebackup/notes-snapshot-control-room"><img src="https://agentmods.dev/badge/skills/xiaojiou176-open/notebackup/notes-snapshot-control-room.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 85 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 959 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00085 $0.00959
Opus 5.5 $0.00034 $0.00384
Sonnet 5.5 $0.00017 $0.00192
Haiku 4.5 $0.00009 $0.00096

Measured 1mo ago against content hash f23cc9e30500, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

notes-snapshot-control-room scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

examples/public-skills/notes-snapshot-control-room/SKILL.md · 113 lines

How it starts

The opening of the file, as written. The whole thing — 113 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Apple Notes Snapshot Control-Room

Purpose

Help a host, plugin, or collaborator consume Apple Notes Snapshot without rewriting it into a hosted AI platform or a generic assistant product.

What this skill teaches

  • how to acquire notesctl from a public checkout when the host does not already have it
  • how to prove the local control room before touching builder surfaces
  • how to wire notesctl mcp into a host without pretending there is a remote service
  • how to separate AI Diagnose, Local Web API, and MCP into three different lanes
  • how to talk about attach proof honestly

Keep this identity first

  • Apple Notes local-first backup control room for macOS
  • notesctl is the canonical human entrypoint
  • AI Diagnose is an advisory sidecar
  • Local Web API is token-gated and same-machine
  • MCP is stdio-first and read-only-first

First-success flow

  1. Acquire notesctl first using references/INSTALL.md.
  2. Prove the operator lane first:
    • ./notesctl run --no-status
    • ./notesctl install --minutes 30 --load
    • ./notesctl verify
    • ./notesctl doctor
  3. Only after local state exists, attach the builder lane:
    • ./notesctl ai-diagnose
    • ./notesctl web
    • ./notesctl mcp
  4. Keep host proof separate from repo proof.

MCP capability surface

  • post-attach host checks should see get_status, run_doctor, verify_freshness, get_log_health, list_recent_runs, and get_access_policy
  • the repo also documents the notes-snapshot://recent-runs resource as a first read-back surface
  • boundary: local stdio only, read-only-first tools/resources, and no hosted runtime

Preflight before any attach claim

Do not treat host registration as proof by itself.

Verify:

  1. ./notesctl run --no-status
  2. ./notesctl verify
  3. ./notesctl doctor --json
  4. ./notesctl status --json

If those fail, call it a local snapshot preflight problem, not an MCP bug.

Truthful distribution boundary

  • Repo-owned starter packs and local marketplaces are public-ready wiring kits.
  • They are not the same thing as official public directory listing.
  • A tagged v0.1.12 named-host attach-proof trail on one machine does not become a universal proof for every host build or every machine.

Read the full file on GitHub · 113 lines

Files

What ships with it

9 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 113 lines · 85 tokens per session scan A f23cc9e30500

Subscribe to this mod's changes

notes-snapshot-control-room is a skill published in the GitHub repository xiaojiou176-open/notebackup (1 stars, last pushed 4mo ago), licensed MIT. It adds 85 tokens to every session and 959 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

apple-notes

Use this skill when the user wants to interact with Apple Notes on macOS - creating, searching, reading, updating, deleting, organizing, or formatting notes and folders. This skill provides access to Apple Notes through MCP tools and includes safe formatting guidance.

sweetrb/apple-notes-mcp · 54 tokens

Apple Notes

Open Notes.app and create or update iCloud notes on macOS using memo when possible and AppleScript when direct app automation is more reliable.

agentic-in/elephant-agent · 31 tokens

searching-apple-notes

Search, recall, and create Apple Notes via semantic vector search powered by Qwen3-Embedding-0.6B and ChromaDB. Use when the user asks to find notes, search memos, recall what they previously wrote, needs note content as context for an answer, or wants to save an insight from the current conversation into Apple Notes.…

yinanli1917-cloud/searching-apple-notes · 147 tokens

codex-break-loop

Post-bug-fix retrospective — classify root cause, identify prevention, write the lesson into specs. Use after fixing any non-trivial bug, when a task involving 'fix', 'bug', 'debug', or 'diagnose' is being finished, or when the user asks 'what went wrong', 'why did this break', 'root cause', or 'lessons learned'. Also…

yinanli1917-cloud/searching-apple-notes · 95 tokens

apple-notes

Interact with the Apple Notes app. CRUD operations for persistent storage of thoughts, data, and information across sessions.

ALucek/apple-notes · 26 tokens

Migrate

Intakes external content (notes, CLAUDE.md, Cursor rules, Obsidian/Notion/Apple Notes exports), classifies chunks against the LifeOS taxonomy, and commits with provenance after confidence-tiered approval. USE WHEN /migrate, migrate content, import from other LifeOS, bring in old notes, import Cursor rules, import…

danielmiessler/LifeOS · 104 tokens