# Install Graspable

> Install Graspable on Windows, macOS or Linux, and find your projects and settings.

Source: https://graspable.dev/docs/install

## Before you install

For web projects, Graspable includes the runtime and manages the checking browser:

- **What runs your projects** is built into the app. It installs a project's packages, builds it and runs its preview. You do not need Node.js.
- **What checks that scenes load** is a browser. On a Mac, Graspable downloads Chrome for Testing from Google once, about 190 MB, the first time the app starts, and uses your own Chrome until that is done: Chrome for Testing never updates itself, so macOS does not ask about Graspable changing an app. On Windows and Linux it uses Chrome, Edge, Chromium or Brave if you have one, and downloads Chrome for Testing only if you have none. You can start building while it downloads. On Linux, Graspable unpacks the download itself; you do not need a separate archive tool.

Both are listed in **Settings → Components**. Under **Advanced** you can choose the Node.js on your computer or your own Chromium-based browser instead.

Native projects need their engine tools, such as Unity, Unreal Engine or Xcode. See [Native XR](https://graspable.dev/docs/native-xr.md) for platform requirements.

## Download

Get the installer for your system from [graspable.dev/download](https://graspable.dev/download). Choose **Older versions** beside the system information below the installers to browse previous releases.

| System | Installer |
|---|---|
| macOS, Apple silicon | `.dmg` |
| macOS, Intel | `.dmg` |
| Windows, x64 | `.exe` installer |
| Linux, x64 | `.AppImage`, `.deb` or `.rpm` |

Every installer is published with its SHA-256 checksum and a signed checksum file. The download page shows the checksums and the public key. Choose **Copy checksum** beside an installer to copy its SHA-256 value. If your browser blocks clipboard access, a selectable checksum appears so you can copy it manually.

On a phone, use **Email yourself the link** on the download page and open the email on your Windows, Mac or Linux computer. The editor runs on your computer; published experiences can be opened on phones when their browser supports the features used. The news checkbox is optional.

## First launch

On macOS, open the `.dmg` and drag Graspable to **Applications**. The app is signed and checked by Apple, so it opens like any other app.

On Windows, open the `.exe` installer and follow its steps. On Linux, use the package installer for the `.deb` or `.rpm`, or mark the AppImage executable in its file properties and open it.

Graspable keeps sign-ins and API keys in your system's keychain. On macOS, the system may ask for your login password when the app first reads the keychain.

When the app opens you see the **Projects** page. The top right shows "connecting to agent…" for a moment while the agent starts.

## Updating

Graspable looks for a new version when it starts and every few hours while it is open. When there is one, an **Update** button appears in the bottom left corner. Click it: the app downloads the update, installs it and restarts.

The next desktop patch downloads the update while you work, then waits for code and animation edits to be saved and current work to finish before installing. If it asks you to save first, retrying uses the downloaded package. Editing is briefly locked during installation and restart.

You can also look yourself: open **Settings → Updates** and choose **Check for updates**. The app verifies each update against a signing key built into it before installing.

## Where your data lives

| What | Where |
|---|---|
| Projects | `~/Graspable/projects/<id>` — one normal folder per project. Choose another folder under **Settings → Projects folder**; the run history and backups move with it. |
| Run history | `.runs` inside the projects folder |
| Backups of projects moved to the cloud | `.cloud` inside the projects folder |
| Memory about you | `~/.graspable/memory` |
| Memory about a project | `.graspable/memory` inside the project folder |
| ChatGPT sign-in for the Graspable agent | `~/.graspable/agent` |
| Certificate for headset sharing | `~/.graspable/headset` |
| List of your cloud projects | `~/.graspable/cloud.json` |
| API keys, your Graspable account sign-in, cloud provider keys | your system's keychain |

`~` is your home folder.

## Uninstalling

Remove the app the way you remove any app on your system. This does not delete your projects or settings.

To remove everything, also delete the `~/Graspable` and `~/.graspable` folders. Deleting `~/Graspable` deletes your projects, so copy out anything you want to keep first. On macOS, the keychain item is named `vault` under `dev.graspable.desktop`; you can remove it in Keychain Access.

Claude Code and the Codex CLI keep their own sign-ins in their own places. Uninstalling Graspable does not touch them.
