> ## Documentation Index
> Fetch the complete documentation index at: https://developers.meshapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Mesh Code

> Install the Mesh Code desktop app on macOS, Windows, or Linux and connect your API key.

Mesh Code is a desktop app for agentic coding on Mesh API. Point it at a
project folder and it plans, writes files, runs commands, and starts dev
servers there. Every step is either approved by a permission mode you picked
or shown to you first, as a real diff or command.

Mesh Code needs no Python, Node, or Mesh CLI installed. The app carries its
own runtimes.

<Note>
  Mesh Code is in **beta**. Prefer a terminal? The [Mesh CLI](/docs/cli/install)
  runs the same agent from Terminal or PowerShell.
</Note>

## Install

Each installer downloads the current release and checks it against the
release's published `SHA256SUMS`. A mismatch stops the install. If the release
has no `SHA256SUMS`, no line for your file, or the checksum can't be computed,
the installer warns and installs without checking.

<Tabs>
  <Tab title="macOS">
    Requires an Apple Silicon Mac (M1 or later) on macOS 11 or later. There is
    no Intel build.

    1. Press **⌘ + Space**, type `Terminal`, press **Enter**.
    2. Run:

    ```bash theme={null}
    curl -fsSL https://code.meshapi.ai/install.sh | sh
    ```

    The app is installed to `/Applications` (or `~/Applications` if
    `/Applications` is not writable) and opens when the install finishes.
  </Tab>

  <Tab title="Windows">
    Requires 64-bit Windows.

    1. Click **Start**, type `PowerShell`, press **Enter**.
    2. Run:

    ```powershell theme={null}
    powershell -ExecutionPolicy ByPass -c "irm https://code.meshapi.ai/install.ps1 | iex"
    ```

    The script downloads `Mesh-Code-Setup-x64.exe` and runs it silently. Launch
    **Mesh Code** when it prints `Installed.`
  </Tab>

  <Tab title="Linux">
    Requires x86\_64. Mesh Code ships as an AppImage.

    ```bash theme={null}
    curl -fsSL https://code.meshapi.ai/install.sh | sh
    ```

    The app is installed to `~/.local/bin/mesh-code`, with a desktop entry so it
    appears in your app launcher. If `~/.local/bin` is not on your `PATH`, run
    `~/.local/bin/mesh-code` directly or add the directory to your `PATH`.

    <Warning>
      AppImages need libfuse2 to launch. On Ubuntu 24.04 and later the package is
      `libfuse2t64`:

      ```bash theme={null}
      sudo apt install libfuse2t64
      ```

      On older Ubuntu and on Debian, install `libfuse2`.

      Without it, start the app with
      `~/.local/bin/mesh-code --appimage-extract-and-run`.
    </Warning>
  </Tab>
</Tabs>

<Tip>
  Prefer to read a script before you pipe it to a shell? Both installers are
  short: [`install.sh`](https://code.meshapi.ai/install.sh) and
  [`install.ps1`](https://code.meshapi.ai/install.ps1).
</Tip>

## Direct download

Every build is also attached to
[GitHub Releases](https://github.com/aifiesta/mesh-code/releases):

| Platform | File |
| - | - |
| macOS (Apple Silicon) | `Mesh-Code-arm64.dmg` |
| Windows (x64) | `Mesh-Code-Setup-x64.exe` |
| Linux (x86\_64) | `Mesh-Code-x86_64.AppImage` |

Each release also carries a `SHA256SUMS` file. Check your download against the
line for your file before you run it:

```bash theme={null}
shasum -a 256 ~/Downloads/Mesh-Code-arm64.dmg          # macOS
sha256sum ~/Downloads/Mesh-Code-x86_64.AppImage        # Linux
```

```powershell theme={null}
(Get-FileHash $HOME\Downloads\Mesh-Code-Setup-x64.exe).Hash.ToLower()   # Windows
```

If the hashes differ, delete the file and download it again.

<Warning>
  The macOS build is not notarised yet. A `.dmg` downloaded in a browser (or
  received over AirDrop, Slack, or Messages) is quarantined, and macOS reports
  the app as *"damaged and can't be opened"*. Check the `.dmg` against
  `SHA256SUMS` as above. Only if it matches, copy the app to Applications and
  clear the flag once in Terminal:

  ```bash theme={null}
  xattr -dr com.apple.quarantine "/Applications/Mesh Code.app"
  ```

  The `curl` installer does not need this.
</Warning>

<Warning>
  The Windows installer is not code-signed yet. Run from a browser download,
  SmartScreen shows *"Windows protected your PC"*. After the checksum matches,
  click **More info**, then **Run anyway**. The PowerShell installer does not
  trigger this.
</Warning>

## First launch

1. Get an API key at [app.meshapi.ai](https://app.meshapi.ai) → **API Keys →
   Create key**. It starts with `rsk_`. See
   [Authentication](/docs/getting-started/authentication) for key types.
2. Open Mesh Code and paste the key into the **API key** field, then click
   **Connect**. The app checks the key against Mesh API before saving it.

The key is stored in `~/.mesh-code/credentials`, readable only by you (`0600`
on macOS and Linux), and is only sent to the Mesh API gateway. The app shows only a hint of it (the last
four characters).

If you already use the [Mesh CLI](/docs/cli/install) and are signed in, Mesh
Code picks up the CLI's key automatically and skips this step. It reads the
CLI's key and never changes it.

For a guided tour, click **Take the tour** in the sidebar or **Guided tour**
in the account menu. It never starts on its own.

## Upgrade

Re-run the install command for your OS. It installs the current release over
the existing app.

## Data and uninstall

Mesh Code keeps its data in `~/.mesh-code` (`%USERPROFILE%\.mesh-code` on
Windows):

* `credentials`: your API key.
* `sessions/` and `transcripts/`: saved conversations, including file contents
  and command output the agent read.
* `journal/`: the project journals.
* `context/`: per-project file maps and the agent's saved notes.

**Send feedback** in the sidebar posts your rating and comments to a Google
Form.

To uninstall:

* macOS: delete **Mesh Code** from Applications.
* Windows: **Settings › Apps › Installed apps › Mesh Code › Uninstall**.
* Linux: `rm ~/.local/bin/mesh-code ~/.local/share/applications/mesh-code.desktop`

Uninstalling leaves `~/.mesh-code` in place, API key included. Delete that
folder to remove your key and history. A key saved by the Mesh CLI stays in
`~/.meshapi`.

## Next step

Head to [Using Mesh Code](/docs/mesh-code/usage) to open a project and run your
first task.

<Note>
  Hit a snag? See [Mesh Code troubleshooting](/debug/mesh-code).
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.