How to install Shuriken on Mac, Windows and Linux

To install Shuriken, download it from shuriken.sh/download for a Mac with Apple silicon on macOS 13 or later, Windows 10 or 11, or Linux (AppImage or .deb), open it and sign in. On Windows the first open may ask once: choose More info › Run anyway. After that it updates itself.

Windows asks because the installer isn't signed with a Windows code-signing certificate yet. The Mac app is signed with our Apple Developer ID and notarised by Apple. A server that runs your agents with no screen attached is added from the app, not downloaded.

What you need#

You also need the coding agents you want to run and your own sign-ins for them. Shuriken runs the agents on your computer with your plans and keys; it never bills model usage.

Install on a Mac#

1. On the download page, download Shuriken for Mac. It runs on Apple silicon (M1 or newer); Intel Macs aren't supported.
2. Open the .dmg and drag Shuriken to Applications.
3. Open Shuriken. If macOS asks whether to open an app downloaded from the internet, choose Open.
4. Sign in.

The app is signed with our Apple Developer ID and notarised by Apple, so there's no Open Anyway step. Builds up to 5.0.0 weren't notarised; if you still have one, it updates itself to a notarised build.

Install on Windows#

1. Download the installer (.exe) or the .zip.
2. Run it. If Windows SmartScreen says it protected your PC, choose More info › Run anyway.
3. Open Shuriken and sign in.

SmartScreen warns because the app has no Windows code-signing certificate yet. What is signed are the updates: from version 5.0, Windows and Linux check each update against Shuriken's signature before installing it. Our post on Shuriken on Windows covers the rest of the Windows setup.

Install on Linux#

1. Download the AppImage (any distribution) or the .deb (Debian, Ubuntu and their relatives), x64 or Arm.
2. For the AppImage: make it executable (chmod +x Shuriken*.AppImage) and run it. For the .deb: run sudo apt install ./ followed by the file's name.
3. Open Shuriken and sign in.

If the AppImage won't start and mentions FUSE, install libfuse2 (on Ubuntu 24.04 the package is libfuse2t64), or use the .deb, which doesn't need it.

Add a server#

A server is a machine with no screen that runs your agents: a home server, a spare Mac mini, a cloud VM. You don't download anything by hand:

1. In the app, open Settings › Devices › Add device and choose a server.
2. Run the install steps it shows on the server. They work for an hour, for your account only.
3. The server appears in your devices. It runs as a service, restarts on its own, and updates itself only to signed releases, waiting until no agent is mid-turn.

The installer also sets up the agent CLIs and the GitHub sign-in. More on the server page.

After installing#

Sign in, add a project, and add the accounts or keys your agents should use. Our guide on setting up Shuriken takes it from there. On your phone, the web app at app.shuriken.sh follows every chat until the native iPhone and Android apps arrive, planned for November 2026.