Skip to content

Latest commit

 

History

3,545 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ghostex Ghostex

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

The native desktop app for Claude Code, Codex, OpenCode, and every other coding agent.
Chat with several agents side by side, review their work as they go, and keep steering from your phone.

Ghostex running a Claude session as a chat GUI next to the Kanban board, with local and remote projects in the sidebar

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


A real chat view for every agent

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 Claude Code session in the chat view, with the usage card open

iOS and Android apps with Easy QR Connect or Tailscale

Your agents in your pocket. Easy QR Connect pairs your phone with a single scan, no extra accounts needed, or join through your Tailscale tailnet if you already have one. The app reconnects on its own when your network changes. Read transcripts, send follow-ups, preview localhost pages, and get a push when an agent finishes.


The Ghostex mobile app on an iPhone showing a chat transcript and on a Galaxy showing projects connected through Easy QR Connect

Any agent, swap on the fly

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


Radial model picker showing Claude models and effort levels

Embedded Chromium browser

Click any element, type what should change, and the note lands in the agent's prompt. Comes with profiles, Chrome DevTools MCP, and a browser-use skill so agents can drive your tabs.


Embedded browser showing a Storybook page with an annotation popup next to a Codex session

Kanban board on Beads

Dump your thoughts on the board, then let an orchestrator agent farm the tickets out to sub-agents. Runs on the Beads bd CLI, so agents and humans share one backlog.


Kanban board backed by Beads

Docs with annotations

Open Markdown, HTML prototypes, and Excalidraw diagrams next to your agent. Select anything and leave a note; Ghostex turns your annotations into clear instructions the agent can act on.


Docs view showing an HTML page with annotations being turned into agent instructions

Rich prompt editor

Press Ctrl+G to edit any prompt in a full editor with hotkeys, image previews, and no more uneditable [Pasted 50+ lines] blocks. F1 lists every command.


Rich prompt editor opened with Ctrl+G

Built-in IDE

A VS Code editor that loads on demand for Markdown, code review, and PRs, supports all extensions, and sleeps when you are not using it.


Embedded VS Code editor inside Ghostex

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.


Session search with a query typed and matching prompts from every agent listed

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 script it all yourself.


Claude Code orchestrating Codex sessions through the Ghostex CLI

Also in the box:

  • Remote machines: install gxserver on another computer, connect with an Easy Connect code or SSH, and it shows up in the sidebar.
  • Usage and accounts: Claude and Codex limits at a glance, with automatic account switching.
  • Worktrees, splits, and spaces: create a worktree per task and merge it back, Cmd+D splits, Arc-style spaces.
  • Automations: scheduled prompts and hooks, plus menu bar and sound notifications.
  • Optional extensions: browser, Kanban, IDE, Docs, and automations load only when you use them. Or write your own.

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 (WSL2 beta)

Windows x64 installer Windows ARM64 installer

The Windows app targets WSL2 workflows: agents, gxserver, and the editor run inside your WSL2 distribution. Native Windows shells are not the intended setup yet. Updates arrive automatically from GitHub Releases.

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 /

The first GUI launch downloads the Chromium runtime into your cache directory.

Mobile

Android APK iOS TestFlight

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

Comparison

Feature Ghostex Codex 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.

About

Rust & GPUI Native Agent CLIs manager for macOS. Ghostty Terminals + Codex App Features/UX = Ghostex! Embedded browser & IDE. Tons of useful features.

Resources

Contributing

Stars

806 stars

Watchers

3 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages