メニュー
Collect Apple Notes automation debug evidence for troubleshooting. Trigger: "apple notes debug".
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill apple-notes-debug-bundleコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
Implement user sign-up and sign-in flows with Clerk. Use when building authentication UI, customizing sign-in experience, or implementing OAuth social login. Trigger with phrases like "clerk sign-in", "clerk sign-up", "clerk login flow", "clerk OAuth", "clerk social login".
Implement session management and middleware with Clerk. Use when managing user sessions, configuring route protection, or implementing token refresh and custom JWT templates. Trigger with phrases like "clerk session", "clerk middleware", "clerk route protection", "clerk token", "clerk JWT".
Configure enterprise SSO, role-based access control, and organization management. Use when implementing SSO integration, configuring role-based permissions, or setting up organization-level controls. Trigger with phrases like "clerk SSO", "clerk RBAC", "clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".
SOC 職業分類に基づく
| name | apple-notes-debug-bundle |
| description | Collect Apple Notes automation debug evidence for troubleshooting. Trigger: "apple notes debug". |
| allowed-tools | Read, Write, Edit, Bash(osascript:*), Grep |
| version | 1.6.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","macos","apple-notes","automation"] |
| compatibility | Designed for Claude Code |
This debug bundle collects diagnostic information from Apple Notes automation integrations for troubleshooting AppleScript and JXA (JavaScript for Automation) workflows. It captures macOS version compatibility, Notes.app account configuration, folder and note counts, TCC (Transparency, Consent, and Control) permission status, and Shortcuts automation entitlements. The resulting tarball helps diagnose permission denials, sandbox restrictions, iCloud sync failures, and scripting bridge errors that commonly block Notes automation.
osascript, tar available (built into macOS)#!/bin/bash
set -euo pipefail
BUNDLE="debug-apple-notes-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BUNDLE"
# Environment check
echo "=== Environment ===" > "$BUNDLE/environment.txt"
echo "macOS: $(sw_vers -productVersion 2>/dev/null || echo 'not macOS')" >> "$BUNDLE/environment.txt"
echo "Notes.app running: $(pgrep -x Notes > /dev/null && echo Yes || echo No)" >> "$BUNDLE/environment.txt"
echo "Shell: $SHELL ($TERM)" >> "$BUNDLE/environment.txt"
echo "Timestamp: $(date -u)" >> "$BUNDLE/environment.txt"
# Automation permissions (TCC database)
echo "=== TCC Permissions ===" > "$BUNDLE/tcc-status.txt"
sqlite3 ~/Library/Application\ Support/com.apple.TCC/TCC.db \
"SELECT client, auth_value, auth_reason FROM access WHERE service='kTCCServiceAppleEvents'" \
>> "$BUNDLE/tcc-status.txt" 2>/dev/null || echo "Cannot read TCC database (SIP may block)" >> "$BUNDLE/tcc-status.txt"
# Account enumeration via JXA
echo "=== Accounts ===" > "$BUNDLE/accounts.txt"
osascript -l JavaScript -e '
const app = Application("Notes");
const accts = app.accounts();
accts.forEach(a => {
const notes = a.notes().length;
const folders = a.folders().length;
ObjC.import("stdlib"); // ensure stdio
$.system(`echo "${a.name()}: ${notes} notes, ${folders} folders" >> /dev/stdout`);
});
' >> "$BUNDLE/accounts.txt" 2>&1 || echo "JXA account query failed" >> "$BUNDLE/accounts.txt"
# Note count and folder structure
echo "=== Folder Structure ===" > "$BUNDLE/folders.txt"
osascript -l JavaScript -e '
const app = Application("Notes");
app.defaultAccount.folders().forEach(f => {
$.system(`echo " ${f.name()}: ${f.notes().length} notes" >> /dev/stdout`);
});
' >> "$BUNDLE/folders.txt" 2>&1 || echo "Folder query failed" >> "$BUNDLE/folders.txt"
# Shortcuts integration check
echo "=== Shortcuts ===" > "$BUNDLE/shortcuts.txt"
shortcuts list 2>/dev/null | grep -i note >> "$BUNDLE/shortcuts.txt" || echo "No note-related Shortcuts found" >> "$BUNDLE/shortcuts.txt"
# iCloud sync status
echo "=== iCloud Sync ===" > "$BUNDLE/icloud-sync.txt"
brctl status com.apple.Notes 2>/dev/null >> "$BUNDLE/icloud-sync.txt" || echo "brctl not available or Notes not using iCloud Drive" >> "$BUNDLE/icloud-sync.txt"
ls -la ~/Library/Group\ Containers/group.com.apple.notes/ >> "$BUNDLE/icloud-sync.txt" 2>/dev/null || echo "Notes container not found" >> "$BUNDLE/icloud-sync.txt"
# Recent console errors
echo "=== Recent Errors ===" > "$BUNDLE/console-errors.txt"
log show --predicate 'subsystem == "com.apple.notes"' --last 30m --style compact 2>/dev/null \
| tail -50 >> "$BUNDLE/console-errors.txt" || echo "Cannot read system log" >> "$BUNDLE/console-errors.txt"
tar -czf "$BUNDLE.tar.gz" "$BUNDLE" && rm -rf "$BUNDLE"
echo "Bundle: $BUNDLE.tar.gz"
tar -xzf debug-apple-notes-*.tar.gz
cat debug-apple-notes-*/environment.txt # Confirm macOS version
cat debug-apple-notes-*/tcc-status.txt # Check automation permissions
cat debug-apple-notes-*/accounts.txt # Verify note counts per account
cat debug-apple-notes-*/console-errors.txt # Look for sandbox or sync errors
| Symptom | Check in Bundle | Fix |
|---|---|---|
-1743 error (not permitted) | tcc-status.txt shows no entry for Terminal | Grant Automation permission: System Settings > Privacy > Automation > Terminal > Notes |
| JXA returns empty arrays | accounts.txt shows 0 notes | Notes.app must be open at least once; launch Notes and wait for iCloud sync |
execution error: Notes got an error: AppleEvent timed out | console-errors.txt shows timeout | Notes.app is busy syncing; wait for iCloud sync to finish, then retry |
| Folder query fails on shared accounts | folders.txt shows error on non-default account | Specify account explicitly: app.accounts.byName("iCloud") |
| Shortcuts integration returns empty | shortcuts.txt shows no matches | Create a Notes shortcut manually in Shortcuts.app, then re-run |
brctl reports conflict | icloud-sync.txt shows conflict state | Open Notes.app, resolve duplicate notes, then force sync via iCloud preferences |
import { execSync } from "child_process";
function checkAppleNotesHealth(): {
status: string;
macosVersion: string;
notesRunning: boolean;
accountCount: number;
tccGranted: boolean;
} {
const macosVersion = execSync("sw_vers -productVersion").toString().trim();
const notesRunning = execSync("pgrep -x Notes || true").toString().trim() !== "";
let accountCount = 0;
try {
const raw = execSync(
'osascript -l JavaScript -e \'Application("Notes").accounts().length\''
).toString().trim();
accountCount = parseInt(raw, 10);
} catch { /* Notes not accessible */ }
const tccGranted = accountCount > 0;
return {
status: tccGranted && notesRunning ? "healthy" : "degraded",
macosVersion,
notesRunning,
accountCount,
tccGranted,
};
}
See apple-notes-rate-limits.