OpenParable
Skip to content
← Back to skills

Apple Notes

Apps & Automation

Apple Notes is an Agent Skill for apps & automation published in the agentic-in/elephant-agent repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/agentic-in/elephant-agent/blob/HEAD/packages/skills/builtin_packages/apple/apple-notes/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/apple-notes-524521c1, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Apple Notes

Use this skill when the user wants work to land in Apple Notes rather than in agent memory or a markdown file.

Preferred Flow

  1. If the user only wants Notes.app opened, use open -a Notes.
  2. If the task needs a note created or updated, probe the memo CLI first with memo notes --help.
  3. If memo is missing and Notes automation is clearly the shortest path, install it with: brew tap antoniorodr/memo && brew install antoniorodr/memo/memo
  4. Use memo notes -a "Title" when a non-interactive add path is available.
  5. If memo falls into an editor or another interactive flow, fall back to osascript and create the note directly inside Notes.app.

AppleScript Fallback

  • Default to the iCloud account and the Notes folder unless the user names a different folder.
  • Keep the note title and body in shell variables, then pass them into a quoted heredoc so multiline text survives intact.
  • After creating the note, activate Notes.app so the user can immediately see the result.

Guardrails

  • Prefer Apple Notes only when the user wants Apple-device sync or explicitly asks for Notes.app.
  • Use the memory tool for agent-internal facts that should not become user-facing notes.
  • Preserve markdown/plain text exactly as supplied; do not rewrite punctuation or list formatting while shell-escaping.
  • If note creation fails through both memo and AppleScript, report the concrete error and stop instead of pretending the note exists.