Summary

ygwyg/system provides a self-hosted AI assistant for macOS, enabling users to control their Mac from anywhere using natural language. It targets Mac power users seeking hands-free operation for tasks like managing music, reminders, system settings, and running applications, offering a convenient and integrated control layer.

How It Works

The system employs a distributed architecture: a Cloudflare Worker acts as the AI "Agent," powered by Claude AI, handling natural language processing, scheduling, and memory. This Agent communicates with a local "Bridge" server running on the user's Mac, which executes commands. A native macOS Desktop App simplifies setup, permission granting, and management, creating a seamless remote control experience. This design separates AI processing from local execution, enhancing security and responsiveness.

Quick Start & Requirements

Installation is recommended via the SYSTEM.app downloaded from releases, which guides users through setup. Alternatively, the CLI requires git clone, npm install, npm run setup (interactive wizard), and npm start. Prerequisites include macOS, an Anthropic API key, and Node.js 18+ for CLI usage. The application requires Accessibility, Screen Recording, and Automation permissions for full functionality.

Highlighted Details

• Comprehensive Control: Supports music playback, reminder/calendar management, note-taking, system adjustments (volume, dark mode), file browsing, and executing any Apple Shortcut.
• Extensibility: Integrates with Raycast, allowing access to installed extensions.
• AI Integration: Leverages Claude AI via Cloudflare Workers for intelligent command interpretation and execution.
• Security Focus: All endpoints require authentication, shell commands are allowlisted, and tokens are auto-generated. Optional Cloudflare Access can add Zero Trust security.

Maintenance & Community

No specific details regarding contributors, sponsorships, or community channels (e.g., Discord, Slack) were present in the provided README.

Licensing & Compatibility

The project is released under the MIT License, a permissive open-source license. This generally allows for broad compatibility, including use within commercial and closed-source applications without significant restrictions.

Limitations & Caveats

This project is exclusively for macOS. It requires significant user permissions (Accessibility, Screen Recording, Automation) to function, which may raise privacy concerns for some users. Functionality is dependent on an external Anthropic API key.