An AI co-worker with its own computer. Self-evolving, persistent memory, MCP server, secure credential collection, email identity. Built on the Claude Agent SDK.
$git clone https://github.com/ghostwright/phantomInstalls into the current project.
Install phantom by running `git clone https://github.com/ghostwright/phantom`, then use it for the current task and follow its documentation at https://github.com/ghostwright/phantom.
| 1 | <p align="center"> |
| 2 | <img src="docs/assets/phantom.svg" alt="Phantom" width="120" height="120" /> |
| 3 | </p> |
| 4 | |
| 5 | <h1 align="center">Phantom</h1> |
| 6 | <p align="center">An AI co-worker with its own computer.</p> |
| 7 | |
| 8 | <p align="center"> |
| 9 | <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License"></a> |
| 10 | <img src="https://img.shields.io/badge/tests-1819%20passed-brightgreen.svg" alt="Tests"> |
| 11 | <a href="https://hub.docker.com/r/ghostwright/phantom"><img src="https://img.shields.io/docker/pulls/ghostwright/phantom.svg" alt="Docker Pulls"></a> |
| 12 | <img src="https://img.shields.io/badge/version-0.20.2-orange.svg" alt="Version"> |
| 13 | </p> |
| 14 | |
| 15 | <p align="center"> |
| 16 | <a href="https://ghostwright.dev/phantom">Website</a> · |
| 17 | <a href="https://ghostwright.dev/phantom">Get a Free Phantom</a> · |
| 18 | <a href="docs/">Docs</a> · |
| 19 | <a href="https://github.com/ghostwright/phantom/issues">Issues</a> |
| 20 | </p> |
| 21 | |
| 22 | --- |
| 23 | |
| 24 | ## The Idea |
| 25 | |
| 26 | AI agents today are disposable. You open a chat, get an answer, close the tab, and the context is gone. Next time you start from scratch. Every session is day one. |
| 27 | |
| 28 | Phantom takes a different approach: **give the AI its own computer.** A dedicated machine where it installs software, spins up databases, builds dashboards, remembers what you told it last week, and gets measurably better at your job every day. Your laptop stays yours. The agent's workspace is its own. |
| 29 | |
| 30 | This is not a chatbot. It is a co-worker that runs on Slack, has a web chat interface at `/chat`, has its own email address, creates its own tools, and builds infrastructure without asking for permission. Don't take our word for it - scroll down to see what production Phantoms have actually built. |
| 31 | |
| 32 | ## What This Actually Looks Like |
| 33 | |
| 34 | These are not mockups. They happened on production Phantom instances. |
| 35 | |
| 36 | ### Built an analytics platform from scratch |
| 37 | |
| 38 | A Phantom was asked to help with data analysis. It installed ClickHouse on its own VM, downloaded the full Hacker News dataset, loaded 28.7 million rows spanning 2007-2021, built an analytics dashboard with interactive charts, and created a REST API to query the data. Then it registered that API as an MCP tool so it could use it in future sessions and other agents could query it too. |
| 39 | |
| 40 | Nobody asked it to build any of this. It identified analytics as useful and built the entire stack. |
| 41 | |
| 42 | <p align="center"> |
| 43 | <img src="docs/assets/story-clickhouse.gif" alt="Phantom built a ClickHouse analytics dashboard with 28.7 million rows of Hacker News data" width="800" /> |
| 44 | </p> |
| 45 | |
| 46 | *28.7 million items. 755K unique authors. 4.3 million stories. Built, loaded, and served by a Phantom on its own machine.* |
| 47 | |
| 48 | ### Extended itself with a channel it was never built with |
| 49 | |
| 50 | Phantom ships with Slack, Telegram, Email, and Webhook channels. It does not ship with Discord. When asked "Can I talk to you on Discord?", the Phantom said: "Not right now. Discord isn't wired up. That said, I could build it." |
| 51 | |
| 52 | It explained the Discord Bot API, walked the user through creating a Discord application, provided a magic link for secure token submission, and said: "Once you save it, I'll automatically spin up the container and you'll be live on Discord." |
| 53 | |
| 54 | After submitting the token, Phantom went live on Discord. It permanently gained a communication channel it was never designed with. |
| 55 | |
| 56 | <p align="center"> |
| 57 | <img src="docs/assets/story-discord.png" alt="Phantom built Discord support for itself when asked" width="800" /> |
| 58 | </p> |
| 59 | |
| 60 | *The agent was honest about what it could not do, then built the capability on the spot.* |
| 61 | |
| 62 | ### Started monitoring its own infrastructure |
| 63 | |
| 64 | A Phantom discovered [Vigil](https://github.com/baudsmithstudios/vigil), a lightweight open-source system monitor with 3 GitHub stars. It understood what Vigil does, integrated it into its existing ClickHouse instance, built a sync pipeline that batch-transfers metrics every 30 seconds, and created a real-time monitoring dashboard showing service health, Docker container status, network I/ |