---
title: Install
description: Get Ghostex on your computer and phone, and finish the first-run setup.
sidebar:
  order: 2
  icon: download
---

## Your computer

**macOS**

Install with Homebrew:

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

Or [download the DMG](https://ghostex.dev/download/macos-arm64) (Apple silicon).

**Windows**

Download the installer for [x64](https://ghostex.dev/download/windows-x64) or [ARM64](https://ghostex.dev/download/windows-arm64).

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

**Linux**

Download the [.deb](https://ghostex.dev/download/linux-deb-x64), the [.rpm](https://ghostex.dev/download/linux-rpm-x64), or the [.tar.zst](https://ghostex.dev/download/linux-tar-x64) package.

On Arch, install from the AUR:

```bash
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](https://ghostex.dev/android).
- **iPhone**: the app is in TestFlight. [Join the Discord](https://discord.gg/df7b3G92CS) to get access.

Then [pair it with your computer](/anywhere/phone).

## 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.

:::tip[Ask Ghostex]
Stuck during setup? Open **⋯ > Ask Ghostex** and ask, for example, "How do I install Codex?"
:::