Start here

Install Graspable

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

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 for platform requirements.

Download

Get the installer for your system from 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.