Skip to content

Add timeout handling for slow Apple Notes searches #9

@vinitu

Description

@vinitu

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions