Installation

macOS

Ghostex is a native Swift and Ghostty app — not Electron or Tauri. The Homebrew cask installs the correct Apple Silicon or Intel build automatically.

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

You can also download the latest DMG from GitHub Releases.

• Windows and Linux ports need contributors.
• The Ghostex CLI (`ghostex` and `gx`) is bundled with the macOS app and auto-linked on startup.
• After install, Ghostex opens the first-launch setup flow for hooks, integrations, and common defaults.

Ghostex CLI

The CLI ships inside the app bundle. On first launch Ghostex links it into your PATH so terminal and SSH sessions can call ghostex or gx without a separate install step.

ghostex --help
gx sessions
gx attach 1

Running ghostex or gx with no subcommand opens the terminal TUI. See the CLI and TUI docs for session attach, remote access, and automation commands.

Android companion

The Android app connects live to Ghostex agent sessions already running on your Mac. APKs are published in GitHub Releases.

# Latest stable APK (see Releases for current version)
https://github.com/maddada/Ghostex/releases/latest/download/ghostex-android.apk

Ghostex Android uses package id io.ghostex and can install beside upstream Termux. See the Android companion doc for Tailscale SSH, zmx persistence, and setup steps.

iOS companion

The iPhone app is distributed through TestFlight. Join the Ghostex Discord to get access.

https://discord.gg/df7b3G92CS

The iOS companion is built on the VVTerm codebase and attaches to live Ghostex sessions over SSH using the same ghostex attach contract as Android and the desktop CLI.

After install

• Complete first-launch setup: agent hooks, CLI, bundled skills, Browser Use, Computer Use, and remote access tips.
• Set session persistence to zmx (the default for new installs) so sessions survive app restarts and remote attach.
• Install agent hooks from Settings → Integrations so Ghostex can show In Progress / Needs Attention status and auto-name sessions from the first message.
• Enable macOS Remote Login if you plan to attach from Android, iOS, or another Mac over SSH.