Install

Get Ghostex on your computer and phone, and finish the first-run setup.

Your computer

Install with Homebrew:

brew install --cask ghostex

Or download the DMG (Apple silicon).

Download the installer for x64 or ARM64.

A portable zip is also on the release page. It keeps all its data in a GhostexData folder next to itself, and can run beside an installed Ghostex without sharing its sessions, settings or projects.

Your projects and agents run in PowerShell by default. To use WSL instead, change Settings > General > Terminal > Windows Environment.

Download the .deb, the .rpm, or the .tar.zst package, or the AppImage if you’d rather not install a package. ARM64 packages and the ARM64 AppImage are on the release page.

To run the AppImage, make it executable (chmod +x ghostex-*.AppImage) and open it. The first launch copies Ghostex into ~/.local/share/ghostex/appimage and runs it from there, so your agents keep running after you close the window. When an update is out, download the new AppImage and open it; it replaces that copy. If your computer has no FUSE (the AppImage then says “Cannot mount AppImage”), install your distribution’s fuse3 package (fuse on older ones), or start it with --appimage-extract-and-run (after that first start, ~/.local/share/ghostex/appimage/Ghostex runs without FUSE too).

On Arch, install from the AUR:

yay -S ghostex-bin

You also need at least one agent CLI, such as Claude Code or Codex. Ghostex can install it for you during setup.

Your phone

Android: download the app.
iPhone: the app is in TestFlight. Join the Discord to get access.

Then pair it with your computer.

First launch

The first time Ghostex opens, Welcome to Ghostex walks you through five short steps:

Agents: see which agent CLIs are on your computer and install the ones you want. This step also installs the Ghostex helper that lets Ghostex see when an agent is working or needs you.
Views: choose which views to show beside your sessions.
Phone: pair your phone and turn on notifications.
First project: pick a project folder, your default agent, and whether new sessions open as chat or terminal.
Look: light or dark, theme, and transparency.

Already know your way around? Click I already know Ghostex to skip it. You can reopen it any time from Tips & Tricks > Setup.

Updates

When a new version is out, a download button appears in the header, just before the project name. Click it to update. On Linux it opens the release notes instead, so you can install the new package the same way you installed Ghostex.