# Why Shuriken has a Rest screen

> When you switch away from Shuriken, its Rest screen covers the app with the time and where each project stands. Your chats keep running underneath.

Source: https://shuriken.sh/blog/rest-screen

When you switch away from Shuriken, its Rest screen covers the app with the time and where each project stands. Your chats keep running underneath.

[Story](https://shuriken.sh/blog) By Shuriken Updated 18 November 2026 4 min read

**Contents**

Shuriken's Rest screen covers the app with the time and where each project stands, while every chat keeps running underneath. By default the desktop app rests by itself 7 seconds after you switch to another app or 10 seconds after your last input, and at once when your screen goes dark. We built it after catching ourselves watching agents work instead of leaving them to it.

When we started running a handful of agents at once, we spent a silly amount of time watching them. Text streams in, a test runs, a diff appears, and you sit there like it's a fireplace. It feels productive and it isn't. Agents do their part once you've written a good prompt and queued the next two; yours is to go and do something a human is better at. The hard part is actually leaving, so we gave Shuriken a screen that makes leaving easy. We call it Rest mode, or Rest for short.

## What Rest is #

Rest looks like a lock screen. The time is large in the middle, with small glances at your projects around it, enough to tell whether anything needs you and not enough to pull you back in.

What it leaves out matters as much. There's no streaming text, no scrolling log, nothing moving for the sake of moving. Going to rest, the window blurs and fades out over 280 milliseconds, then stops drawing what's underneath it (content-visibility: hidden). Since 2.2 (10 October) Rest also switches the app's animations and transitions off instead of pausing them. That is kinder to your battery as well as your attention.

## How you get there, and back #

Six things start it:

- Rest mode in the command menu (⌘K);
- View › Rest Mode;
- ⌘⇧S (Ctrl+Shift+S on Windows and Linux);
- leaving the desktop app's window in the background for 7 seconds;
- 10 seconds in the desktop app without a click, a key or a move of the mouse;
- the screen going dark, with the brightness at zero or the screen locked.

The two timed ones belong to Automatic idle screen in Settings › General, which is on by default; turn it off and Rest only starts when you ask for it or the screen goes dark.

After you ask for it, there are 5 seconds when switching windows or pressing a key won't wake it, so you can Alt-Tab away without bouncing straight back. We picked 7 seconds for the background case because a glance at another app isn't leaving. A dark screen outranks everything: Rest starts at once and stays until the screen comes back. A browser tab never rests on its own, since a browser doesn't tell a page whether its window has focus.

Coming back is a click, a key press, or switching back to the window. Moving the mouse doesn't wake it, so bumping the desk or brushing the trackpad doesn't throw you back into the chat stream.

What starts Rest, what leaves it alone, and what brings you back.

## Redrawn in 1.2 #

The first Rest worked and was a little busy. Shuriken 1.2 came out on 5 October with three changes to it:

- one centred axis, the time in the middle and the glances around it;
- a layout that fits a half-screen window and a phone held sideways;
- no reading that nobody took, because a number we never measured is better left off than shown as a confident zero.

The same release brought Import from Claude Code and Codex, so your projects came with you ([Claude Code and Codex in one project](https://shuriken.sh/blog/claude-and-codex-together)).

## Rest in 4.0, on 19 October #

4.0 gave Rest a clearer job: the time and where each project stands, so one look tells you which projects are busy and which are waiting on you, with the battery level in the top bar. It also fixed two small annoyances. A lone ⌘ or Alt key no longer wakes it (you were probably reaching for a shortcut in another app), and moving the mouse keeps the window awake while you're actually at it. 4.0's bigger news was a start screen with every project as a card.

Shuriken's Heroin mode keeps the computers you pick awake while your agents run.

[Try Shuriken](https://shuriken.sh/)

## Rest works because notifications do #

A calm screen only works if you trust it to call you back. When a chat needs you (an approval, a question, finished work), Shuriken sends a notification on your computer, so you get called in instead of checking in. How those look is in [a notification when a chat needs you](https://shuriken.sh/blog/desktop-notifications).

When you do come back, [Activity](https://shuriken.sh/features/activity) shows what ran while you were away: subagents, workflow phases, background commands, with a digest of what happened.

Activity shows what ran while you were away: subagents, workflow phases and background commands.

## And when you really leave #

Rest is about the screen. If you're leaving the computer itself, that's a different feature with a different name: Heroin mode. Yes, really. It keeps the computers you pick awake, and on a laptop it keeps running with the lid closed, where the machine allows it. Close the lid, leave it on the desk, and the agents keep working.

The name is a joke. The lid-closed part is not.

## Try it #

Start a few chats, queue the next steps, and press ⌘⇧S. Then go make a coffee. [Try Shuriken](https://shuriken.sh/) if you haven't yet.

Share

[X](https://x.com/intent/post?url=https%3A%2F%2Fshuriken.sh%2Fblog%2Frest-screen&text=Why%20Shuriken%20has%20a%20Rest%20screen)[LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fshuriken.sh%2Fblog%2Frest-screen)[Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fshuriken.sh%2Fblog%2Frest-screen&t=Why%20Shuriken%20has%20a%20Rest%20screen)[Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Fshuriken.sh%2Fblog%2Frest-screen&title=Why%20Shuriken%20has%20a%20Rest%20screen)[E-mail](mailto:?subject=Why%20Shuriken%20has%20a%20Rest%20screen&body=https%3A%2F%2Fshuriken.sh%2Fblog%2Frest-screen)

## Frequently asked questions

**Does Rest pause my agents?**

No. Rest only covers the window. Every chat, queue and background command keeps running underneath it.

**How do I start Rest myself?**

Choose Rest mode from the command menu (⌘K), use View › Rest Mode, or press ⌘⇧S (Ctrl+Shift+S on Windows and Linux). The desktop app also rests on its own when you leave it, and at once when the screen goes dark.

**How do I get out of Rest?**

Click or press a key. Moving the mouse doesn't wake it, so you can nudge the pointer without losing the calm screen.

**Does Rest keep my Mac awake?**

No. Rest is about the screen. Whether the computer stays awake is the Keep awake setting on its device page (a computer signed in to Shuriken starts on Always), and Heroin mode keeps a laptop working with the lid closed.

Heroin mode

Close the lid. Your agents keep working.

Pick which of your computers stay awake while agents work. On a Mac that holds with the lid closed, and on Windows and Linux where the laptop allows it.

[Try Shuriken](https://shuriken.sh/)

[How it works](https://shuriken.sh/features/heroin-mode)

## Keep reading

- [Shuriken's new design, and how we keep it: Update 30 Oct 2026 6 min read On 21 October we rebuilt Shuriken's design system: tokens, one toast, one icon set, calmer screens and a test that refuses one-off UI. Before and now.](https://shuriken.sh/blog/new-design-system)
- [Shuriken on Windows 10 and 11: Update 27 Oct 2026 3 min read Run Claude Code, Codex and 65 more coding agents in parallel on Windows 10 and 11. Installer or .zip, x64, with signed updates.](https://shuriken.sh/blog/shuriken-on-windows)
- [Claude Code denyInsteadOfPrompting: runs that don't stall: Story 7 Nov 2026 2 min read Claude Code 2.1.319 adds permissions.denyInsteadOfPrompting: a tool call that would wait on a permission prompt is denied and the turn carries on.](https://shuriken.sh/blog/claude-code-deny-instead-of-prompting)
- [Yes, it's called Heroin mode: Story 27 Oct 2026 3 min read Heroin mode keeps your Mac awake with the lid closed, so your coding agents keep working. Why it has that name, how it works, and the honest warnings.](https://shuriken.sh/blog/heroin-mode-yes-really)
- [Heroin mode comes to Windows and Linux: Update 11 Nov 2026 4 min read Shuriken 5.1 keeps Windows and Linux computers awake for your coding agents, lid closed included where the machine allows it. Same name, same warnings.](https://shuriken.sh/blog/heroin-mode-windows-linux)
- [Shuriken on Linux: AppImage, .deb, x64 and Arm: Update 29 Oct 2026 3 min read A desktop app for Claude Code, Codex and 65 more agents on Linux: AppImage or .deb, x64 or Arm, ChromeOS too, plus a headless server mode.](https://shuriken.sh/blog/shuriken-on-linux)
- [Keep awake only while agents work: Update 27 Oct 2026 3 min read Keep your computer awake while an agent, the queue or a workflow runs, then let it sleep. Shuriken's two settings: While working and Always.](https://shuriken.sh/blog/keep-awake-while-working)
- [Keep-awake apps for coding agents compared: Comparison 27 Oct 2026 7 min read Keep-awake apps for coding agents: caffeinate and KeepingYouAwake hold an open MacBook; pmset, Amphetamine and Heroin mode also hold a closed lid.](https://shuriken.sh/compare/amphetamine-alternatives-for-coding-agents)
- [Keep Claude Code running with the MacBook lid closed: Guide 27 Oct 2026 5 min read caffeinate doesn't survive closing a MacBook's lid. pmset disablesleep does, if you remember to undo it. The free options, the risks, and a one-switch way.](https://shuriken.sh/guides/keep-claude-code-running-lid-closed)

## Free tools

- [Claude limit reset tracker](https://shuriken.sh/tools/limit-resets/claude)
- [Codex limit reset tracker](https://shuriken.sh/tools/limit-resets/codex)
