Thanks to visit codestin.com
Credit goes to github.com

Skip to content

ygwyg/system

Repository files navigation

SYSTEM

Control your Mac from anywhere with AI.

SYSTEM is a self-hosted AI assistant that controls your Mac. Talk to it naturally—play music, manage reminders, run commands, and more.

Install

Desktop App (Recommended)

Download SYSTEM.app from releases, drag to Applications, and launch. The app guides you through setup and lives in your menu bar.

CLI

git clone https://github.com/ygwyg/system.git
cd system && npm install
npm run setup   # interactive wizard
npm start       # start everything

Features

  • Music — "Play some jazz" / "Skip this song"
  • Reminders — "Remind me to stretch in 30 minutes"
  • Calendar — "What's on my schedule today?"
  • Notes — "Add to my shopping list"
  • System — "Set volume to 50%" / "Toggle dark mode"
  • Files — "Show my recent downloads"
  • Shortcuts — Run any Apple Shortcut
  • Raycast — Use any installed extension
  • Shell — Run safe commands

Permissions

SYSTEM requires 3 macOS permissions:

Permission Why
Accessibility Keyboard/mouse control, window management
Screen Recording Screenshots for visual context
Automation Control apps (Finder, Safari, Notes, Calendar, etc.)

The desktop app guides you through granting these.

Architecture

┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
│   Your Device   │      │   Cloudflare    │      │    Your Mac     │
│                 │─────▶│   Workers       │─────▶│   (Bridge)      │
│  Chat with AI   │      │   (Agent)       │      │  Runs Commands  │
└─────────────────┘      └─────────────────┘      └─────────────────┘
  • Agent (brain): Cloudflare Worker with Claude AI, scheduling, memory
  • Bridge (body): Local server on your Mac that executes commands
  • Desktop App: Native macOS app that manages everything

Requirements

Security

  • All endpoints require authentication
  • Shell commands are allowlisted
  • Tokens generated automatically
  • Everything runs on YOUR infrastructure
  • Optional: Add Cloudflare Access for Zero Trust auth

License

MIT