Ghostex README

The project's README from github.com/maddada/Ghostex. As one markdown file: README.md.

Ghostex Ghostex

GitHub stars Latest release License
Supported platforms: macOS, Windows, Linux, Android, iOS

Join the Discord

Download Ghostex  ·  Website  ·  Watch the 3-minute tour

image

Ghostex is built for developers who keep many agents alive at once. A chat view for every agent, a native Rust/GPUI shell, embedded Chromium panes, and a mobile app share one workspace, and every session survives restarts.

Features

📱 iOS and Android apps with Easy Connect or Tailscale

Your agents in your pocket. Easy Connect pairs your phone with a single scan, no extra accounts needed, or join through your Tailscale tailnet if you already have one. 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


💬 Chat & CLI views

Talk to Claude Code, Codex, or any other agent in a proper chat GUI: clickable images, readable diffs, queued prompts, sub-agents in view, and a full editor for long messages. If you ever need the raw CLI, it is one hotkey away and your draft comes with you.

A chat showing the agent's code change as a diff


🔀 Any agent, swap on the fly

Claude Code, Codex, OpenCode, Pi, Gemini, Grok, Cursor, and more. Pick the model and effort from the chat box, or hand a session from one agent to another mid‑task.

The model picker switching between agents


📝 Annotate Markdown, HTML and diagrams

Open plans, HTML prototypes, and Excalidraw diagrams next to your agent, select anything, and leave a note or mark it Looks good, Clarify, or Needs tests. One click sends every note to the agent's prompt as numbered feedback with line numbers.

A Markdown plan in the Files view with a comment, a Clarify mark and a Needs tests mark in the Annotations list


🔎 Find any past session

Fuzzy search every prompt you ever sent, across all your agents, and press Enter to resume the conversation. Star favourites and filter by agent or project. Also available as gx f for command‑line fans.

Searching every past prompt


🤖 Agents that run agents

Agents can open sessions, send prompts, and read replies from other agents through the ghostex command. Ask Claude Code to spin up Codex sub-agents and steer them, or hand the work to an orchestrator that keeps track of them for you.

An orchestrator with its threads in the sidebar and the Threads panel


📊 Charts and tables in the chat

Ask for $ghostex-visuals and agents answer with charts, tables, and stat tiles drawn right in the chat, or publish an HTML page that opens as a card. Same look on desktop, web, and phone.

A chat reply with stat tiles, a bar chart and a table of failing tests


⏭️ Queue your next prompts

Keep typing while the agent works. Press Tab to queue a prompt and it waits above the input until the agent is free; drag to reorder, or press play on a message you already sent to interrupt and deliver it right away.

An agent at work with two queued prompts waiting above the chat input


✅ Answer your agents in one click

When an agent needs your decisions, it asks them as a form right in the chat: every question at once, choices you click, a note box for each, and one Send. It works the same on desktop, web, and your phone.

A question form in the chat with clickable choices, Recommended badges and a Send answers button

Also in the box

Supported agents

Works with any coding agent. Bring the one you already use.

Claude Code   Codex   OpenCode   Pi   oh-my-pi   Gemini CLI   Grok   Cursor   Copilot CLI   + many more

Install

macOS

brew install ghostex

Or download the app directly:

macOS Apple Silicon DMG

Windows

Windows x64 installer Windows ARM64 installer

Agents run in native PowerShell by default. Prefer Linux? Switch to WSL in Settings > General > Terminal > Windows Environment. Updates arrive automatically.

Linux

Linux DEB package Linux RPM package Arch Linux AUR package Linux tarball 

# Arch Linux
yay -S ghostex-bin

# Any other x64 distribution: the tarball is a prefix-preserving /opt/ghostex tree
sudo tar -xpf ghostex-*-linux-x64.tar.zst -C /

Ghostex offers to install Chromium the first time you open the browser or code editor.

Mobile

Android APK iOS TestFlight

The iOS TestFlight runs through the Discord. Post in the iOS channel to get in.

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

Ghostex contributors

Credits

Ghostex builds on open source work from these projects and communities:

License

Ghostex is free and open source under the MIT License.

Ghostex (maddada/Ghostex)

chromium
Searching Database…

1.3K ·GitHub
Ghostex
What is this?Ghostex is a native desktop workspace for running many coding agents (Claude Code, Codex, Gemini, Cursor, etc.) at once, with a chat view, a mobile companion app, and sessions that survive restarts.
Is this a terminal emulator or a full agent workspace?It is a full native app built with Rust and GPUI that combines a chat GUI, a raw CLI view, embedded Chromium browser panes, and a built-in VS Code-based IDE, all sharing one workspace across desktop and mobile.
Which coding agents does it work with?It works with any coding agent you already use, including Claude Code, Codex, OpenCode, Pi, oh-my-pi, Gemini CLI, Grok, Cursor, and Copilot CLI.
Is the iOS app available in the App Store?No, the iOS build is only distributed via TestFlight right now, and you have to join through Discord's iOS channel to get access.
How does the phone app connect to my agents?The mobile app pairs with a single QR-code scan via 'Easy Connect', or through your existing Tailscale tailnet, letting you read transcripts, reply, and preview localhost pages remotely.
What does 'agents that run agents' mean?Through the ghostex command, one agent can open sessions, send prompts, and read replies from other agents, so for example Claude Code can spin up and steer Codex sub-agents or hand work to an orchestrator.
Can I keep typing while an agent is working?Yes, pressing Tab queues your next prompt above the input; it waits until the agent is free, and you can drag to reorder or interrupt with an already-queued message.
How do I leave feedback on a plan or diagram?Open a Markdown plan, HTML prototype, or Excalidraw diagram next to the agent, select any part, and leave a note or mark it 'Looks good', 'Clarify', or 'Needs tests'; one click sends all notes as numbered feedback to the agent's prompt.
What extra tools load on demand?Optional plugins like a browser, Kanban board, IDE, and Docs load only when you use them, and you can write your own plugins too.
What are similar projects?vicoa, orca, golutra, shipyard, ordewell, BrowserOS, Agentlas-OS, zuse
Which topics is it in?ghostty, chromium, vscode, opencode, orchestration, agent-orchestration, mobile-app, cursor, gemini, multi-agent, coding-agent, desktop
Creator
maddada
Size
408.8 MB
Stars
1.3K
Updated
CommitOct 19Releasev10.27.0Oct 19
Age
5mo
Commits · 90 Days