Retired notice, 2026-05-17: Ghost OS has been removed from the active Projects workspace after Sam approved deletion. Active local copies were moved to rollback archive admin/rollback/ghost-os-removal-20260517-141955/. This page is historical only and should not be used as current setup guidance.
Session date: 2026-04-14
Repo cloned to: /Users/samaguiar/Documents/Projects/ghost-os
Upstream: https://github.com/ghostwright/ghost-os (Sam's fork: https://github.com/samaguiar1982-cpu/ghost-os)
Version installed: v2.2.1 (March 2026)
Platform: macOS 14+ only. Swift 6.2+.
License: MIT
Ghost OS is a local Mac app that turns any MCP-compatible AI agent (Claude Code, Cursor, VS Code, Cowork) into a real computer operator. It doesn't just read and write files — it can click buttons, type in forms, switch apps, scroll pages, press hotkeys, drag things, and open/close windows on Sam's actual Mac.
It reads the macOS accessibility tree (the structured data layer every Mac app exposes) instead of screenshotting and guessing. When the AX tree falls short — mostly on webapps like Gmail, Slack, Litify — it falls back to a local vision model (ShowUI-2B, ~3GB). Nothing leaves the Mac.
The killer feature is recipes: saved JSON workflows. A frontier model (Opus/Sonnet) figures out a task once, then a cheap model (Haiku) replays it forever. v2.2.1 adds self-learning: Sam runs ghost_learn_start, does the task manually, runs ghost_learn_stop, and Ghost OS + Claude turn the raw click/type trace into a parameterized recipe automatically.
brew tap ghostwright/ghost-os
brew install ghostwright/ghost-os/ghost-os
ghost setup
ghost setup handles:
~/.config/claude/claude_desktop_config.json or equivalent)~/.ghost-os/models/