Problem
When AppleScript searches are slow, there is no timeout guidance. Agents may wait indefinitely or need manual pkill osascript.
Desired behavior
Add timeout handling and troubleshooting guidance for slow Notes searches.
Example command behavior:
scripts/commands/search.sh --include-body --timeout 15 Cerato
If timeout is exceeded:
ERROR: Apple Notes search timed out after 15s. Try --title-only, --folder, or more specific terms.
Implementation notes
- Shell wrapper can use
timeout where available, or a portable macOS alternative using background process + sleep + kill.
- Document that full
plaintext scans across large iCloud Notes accounts may be slow.
- Suggest narrowing by folder or title.
Acceptance criteria
- Search command has a timeout or documented safe fallback.
- Timeout failure message gives next-step suggestions.
SKILL.md troubleshooting includes how to recover from stuck osascript.
Problem
When AppleScript searches are slow, there is no timeout guidance. Agents may wait indefinitely or need manual
pkill osascript.Desired behavior
Add timeout handling and troubleshooting guidance for slow Notes searches.
Example command behavior:
If timeout is exceeded:
Implementation notes
timeoutwhere available, or a portable macOS alternative using background process + sleep + kill.plaintextscans across large iCloud Notes accounts may be slow.Acceptance criteria
SKILL.mdtroubleshooting includes how to recover from stuckosascript.