System Requirements & Prerequisites
Everything you need to know before setting up Honeycrisp for seamless macOS automation
Core Requirements
Honeycrisp seamlessly integrates large language models with your Mac, turning natural language commands into powerful desktop actions.
Compatible Clients
Application Support
Honeycrisp can automate any application that supports AppleScript. Here are examples of major apps & tools:
Built-in macOS Apps
- Music (Apple Music)
- Notes, Calendar, Reminders
- Safari, Finder, System Events
- Numbers, Pages, Keynote
Third-Party Apps
- Obsidian (if installed)
- Apps must support AppleScript
- May require accessibility permissions
Security & Permissions
macOS Security Permissions
Automatically Requested:
- • Accessibility (for GUI automation)
- • Calendar access (when using calendar tools)
- • Reminders access (when using reminder tools)
- • Contacts access (when using contact tools)
How to Grant:
- • System Settings → Privacy & Security
- • Grant permissions when prompted
- • Can be revoked anytime
- • Only requested when needed
Local First, Privacy Focused
Honeycrisp is designed to be local-first. All AppleScript execution happens on your Mac. Data is only sent to the server by the LLM when it invokes a tool to fulfill your request, ensuring you remain in control.
Common Issues & Solutions
"Permission denied" errors
Grant necessary permissions in System Settings → Privacy & Security → [specific category].
macOS will prompt for permissions automatically when first needed.
Executor won't start on port 1092
Check if another application is using port 1092: lsof -i :1092
Kill any conflicting processes or configure a different port.
AppleScript execution fails
Ensure target applications are installed and running. Some apps need to be launched at least once, but most tools already handle this for you.
Check Console.app for detailed error messages from AppleScript execution.