apple-notes

apple-notes is a skill for Claude Code, Codex from Open-Curiosity/gini-agent. It costs 17 tokens per session (599 once invoked), scanned A, original, MIT.

A command-line tool for creating, searching, editing, organizing, and exporting notes in Apple Notes, Apple's note-taking app.

In plain words
What is it for?
Viewing or searching notes, creating notes, filtering them by folder, and exporting them to Markdown or HTML on macOS.
Why use it?
It lets you manage synced notes from the terminal instead of switching to the Notes app for each task.

Skill for Claude CodeCodex

About the project

Gini Agent is a personal AI-agent runtime that manages conversations, runs, tasks, approvals, memory, skills, jobs, tools, traces, audit events, and runtime health across its clients. It is for an agent that can remember, learn from task outcomes, and operate through desktop or mobile interfaces with user controls. Catalogue add-ons extend the runtime with skills and instructions.

Open-Curiosity/gini-agent · 1,869 stars · on GitHub

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.

agentmods
npx agentmods add skills/open-curiosity/gini-agent/apple-notes
Any agent
npx skills add Open-Curiosity/gini-agent --skill apple-notes
Clone the repo
git clone --depth 1 https://github.com/Open-Curiosity/gini-agent

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 apple-notes

README.md
[![agentmods](https://agentmods.dev/badge/skills/open-curiosity/gini-agent/apple-notes.svg)](https://agentmods.dev/skills/open-curiosity/gini-agent/apple-notes)
Your own site
<a href="https://agentmods.dev/skills/open-curiosity/gini-agent/apple-notes"><img src="https://agentmods.dev/badge/skills/open-curiosity/gini-agent/apple-notes.svg" alt="Measured on agentmods" height="20"></a>
Per session 17 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 599 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00017 $0.00599
Opus 5 $0.00009 $0.00300
Sonnet 5 $0.00003 $0.00120
Haiku 4.5 $0.00002 $0.00060

Measured 5d ago against content hash 0e0d10625c2f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

apple-notes 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 5d 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.

skills/apple/apple-notes/SKILL.md · 97 lines

How it starts

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

Apple Notes

Use memo to manage Apple Notes directly from the terminal. Notes sync across all Apple devices via iCloud.

Prerequisites

  • macOS with Notes.app
  • Install: brew tap antoniorodr/memo && brew install antoniorodr/memo/memo
  • Grant Automation access to Notes.app when prompted (System Settings → Privacy → Automation)

When to Use

  • User asks to create, view, or search Apple Notes
  • Saving information to Notes.app for cross-device access
  • Organizing notes into folders
  • Exporting notes to Markdown/HTML

When NOT to Use

  • Obsidian vault management → use the obsidian skill
  • Bear Notes → separate app (not supported here)
  • Quick agent-only notes → use the memory tool instead

Quick Reference

View Notes

memo notes                        # List all notes
memo notes -f "Folder Name"       # Filter by folder
memo notes -s "query"             # Search notes (fuzzy)

Create Notes

memo notes -a                     # Interactive editor (optionally with -f "Folder Name")

memo notes -a "Note Title" is not supported by current memo versions. For a non-interactive quick note, use AppleScript instead:

osascript -e 'tell application "Notes"' \
  -e 'make new note with properties {name:"Test note", body:"Test note<br><br>Created by Gini as a test."}' \
  -e 'end tell'

Edit Notes

memo notes -e                     # Interactive selection to edit

Delete Notes

memo notes -d                     # Interactive selection to delete

Move Notes

memo notes -m                     # Move note to folder (interactive)

Export Notes

memo notes -ex                    # Export to HTML/Markdown

Limitations

  • Cannot edit notes containing images or attachments
  • Interactive prompts require terminal access (use pty=true if needed)
  • macOS only — requires Apple Notes.app

Rules

  1. Prefer Apple Notes when user wants cross-device sync (iPhone/iPad/Mac)
  2. Use the memory tool for agent-internal notes that don't need to sync
  3. Use the obsidian skill for Markdown-native knowledge management

Read the full file on GitHub · 97 lines

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. 5d ago First seen · 97 lines · 17 tokens per session scan A 0e0d10625c2f

Subscribe to this mod's changes

apple-notes is a skill published in the GitHub repository Open-Curiosity/gini-agent (1,869 stars, last pushed 1mo ago), licensed MIT. It adds 17 tokens to every session and 599 once invoked, about $0.0001 per session on Opus 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-30.

Related

Other skills, from other repositories

gno

Search local documents, files, notes, and knowledge bases. Index directories, search with BM25/vector/hybrid, get AI answers with citations. Use when user wants to search files, find documents, query notes, look up information in local folders, index a directory, set up document search, build a knowledge base, needs…

gmickel/gno · 86 tokens

vibelution-continuous-optimization-loop

Runs one evidence-driven Vibelution optimization iteration from the ROI backlog: pick one todo item, worktree isolate, implement, machine-verify, merge, update STATE. Use when the user starts /loop for project improvement, continuous optimization, or agent-dev ROI backlog work.

CCDawn/Vibelution · 65 tokens

personal-assistant

Use this skill whenever the user acts like Bamboo is their personal assistant. Triggers include stating commitments, deadlines, appointments, or recurring routines ("remind me to...", "I need to... by Friday", "every Monday I..."), asking to be reminded of something, agenda questions ("what's on my plate", "what's due…

bigduu/Bamboo-agent · 137 tokens

review

Review code changes, pull requests, patches, or a scoped code area for actionable correctness, security, compatibility, and test risks with file and line evidence. Use for review or audit requests; do not use for general proofreading, feature implementation, or debugging a reported failure when the user wants a fix.

bigduu/Bamboo-agent · 62 tokens

debug

Diagnose a concrete failure, regression, crash, hang, flaky test, or incorrect runtime behavior by reproducing it, testing hypotheses, and identifying the evidence-backed root cause. Use when symptoms or failing output exist; do not use for feature implementation without a failure, general code review, or a conceptual…

bigduu/Bamboo-agent · 64 tokens

plan

Build an executable implementation, migration, or rollout plan from read-only repository exploration, including constraints, dependencies, ordered changes, verification, risks, and rollback points. Use when the user asks for a plan or decomposition before implementation; do not use when they want a small change…

bigduu/Bamboo-agent · 68 tokens