hermes-agent/website/docs/user-guide/skills/bundled/apple/apple-apple-notes.md
treatux 2a1ec15a6f docs(website): regenerate the skill docs from the shipped skill tree
website/scripts/generate-skill-docs.py is the documented source of both catalogs
and of the per-skill pages, but nothing compares its output with what is
committed, so the committed copies drifted:

- optional-skills-catalog.md was missing agent-merge-conflict-arbiter and listed
  pr-lens under blockchain (it lives in software-development);
- skills-catalog.md still listed merge-reconciler, which #98539 moved out of the
  bundled set;
- 196 pages and both catalogs carried Windows path separators — in the Path
  column and inside GitHub blob links, where a backslash is a broken URL.

This commit is the generator's output (re-running it on this branch is a no-op),
plus the orphan page #98539 left behind for merge-reconciler: no skill backs it,
its catalog row is gone, and no page links to it.

tests/skills/test_skill_docs_contract.py is the guard: the next skill that ships
without a catalog row, or a page regenerated on Windows, fails there instead of
on the published page.
2026-09-20 12:54:07 -07:00

3 KiB

title sidebar_label description
Apple Notes — Manage Apple Notes via memo CLI: create, search, edit Apple Notes Manage Apple Notes via memo CLI: create, search, edit

{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Apple Notes

Manage Apple Notes via memo CLI: create, search, edit.

Skill metadata

Source Bundled (installed by default)
Path skills/apple/apple-notes
Version 1.0.1
Author Hermes Agent
License MIT
Platforms macos
Tags Notes, Apple, macOS, note-taking
Related skills obsidian

Reference: full SKILL.md

:::info The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. :::

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                     # Add a note (opens your $EDITOR)
memo notes -a -f "Folder Name"    # Add a note into a specific folder

-a/--add is a bare flag — it opens your $EDITOR to compose the note; it does not take a title argument. Use -f/--folder to target a folder. Set $EDITOR first (e.g. export EDITOR=vim).

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