Skip to content
Stuck? Ask Ghostex.Learn how
Ghostex
Esc
↑↓navigate↵open⌘Jpreview
On this page

Install

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

Your computer

Install with Homebrew:

brew trust maddada/tap && brew install --cask maddada/tap/ghostex

Or download the DMG (Apple silicon).

Download the installer for x64 or ARM64.

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.

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

Then pair it with your computer.

First launch

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

  1. 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.
  2. Views: choose which views to show beside your sessions.
  3. Phone: pair your phone and turn on notifications.
  4. First project: pick a project folder, your default agent, and whether new sessions open as chat or terminal.
  5. 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.

Was this page helpful?