ghost-os
starsforks
How to install ghost-os?
ghostwright/ghost-os
$git clone https://github.com/ghostwright/ghost-os---
README.md
| 1 | <p align="center"> |
| 2 | <img src="logo-animated.svg" width="160" alt="Ghost OS"> |
| 3 | |
| 4 | <a href="https://github.com/ghostwright/shadow"><img src="https://raw.githubusercontent.com/ghostwright/shadow/main/logo-animated.svg" width="160" alt="Shadow"></a> |
| 5 | |
| 6 | <a href="https://github.com/ghostwright/specter"><img src="https://raw.githubusercontent.com/ghostwright/specter/main/logo-animated.svg" width="160" alt="Specter"></a> |
| 7 | </p> |
| 8 | |
| 9 | <h1 align="center">Ghost OS</h1> |
| 10 | <p align="center"><em>Full computer-use for AI agents.</em></p> |
| 11 | |
| 12 | <p align="center"> |
| 13 | <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a> |
| 14 | <img src="https://img.shields.io/badge/platform-macOS%2014%2B-black.svg" alt="macOS 14+"> |
| 15 | <img src="https://img.shields.io/badge/swift-6.2-orange.svg" alt="Swift 6.2"> |
| 16 | <img src="https://img.shields.io/badge/MCP-compatible-green.svg" alt="MCP Compatible"> |
| 17 | </p> |
| 18 | |
| 19 | --- |
| 20 | |
| 21 | Your AI agent can write code, run tests, search files. But it can't click a button, send an email, or fill out a form. It lives inside a chat box. |
| 22 | |
| 23 | Ghost OS changes that. One install, and any AI agent can see and operate every app on your Mac. |
| 24 | |
| 25 | <table> |
| 26 | <tr> |
| 27 | <td width="120" align="center"> |
| 28 | <a href="https://github.com/ghostwright/specter"><img src="https://raw.githubusercontent.com/ghostwright/specter/main/logo-animated.svg" width="80" alt="Specter"></a> |
| 29 | </td> |
| 30 | <td> |
| 31 | |
| 32 | ### Meet [Specter](https://github.com/ghostwright/specter) |
| 33 | |
| 34 | Ghost OS gives AI agents eyes and hands. Shadow gives them memory. Specter gives them a home. |
| 35 | |
| 36 | Deploy persistent AI agents to dedicated VMs in 90 seconds. Automatic DNS, TLS, systemd hardening. Interactive TUI dashboard. You own the infrastructure. |
| 37 | |
| 38 | *AI agents that earn your trust.* |
| 39 | |
| 40 | </td> |
| 41 | </tr> |
| 42 | </table> |
| 43 | |
| 44 | <table> |
| 45 | <tr> |
| 46 | <td width="120" align="center"> |
| 47 | <a href="https://github.com/ghostwright/shadow"><img src="https://raw.githubusercontent.com/ghostwright/shadow/main/logo-animated.svg" width="80" alt="Shadow"></a> |
| 48 | </td> |
| 49 | <td> |
| 50 | |
| 51 | ### Meet [Shadow](https://github.com/ghostwright/shadow) |
| 52 | |
| 53 | Shadow is the other half of the story. Ghost OS gives AI agents eyes and hands on your Mac. Shadow gives them memory and intelligence. |
| 54 | |
| 55 | 14-modality capture. Proactive suggestions. Episode generation. On-device LLM inference. Computer-use training data. All local, all open source. |
| 56 | |
| 57 | *Your computer was paying attention the whole time.* |
| 58 | |
| 59 | </td> |
| 60 | </tr> |
| 61 | </table> |
| 62 | |
| 63 | --- |
| 64 | |
| 65 | ### What's New <img src="https://img.shields.io/badge/v2.2.1-March%202026-brightgreen.svg" alt="v2.2.1"> |
| 66 | |
| 67 | **Self-learning recipes.** Show Ghost OS how to do something once, and it remembers forever. |
| 68 | |
| 69 | - **`ghost_learn_start`** -- Begin watching the user perform a task |
| 70 | - **`ghost_learn_stop`** -- Stop and return the enriched action sequence |
| 71 | - **`ghost_learn_status`** -- Check recording progress |
| 72 | |
| 73 | The user performs the task manually (clicking, typing, switching apps). Ghost OS observes every action through a CGEvent tap enriched with accessibility tree context. Claude synthesizes the raw observation into a parameterized, replayable recipe. |
| 74 | |
| 75 | No screenshots needed. No vision model. Just the accessibility tree and your keyboard/mouse. |
| 76 | |
| 77 | ``` |
| 78 | User: "Watch me send an email." |
| 79 | Agent: ghost_learn_start task_description:"send email in Gmail" |
| 80 | ...user performs the task... |
| 81 | Agent: ghost_learn_stop |
| 82 | -> 8 actions with full AX context |
| 83 | -> Synthesizes recipe with 3 parameters: recipient, subject, body |
| 84 | -> ghost_recipe_save |
| 85 | User: "Send an email to bob about the Q4 report" |
| 86 | Agent: ghost_run recipe:"gmail-send-learned" params:{...} |
| 87 | ``` |
| 88 | |
| 89 | Requires Input Monitoring permission (System Settings > Privacy & Security > Input Monitoring). Run `ghost setup` to configure. |
| 90 | |
| 91 | <details> |
| 92 | <summary>Previous: v2.1.2</summary> |
| 93 | |
| 94 | 4 new tools. ghost_annotate, ghost_hover, ghost_long_press, ghost_drag. Pinned vision sidecar dependencies, fixed vision model download, Chinese/CJK input support (thanks [@junshi5218](https://githu |
People who liked this also viewed
6 picksType
- Scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!MCP ServersJul 2026
- excel-mcp-serverA Model Context Protocol server for Excel file manipulationMCP ServersApr 2026
- Excel-MCP-Server-MasterExcel MCP Server - Manipulate Excel files without Microsoft Excel. Model Context Protocol for XLSX, XLSM with Claude AI integrationMCP ServersJun 2025
- agent-deviceCLI to control iOS and Android devices for AI agentsMCP ServersJul 2026
- n8n-mcpA MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you MCP ServersJul 2026
- ha-mcpThe Unofficial and Awesome Home Assistant MCP ServerMCP ServersJul 2026
