macos-notes

macOS メモ

$SKILL_DIR/scripts/notes.sh を使って Apple Notes を管理します。メモの内容は内部的には HTML で保存されます。このスクリプトはプレーンテキストまたは HTML の本文を受け取り、読み取り時にはプレーンテキストを返します。

クイックスタート

フォルダーの一覧表示

アカウント名とフォルダー名を確認するため、必ず最初にフォルダーを一覧表示してください。

"$SKILL_DIR/scripts/notes.sh" list-folders

出力形式：account → folder（1 行に 1 件）。

メモを作成する

echo '<json>' | "$SKILL_DIR/scripts/notes.sh" create-note

JSON フィールド：

フィールド	必須	デフォルト	説明
title	はい	-	メモのタイトル（最初の行／見出しになります）
body	いいえ	""	メモの内容（プレーンテキスト。自動的に HTML に変換されます）
html	いいえ	""	HTML の本文（両方が指定された場合は body より優先されます）
folder	いいえ	default folder	フォルダー名（list-folders の出力から指定）
account	いいえ	default account	アカウント名（list-folders の出力から指定）

メモを読む

echo '<json>' | "$SKILL_DIR/scripts/notes.sh" read-note

JSON フィールド：

フィールド	必須	デフォルト	説明
name	はい	-	メモのタイトル（完全一致）
folder	いいえ	all folders	検索対象のフォルダー
account	いいえ	default account	検索対象のアカウント

メモを一覧表示する

echo '<json>' | "$SKILL_DIR/scripts/notes.sh" list-notes

JSON フィールド：

フィールド	必須	デフォルト	説明
folder	いいえ	default folder	フォルダー名
account	いいえ	default account	アカウント名
limit	いいえ	20	返すメモの最大数

メモを検索する

echo '<json>' | "$SKILL_DIR/scripts/notes.sh" search-notes

JSON フィールド：

フィールド	必須	デフォルト	説明
query	はい	-	メモのタイトルから検索するテキスト
account	いいえ	default account	検索対象のアカウント
limit	いいえ	10	返す結果の最大数

自然言語の解釈

ユーザーのリクエストをコマンドに対応付けます。

ユーザーの発言	コマンド	主なフィールド
「これをメモして：…」	create-note	title、body
「会議のメモを保存して」	create-note	title: "Meeting notes — <date>"、body
「X について何を書いた？」	search-notes	query: "X"
「メモを見せて」	list-notes	（デフォルト）
「X についてのメモを読んで」	read-note	name: "X"
「仕事のメモに保存して」	create-note	list-folders の出力から最も近い account／folder を指定

プロンプトの例

「API キーの形式をメモして：prefix_xxxx」

echo '{"title":"API key format","body":"Format: prefix_xxxx"}' | "$SKILL_DIR/scripts/notes.sh" create-note

「最近のメモを見せて」

echo '{}' | "$SKILL_DIR/scripts/notes.sh" list-notes

「パスワードについて何を書いた？」

echo '{"query":"password"}' | "$SKILL_DIR/scripts/notes.sh" search-notes

「Hinge についてのメモを読んで」

echo '{"name":"Hinge"}' | "$SKILL_DIR/scripts/notes.sh" read-note

「iCloud のメモに会議の要約を作成して」

"$SKILL_DIR/scripts/notes.sh" list-folders

続けて：

echo '{"title":"Meeting summary — 2026-02-17","body":"Discussed roadmap.\n- Q1: launch MVP\n- Q2: iterate","account":"iCloud","folder":"Notes"}' | "$SKILL_DIR/scripts/notes.sh" create-note

重要なルール

1. ユーザーがアカウント／フォルダーを指定していない場合は、必ず最初にフォルダーを一覧表示してください — フォルダー名はアカウント間で重複している場合があります
2. 特定の場所を指定する場合は、アカウントとフォルダーの両方を指定してください — folder: "Notes" だけでは場所を特定できません
3. パスワードで保護されたメモはスキップされます — スクリプトでは読み取りも変更もできません
4. JSON は標準入力で渡してください — CLI 引数として渡さないでください（プロセス一覧へのデータ漏えいを防ぎます）
5. すべてのフィールドはスクリプトによって検証されます（型変換、範囲チェック） — 無効な入力はエラーとして拒否されます
6. すべての操作は、タイムスタンプ、コマンド、メモのタイトルとともに logs/notes.log に記録されます
7. 本文にはプレーンテキストを使います — body 内の改行は自動的に <br> に変換されます。リッチな書式を使う場合は html を指定してください
8. メモのタイトルは最初の行です — Notes.app は本文の最初の行をメモの名前として扱います