TL;DR
SYSTEM is a remote Mac automation project that uses a Cloudflare-based agent and a local bridge to execute natural-language commands. It exposes a chat-style API, scheduling, and many macOS automation tools, and is installed via a GitHub repository with an interactive setup.
What happened
A project called SYSTEM provides a way to control a Mac from anywhere by sending natural-language commands to a Cloudflare-hosted agent that orchestrates a local Bridge running on the Mac. The architecture separates the Agent (running on Cloudflare Workers and DigitalOcean components) from the Bridge (an Express server on the local machine) to handle tool execution such as AppleScript, shell commands, Raycast extensions and Apple Music controls. The agent uses Claude for natural language processing and maintains persistent state, schedules, and memory. Users install from a GitHub repository, run an interactive setup (which requests an Anthropic API key and Raycast configuration), and start the system with npm start; this launches the tunnel, bridge and agent UI. Authentication for API requests requires an API secret generated during setup and stored locally in bridge.config.json. The system also supports scheduled tasks and a safety confirmation flow for messaging.
Why it matters
- Enables remote, natural-language control of macOS features and apps, potentially simplifying routine tasks.
- Split agent/bridge design keeps execution on the local machine while using a remote brain for scheduling, memory and NLP.
- Integration with Raycast extensions and Shortcuts lets users tap existing automations and third-party commands.
- Built-in scheduling and persistent state allow recurring automations and context-aware actions without manual orchestration.
Key facts
- Repository clone command: git clone https://github.com/ygwyg/system
- Install and setup: npm install, npm run setup (interactive), then npm start
- Architecture: Agent runs on Cloudflare Workers + D.O.; Bridge is a local Express server on the Mac (bridge advertised at localhost:3456)
- Agent URL example: https://your-agent.workers.dev and Bridge uses a Cloudflare Tunnel for connectivity
- NLP engine: Claude is cited for natural language processing; setup requests an Anthropic API key
- Authentication: API secret required via Authorization: Bearer <api_secret> header or ?token=<api_secret>; secret generated at setup and saved to bridge.config.json
- Chat API: POST /chat accepts natural language messages and returns actions/tools that ran (example: playing music)
- Scheduling: Supports one-time and recurring schedules with natural language or cron; GET /schedules lists tasks and DELETE /schedules/:id cancels them
- Core tools include app launching, shell execution, AppleScript, notifications, clipboard, screenshots, music controls, calendar/reminders, file search, shortcuts and Raycast extension commands
- Messaging safety: iMessage sending resolves named contacts from preferences and asks for confirmation before sending
What to watch next
- Compatibility and authentication for Raycast extensions — some commands require prior authentication in Raycast or are incompatible if they need UI interaction
- Security and key management for the API secret that grants bridge access; the secret is generated during setup and stored in bridge.config.json
- not confirmed in the source: wider production readiness, long-term support, or official release status
Quick glossary
- Cloudflare Workers: A serverless platform for running JavaScript or WebAssembly at the edge, commonly used to host APIs and lightweight services.
- Raycast: A macOS productivity tool that exposes extensions and commands to automate tasks and integrate apps.
- AppleScript: A scripting language on macOS used to automate application tasks and system interactions.
- Cloudflare Tunnel: A service that securely exposes a local server to the internet by creating an outbound connection to Cloudflare's network.
- WebSocket: A protocol providing full-duplex communication channels over a single TCP connection for real-time data exchange.
Reader FAQ
How do I install SYSTEM?
Clone the repository, run npm install, run npm run setup (interactive), then start with npm start.
Where does the agent run?
The Agent runs on Cloudflare Workers and associated D.O. components; the Bridge runs locally on your Mac.
What authentication is required?
An API secret generated during setup is required and can be provided as a Bearer token or query parameter; the secret is stored in bridge.config.json.
Can it send messages or control apps without confirmation?
For messaging there is a safety flow that resolves contacts and requests confirmation before sending; other tool behaviors depend on their type and Raycast command compatibility.
SYSTEM REMOTE MAC AUTOMATION Control your Mac from anywhere using natural language. Built with Cloudflare Agents SDK for intelligent scheduling, memory, and tool orchestration. AGENT URL https://your-agent.workers.dev BRIDGE localhost:3456 quick…
Sources
- System: Control your Mac from anywhere using natural language
- Use Apple Intelligence on your Mac
- A Deep Dive into GUI Control MCP Servers
- [Updated July 2025] Apple Intelligence Mac: Features & …
Related posts
- DDL to Data — paste SQL CREATE TABLEs to instantly generate realistic test data
- Vibe Bot: a desk-based AI agent with rotating camera and note-taking
- Prism.Tools — Free and privacy-focused developer utilities collection