# Installation

Get started with Emdash

## Download Emdash

Emdash v1 is the stable release for macOS, Windows, and Linux.

### macOS

Download the build for your Mac:

- [Apple Silicon (arm64)](https://releases.emdash.sh/emdash-arm64.dmg)
- [Intel (x64)](https://releases.emdash.sh/emdash-x64.dmg)

Or install via Homebrew:

```bash
brew install --cask emdash
```

### Windows

Download the installer:

- [Installer (x64)](https://releases.emdash.sh/emdash-x64.exe)
- [MSI package (x64)](https://releases.emdash.sh/emdash-x64.msi)

### Linux

Choose your preferred format:

- [AppImage (x64)](https://releases.emdash.sh/emdash-x86_64.AppImage)
- [Debian package (x64)](https://releases.emdash.sh/emdash-amd64.deb)

## Setup

### 1. Install a coding agent

Emdash runs coding agents through their official CLIs. Install at least one agent you want to use, then open Emdash and it will detect installed agents automatically.

For Claude Code, use Anthropic's native installer:

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

See [Providers](/docs/providers) for every supported agent and install option.

### 2. Open a project

Open Emdash and add a local project, clone a GitHub repository, or connect a [remote project](/docs/remote-development/remote-projects). Create a task and choose an installed agent.

### 3. Connect GitHub if you need it

You can use Emdash locally without signing in or connecting GitHub. To use GitHub Issues, PRs, checks, or repository creation, open **Settings -> Integrations -> GitHub** and add a [GitHub account](/docs/github-accounts).

### 4. Connect integrations when needed

You do not need integrations to run local tasks. To pass issues from trackers like Linear, Jira, GitHub, Notion, or Asana to agents, go to **Settings -> Integrations** and connect the services you use.

You're ready to start using Emdash.