Get going with Shuriken.

1. Create your account.

   Free includes 2 sources and 2 linked devices. Browsers don't count as devices, and no card is needed.

2. Install the app.

   Download Shuriken for macOS, Windows or Linux and sign in with the same account.

3. Open a project.

   Pick a folder with your code and start a chat with Claude Code, Codex or another coding agent.

4. Follow it anywhere.

   Open app.shuriken.sh on your phone to see every chat and the queue live. Native iPhone and Android apps, with a push when an agent needs you, are coming to the App Store and Google Play.

Download Shuriken

1. Open app.shuriken.sh.

   Sign in once and you're signed in on the website and the web app alike. Signing out of one signs you out of both.

2. Answer one question.

   Is this your computer? Yes keeps this browser signed in. No signs it out after 2 hours without use.

3. Change it later.

   Settings › Devices shows each browser as My computer or Not my computer, and signs any device out at once.

1. Start at the top.

   One Get started row: add a computer or server, sign in a source and, on Free, see what Pro adds. Its × hides it for good.

2. Open a project.

   Up to seven rows of project cards, the most recently used first, and More for the rest. A tip sits under them.

3. Catch renewals.

   When a subscription renews within 3 days, a card says so. Acknowledge hides it until the next period.

4. See what it's worth.

   At the foot: what your subscriptions' last 30 days would cost at API prices, what they cost you, and the value of one over the other. Then your sources and devices.

1. Add your sources.

   In Settings › Sources, press Add source and pick an agent: sign in to its subscription in your browser, paste an API key, or add an endpoint. More agents installs the ones this device doesn't have yet.

2. Read the table.

   Each row shows every limit its provider has, like the 5-hour and the weekly bar. An API key shows its balance where the provider tells it, and a signed-out source has Sign in right in its row.

3. Set when to switch.

   Under the table, Switch settings decide when chats leave a source: Switch at anywhere from 50% to 100% of a window, 99% until you change it, in Rotation or Distribute mode.

4. Keep working.

   When the source in use gets there, your chats hot swap to the source with the most room. Each switch leaves a card in the chat and a row in Recent switches.

How source switching works

1. See it on Home.

   A card at the top of Home and the Dashboard says which sources have a free reset waiting, and a notification tells you when a new one arrives.

2. Check the countdown.

   View details lists each reset: what it refills (the 5-hour limit, the weekly one or both) and a live countdown to when it expires.

3. Use it in time.

   You use it in Claude's usage settings or in Codex. Shuriken also emails you once per reset; turn that off in Settings › Notifications › Email.

Is a free reset going around right now?

1. Read the device.

   Memory, CPU, free disk space, battery, keep-awake and internet of the open project's computer. Click them for its busiest processes.

2. Read your fuel.

   Next to each chat's provider, one bar shows the limit closest to running out, by its letter, with the fuel left inside, like W 92 for the week. Click it for every limit and when each resets. While your sources are being read it shows an outline, never an empty bar.

3. Choose what shows.

   In Settings › General › Top bar: All, Only when high, or Off.

4. Hear the charger.

   Pull a laptop's charger and Shuriken plays a short sound, even in the background. Turn it off in Settings › Notifications.

1. Press the mic.

   Dictate into any chat. The local model downloads by itself the first time and works offline after that.

2. Or bring your own key.

   Prefer a live speech provider? Add your own ElevenLabs, AssemblyAI, Deepgram, Speechmatics or OpenAI key in Settings › Dictation. Silence is never sent.

3. Watch the status.

   A mic in the top bar says Ready, Loading or Needs attention, with one Fix button when something is wrong. A model that stops restarts by itself.

More on voice

1. Open the menu bar icon.

   Each open project has Open chat and Start recording. On Windows and Linux, it's the tray icon.

2. Speak.

   The popover shows your words as you talk. Pause, resume or cancel as you need; press Stop, then edit the text.

3. Send or queue.

   Send starts it right away. While the agent works, Send and steer joins the turn that is running; Queue message puts it at the end of the queue.

4. From any app.

   Press ⌥⇧⌘R on a Mac, Ctrl+Alt+Shift+R on Windows, or Super+Alt+R on Linux, to dictate for your last project. Change it in Settings › General › Keyboard shortcuts.

1. Add a server.

   In Settings › Extensions › MCP servers, pick a ready-made connector, or add any server by its address or command.

2. Choose its projects.

   All projects, or just the ones that need it.

3. Sign in once.

   Approve it in your browser one time. Switching accounts never asks again.

More on global MCPs

1. Invite to a project.

   In beta: you both turn on Shared projects (beta) in Settings › Projects, then you invite someone to one project by their Shuriken email. They work in your chats on your computer, with the same access you have, so share only with people you trust fully.

1. Add a device.

   In the app, open Settings › Devices › Add device and choose A server.

2. Pick its system.

   Linux, macOS or Windows. The app gives you that system's steps, made for your account and valid for an hour.

3. It joins by itself.

   The server signs in on its own, named after the machine, and shows up in your devices.

Shuriken on a server

1. Free.

   2 sources and 2 linked devices, with no card and no end date. Browsers don't count as devices.

2. Pro.

   Unlimited sources and devices, and a few features that are still in beta inside the app. Upgrade in the app opens the order page, already signed in.

3. Founding.

   Everyone who signed up before launch gets Pro at no charge, for as long as Shuriken runs.

4. A gift.

   Were you given Pro? Nothing is ever charged. When the gift ends, your account moves to Free, unless you ordered Pro.

Compare plans

1. See it once.

   The first time one of your devices runs a new version, a pop-up shows what's new. Got it closes it on every device.

2. Read everything.

   See everything new opens the full list of changes.

Read the release posts