Skill UI

This runbook provides systematic procedures for diagnosing and resolving common automation failures specific to Apple Notes on macOS. It covers critical local issues like app crashes, iCloud sync failures, TCC permission revocations, and database corruption, following a comprehensive detect-diagnose-fix-verify cycle. Essential for maintaining reliable Notes automation workflows.

A comprehensive guide and set of production-tested scripts for migrating notes between popular platforms like Apple Notes, Obsidian, and Notion. It addresses key technical challenges such as proprietary HTML-to-Markdown conversion, attachment handling limitations, and utilizes JXA/Bash scripting specific to macOS environments for seamless knowledge base integration.

This utility provides a structured way to manage and separate notes across multiple accounts and environments within Apple Notes. By utilizing distinct accounts (e.g., iCloud for Production, 'On My Mac' for Development), users can ensure absolute data isolation between development, staging, and live production data. It is crucial for maintaining clean separation in complex development workflows and QA testing scenarios.

A comprehensive checklist and script guide for validating all dependencies before deploying Apple Notes automation on a production macOS machine. It covers TCC permissions, iCloud sync health, application configuration, error handling robustess, and cross-OS compatibility checks, ensuring zero missed steps when automating notes management.

A comprehensive reference architecture detailing how to automate Apple Notes on macOS. Since there is no public REST API, this system relies on a layered approach using Node.js, JXA scripting via osascript, local SQLite caching, and FSEvents polling. It outlines best practices for creating robust, local automation solutions for note management and data export.

This comprehensive guide outlines essential security best practices for developing automation scripts that interact with Apple Notes on macOS. It covers critical areas such as managing TCC permissions, preventing data leakage, securely exporting content, and handling end-to-end encrypted notes (locked notes). Use this resource when building robust, secure, and compliant applications within the Apple ecosystem.

A comprehensive guide and toolkit for optimizing Hex platform costs. This resource details strategies for reducing compute expenditure by auditing seat licenses, consolidating data connections, and optimizing notebook run schedules. It includes code examples for implementing result caching and usage monitoring to prevent unexpected billing spikes.

This guide addresses the challenges of automating Apple Notes within Continuous Integration (CI) pipelines on macOS. Because standard CI environments restrict TCC (Transparency, Consent, and Control) permissions, direct automation via osascript usually fails. It provides patterns for using mock clients for unit testing and outlines best practices for running real integration tests on self-hosted runners with proper permissions.

This comprehensive toolkit automates core workflows within Apple Notes using JXA and Bash scripting. It allows users to batch-import content from Markdown files, generate structured notes using customizable templates (e.g., meeting minutes, daily logs), and automatically organize notes into designated folder hierarchies based on naming conventions. Ideal for knowledge workers managing large volumes of notes and content from diverse sources.

This comprehensive workflow provides robust export and conversion capabilities for Apple Notes. It converts Apple Notes' internal HTML storage into multiple developer-friendly formats, including Markdown, JSON, HTML, and SQLite. Use it for reliable backups, migrating notes to other applications, or building searchable, portable note archives.

This comprehensive guide demonstrates how to programmatically interact with Apple Notes on macOS. It covers essential functions like creating new notes, listing all notes, reading specific content, searching by keywords, organizing notes into folders, and deleting entries. It primarily utilizes JXA (JavaScript for Automation) and AppleScript via the command line (osascript). Ideal for developers learning native macOS automation or integrating Notes management into larger workflows.

Provides a robust, iterative development workflow for automating Apple Notes using JXA (JavaScript for AppleScript). This setup includes file-watching hot-reloading for rapid testing and helper functions to simulate note CRUD operations, significantly speeding up the development process.