Ghostex

Ghostex

The native workspace for your coding agents.

Every agent in one sidebar, as chat or CLI.
Keep working from your computer or your phone.

Download · 3-minute tour · Website · Discord

macOS · Windows · Linux · iOS · Android
Free and open source · MIT

[![Ghostex with a coordinator, its threads and side panels open](media/readme/gx-hero-1.webp)](media/readme/gx-hero-1.webp) **As minimal as you want it.** ![A minimal Ghostex workspace](media/readme/gx-hero-2.jpeg) **Coordinators and pages, together.** ![A coordinator with a visual page](media/readme/gx-hero-9.webp) **Pick a design and send your choices.** ![Design options with feedback controls](media/readme/gx-hero-10.webp) **A full editor, with annotations.** ![The built-in editor](media/readme/gx-hero-6.jpeg) Want an animated wallpaper behind Ghostex like these? Try [Wallspace](https://wallspace.app/) on macOS (free, recommended), [Lively Wallpaper](https://github.com/rocksdanister/lively) on Windows (free, open source) or [Hidamari](https://github.com/jeffshee/hidamari) on Linux (free, open source; it has no gallery, so add your own videos, for example looping clips from [Pexels Videos](https://www.pexels.com/search/videos/abstract%20loop/), or paste a YouTube link: search for "4K live wallpaper loop"). Move Ghostex to its own desktop or workspace so only the wallpaper sits behind it. ## What it does ### 📱 Your agents, in your pocket Pair the iOS or Android app with one scan. Read transcripts, send follow-ups, preview localhost pages, and get a push when an agent finishes. ![Pairing the phone app, then sessions and a chat on the phone](media/readme/gx-phone.gif) ### 💬 Chat or CLI, your call A proper chat with images, readable diffs and sub-agents in view. The raw terminal is one hotkey away.
See chat and diffs ![A chat showing an agent's code change as a diff](media/readme/gx-diff.png)
### 🔀 Any agent, swap mid-task Claude Code, Codex, OpenCode, Pi, Cursor and more. Pick the model and effort from the chat box, or hand a task to another agent.
See the agent picker ![The model picker switching between agents](media/readme/gx-agent-picker.png)
### 🤖 Agents that run agents The `ghostex` command lets an agent open sessions, prompt others and read their replies. Or let a coordinator keep track of the threads. ![A coordinator and its threads](media/readme/gx-threads.png) ### 📝 Annotate, then send Mark up plans, HTML and diagrams next to your agent. One click sends every note as numbered feedback.
See annotations ![Annotations on a Markdown plan](media/readme/gx-annotate.png)
### 📊 Charts and pages in the chat Agents answer with charts, tables and stat tiles, or publish a page that opens as a card. Same on desktop, web and phone.
See a visual reply ![A chat reply with stat tiles, a chart and a table](media/readme/gx-visuals.png)
### ⏭️ Queue the next prompt Keep typing while the agent works. Press Tab to queue a prompt; drag to reorder, or play one to interrupt.
See queued prompts ![Two queued prompts above the chat input](media/readme/gx-queue.png)
### 🔎 Find any past session Fuzzy search every prompt you ever sent, across all your agents. Press Enter to resume. Also available as `gx f` in a terminal.
See prompt search ![Searching past prompts](media/readme/gx-search.png)
**Also in the box:** an on-demand VS Code editor · remote computers over Easy Connect or SSH · Claude and Codex usage with account switching · worktrees, splits and spaces · automations (scheduled prompts) with menu bar and sound notifications · optional plugins such as the Kanban board. ## Works with your agent [Claude Code](https://docs.anthropic.com/claude/docs/claude-code) · [Codex](https://github.com/openai/codex) · [OpenCode](https://opencode.ai) · [Pi](https://pi.dev) · [oh-my-pi](https://omp.sh) · [Grok](https://x.ai/cli) · [Cursor](https://cursor.com/cli) · [Copilot CLI](https://github.com/features/copilot/cli) · and more. ## Install ### On your computer **macOS:** [Apple Silicon DMG](https://maddada.com/download/macos-arm64)
Or install with Homebrew ```bash brew install ghostex ```
**Windows:** [x64 installer](https://maddada.com/download/windows-x64) · [ARM64 installer](https://maddada.com/download/windows-arm64)
PowerShell install and Windows details ```powershell irm https://ghostex.dev/install.ps1 | iex ``` The [script](tooling/install/install.ps1) downloads the installer for your PC from GitHub, checks it against GitHub's SHA-256 digest, and runs it. Agents run in native PowerShell by default. Prefer Linux? Switch to WSL in Settings → General → Terminal → Windows Environment. Updates arrive automatically.
**Linux:** [.deb](https://maddada.com/download/linux-deb-x64) · [.rpm](https://maddada.com/download/linux-rpm-x64) · [AppImage](https://maddada.com/download/linux-appimage-x64) · [AUR](https://aur.archlinux.org/packages/ghostex-bin) · [tar.zst](https://maddada.com/download/linux-tar-x64)
Arch Linux, ARM64 and other Linux details ```bash # Arch Linux yay -S ghostex-bin # Other x64 distributions: extract into /opt/ghostex sudo tar -xpf ghostex-*-linux-x64.tar.zst -C / # No package manager: the AppImage copies itself into ~/.local/share/ghostex/appimage on first start chmod +x ghostex-*-linux-x64.AppImage ./ghostex-*-linux-x64.AppImage ``` ARM64 packages are on the [release page](https://github.com/maddada/Ghostex/releases/latest). To update an AppImage, download the new one and open it. Without FUSE the AppImage says "Cannot mount AppImage": install your distribution's `fuse3` package, or start it with `--appimage-extract-and-run`. Ghostex offers to install Chromium the first time you open the browser or code editor.
### On your phone **iPhone:** [Get it on the App Store](https://apps.apple.com/app/id6771707394) **Android:** [Download the APK](https://github.com/maddada/Ghostex/releases/latest/download/ghostex-android.apk) Pair the phone app with Ghostex on your computer using Easy Connect, or use your existing Tailscale tailnet. ## How it compares
Open the feature comparison | Feature | Ghostex | ChatGPT app | cmux | | ------------------------- | ------- | ----------- | ---- | | macOS support | Yes | Yes | Yes | | Windows support | Yes | Yes | No | | Linux support | Yes | Yes | No | | Open source | Yes | - | Yes | | Ghostty terminal | Yes | - | Yes | | Chromium Browser | Yes | Yes | No | | Chat GUI view | Yes | Yes | No | | Fully featured IDE | Yes | - | - | | Built-in Computer use | Yes | Yes | - | | Built-in Browser use | Yes | Yes | Yes | | Use any model | Yes | - | Yes | | Cross Model Orchestration | Yes | - | Yes | | Rich Prompt Editor | Yes | N/A | - | | iOS | Yes | Yes | Yes | | Android | Yes | Yes | Yes | | Automations | Yes | Yes | - |
## Community [Discord](https://discord.gg/df7b3G92CS) for help and feature talk · [Issues](https://github.com/maddada/Ghostex/issues) for bugs and ideas · [Contributing](CONTRIBUTING.md) to help with ports, agents, docs and polish.
Credits: the open source Ghostex builds on Ghostex builds on open source work from these projects and communities: - [Ghostty](https://github.com/ghostty-org/ghostty) and [Zed / GPUI](https://github.com/zed-industries/zed) for the terminal and native shell - [CEF](https://github.com/chromiumembedded/cef) for embedded Chromium panes - [Trycua](https://github.com/trycua/cua) for built-in Computer Use - [VS Code](https://github.com/microsoft/vscode) and [code-server](https://github.com/coder/code-server) for the embedded IDE - [Beads](https://github.com/gastownhall/beads) by [Steve Yegge](https://github.com/steveyegge) and [Beads Viewer](https://github.com/Dicklesworthstone/beads_viewer) for the Kanban board - [OpenUsage](https://github.com/robinebers/openusage) for usage stats - [Agentation](https://github.com/benjitaylor/agentation) for browser annotation tooling, including [Ghostex's fork](https://github.com/maddada/agentation/tree/ghostex) - [cmux](https://github.com/manaflow-ai/cmux) for agent hook and notification patterns - [zehn](https://github.com/al3rez/zehn) by [al3rez](https://github.com/al3rez) for prompt-history search - [vvterm](https://github.com/vivy-company/vvterm) and [Termux](https://github.com/termux/termux-app) for mobile terminal components - [Pierre](https://github.com/pierrecomputer/pierre) for diff and file rendering components
Free and open source under the [MIT License](LICENSE).