DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-screensaver

d

dsh-screensaver

Manifest valid

macOS screen saver for stepping away while AI coding agents keep working: covers the screen with a lock-screen-style cover that a touch of Touch ID dismisses (any key or click brings up the system Tou

hasBundlePatch

dsh-screensaver: a macOS screen saver that keeps AI coding agents running while you're away

You step away for coffee, a meeting or lunch. Claude Code, Codex or DeepSeek Harness is still working, and you don't want people reading your screen. dsh-screensaver covers it with a lock screen that looks like the Mac's own; touch Touch ID to unlock when you're back. While it's up the Mac doesn't sleep, the display stays on, and it can stay awake with the lid closed too. Themes can show each live Claude Code, OpenAI Codex and DeepSeek Harness session: running, waiting for your approval, finished or stopped.

It is a DeepSeek Harness (dsh) plugin, and it also runs on its own with npx.

中文说明 · llms.txt (summary for AI assistants) · Theme API · Theme skill · Visual assets license

Subspace Jump theme: Claude Code, Codex and DeepSeek Harness sessions listed during a warp jump

Every theme has an idle scene for when nothing is running and a running scene for when your agents are working, and switches between them by itself. Each clip below is 3 s of one scene, the transition, then 5 s of the other.

Agents start: idle → runningAgents finish: running → idle
Subspace Jump
subspace
Subspace Jump: three suns in normal space, then the camera locks onto a portal and jumps into the subspace tunnel while sessions are listed on the leftSubspace Jump: all sessions finish, the tunnel ends and the camera drops back to the three suns
Arcane Study
magic-tower
Arcane Study: a knight reads by moonlight in a tower study, then the camera dives into the book through a rune portal and the knight climbs the tower stairsArcane Study: all sessions finish, a book flies to the camera and opens, and the scene returns to the moonlit study
Clock
basic
Clock theme: a macOS-style lock screen with date, time, battery, Wi-Fi and "Touch ID or Enter Password"Built in: a macOS-style lock screen with no scenes.

Why not the macOS screen saver, the lock screen, or a wallpaper?

The lock screen and the system screen saver assume the Mac can rest once you leave. dsh-screensaver assumes your agents keep working and you only want the screen covered.

macOS lock screen (⌃⌘Q)macOS screen saverWallpaper / live wallpapercaffeinate / Amphetaminedsh-screensaver
Covers the screen from passers-byYes (real system lock)Yes, until a key is pressed (lock only if "require password")NoNoYes (a cover, not a security boundary)
CLI agents in a terminal (Claude Code, Codex CLI, dsh) keep runningYesYesYesYesYes
Computer-use agents and extension-driven browsers keep runningNo, they stop (openai/codex#58545, openai/codex#43869)Not testedYesYesBrowser-extension agents keep running; anything that must click the screen is covered
Covered browser windows keep full speedNo, the system treats them as hiddenNot testedn/an/aYes: the cover is a tiny bit translucent, so the system still treats windows as visible
Prevents display sleep and system idle sleepNo: the display soon goes dark, and whether the Mac then sleeps depends on other apps (anthropics/claude-code#81832)NoNoYesYes, while it is up
Stays awake with the lid closedNoNoNoNo (sleep assertions cannot stop lid sleep)Yes, on by default once you allow it (pmset disablesleep with a one-time admin authorization, auto-restored)
UnlockTouch ID or passwordKey press (+ password)n/an/aJust touch Touch ID, or press any key / click for Touch ID or the login password
Shows what your agents are doingNoNoNoNoYes (themes that opt in: names, current step, running / waiting / done / stopped)

In a café or a shared office where you need real security and only run terminal agents, use ⌃⌘Q (run /screensaver lid on first if you also want lid-closed awake). At home, or when you run computer-use or browser agents, use dsh-screensaver.

dsh-screensaver is not a security boundary: holding the power button still works, and it does not replace the macOS login. It keeps people walking by from reading your screen or typing into your agents.

Install

As a DeepSeek Harness plugin

dsh plugin --profile web add dsh-screensaver

Use desktop instead of web for the desktop app profile, then restart dsh. The first start downloads the Electron runtime (about 100 MB, once) and compiles the Touch ID helper if the Xcode Command Line Tools are installed.

All three themes, Clock, Subspace Jump and Arcane Study, ship inside this package; there is nothing else to install.

Want the latest unreleased code from GitHub instead of the npm release:

dsh plugin --profile web add github:realRoc/dsh-screensaver

Without dsh

npx dsh-screensaver --now               # cover the screen now, exit after you unlock
npx dsh-screensaver                     # stay in the background, press ⌃⌥⌘L to start
npx dsh-screensaver --now subspace      # with a theme
npx dsh-screensaver setup               # settings: lid-closed awake (and its one-time authorization), theme, idle start

Requirements: macOS 12 or later, Node.js 22 or later. Touch-to-unlock needs a Mac with Touch ID (or a Magic Keyboard with Touch ID) and the Xcode Command Line Tools (xcode-select --install); without them the system Touch ID / password dialog is used instead.

Use

  • Start: ⌃⌥⌘L (Control+Option+Command+L), /screensaver in dsh, or ask your agent ("I'm stepping away, cover the screen"); it calls the screensaver tool. You can also start it automatically after N idle minutes.
  • Unlock: touch the Touch ID sensor. Pressing any key or clicking opens the system dialog (Touch ID or login password).
  • Pure mode: after 30 seconds without input, the hint, the status bar and the session list fade out and only the animation is left. Moving the mouse, pressing a key or touching Touch ID brings them back.
CommandWhat it does
/screensaverStart with the default theme
/screensaver <theme>Start with a theme, e.g. /screensaver subspace
/screensaver <theme> <theme> …A theme per screen, main screen first, e.g. /screensaver magic-tower subspace
/screensaver themesList installed themes
/screensaver lidShow lid-closed awake status
/screensaver lid authorizeAllow lid-closed awake (asks for an admin password once; installs a sudoers rule that only allows pmset -a disablesleep 0/1)
/screensaver lid on / offTurn lid-closed awake on or off by hand
/screensaver lid revokeRemove the sudoers rule

Configuration

Add an entry to your profile's ~/.dsh/profiles/<profile>/cordis.patch.yml (it replaces the whole config block):

- id: dsh-screensaver
  config:
    theme: subspace      # default theme id
    screens: [magic-tower, subspace]   # optional: a theme per screen (see "Several screens" below)
    idleMinutes: 10      # start after 10 idle minutes; 0 = never (default)
    lidAwake: true       # keep the Mac awake with the lid closed while the screen saver is up (default; false turns it off)
    shortcut: Control+Alt+Command+L   # Electron accelerator; '' disables the shortcut

Standalone, the same fields live in ~/.dsh/plugins-data/dsh-screensaver/config.json:

CommandWhat it does
dsh-screensaver setupWalk through lid-closed awake (authorizes it on the spot), the theme, a theme per screen and idle start
dsh-screensaver configShow the settings and the file they are saved in
dsh-screensaver config <key> <value>Change one, e.g. config lidAwake off, config idleMinutes 10, config screens magic-tower,subspace
dsh-screensaver config unset <key>Back to the default
dsh-screensaver lid [status|authorize|revoke]Lid-closed awake authorization, same as /screensaver lid
dsh-screensaver themesList installed themes

DSH_SCREENSAVER_CONFIG='{"theme":"subspace"}' overrides the file for one run. A --now handed to a screen saver that is already running (for example the one inside dsh) brings its lidAwake and screens along for that start when it sets them (in the file or the variable); otherwise the running one uses its own config.

Several screens

Every screen gets the same theme unless you set screens: a list of theme ids, one per screen. The first is the main screen (the one with the menu bar), the rest go to the other screens from left to right (top to bottom when two share a column), and screens beyond the end of the list use its last entry. [magic-tower, subspace] puts Arcane Study on the main screen and Subspace Jump on every other one; [magic-tower, subspace, basic] gives a third screen the clock. A screen plugged in while the screen saver is up gets its theme the same way. Naming one theme for a single start (--now subspace, /screensaver subspace) uses it on every screen that time.

Themes

ThemeidShips withShows agent sessions
Clockbasicbuilt inNo
Subspace Jumpsubspacebuilt inYes
Arcane Studymagic-towerbuilt inYes
  • Subspace Jump: three suns orbit in normal space; while agents run, the camera jumps into a warp tunnel that drifts between a nebula storm, a vortex of ocean waves and a tunnel of Gaussian splats.
  • Arcane Study: an HD-2D pixel scene. A knight reads by moonlight in a tower study; while agents run, the camera dives into the book and the knight climbs the tower. Sessions are listed on a rune ledger, and the theme draws its own status bar (with tonight's moon phase) and Touch ID ring in the same places as the shell.

In every theme the session list is on the left, the date and time at the top right and the Touch ID hint at the bottom centre, and all of them fade out after 30 s without input, leaving only the scene.

Themes are visual works licensed CC BY-NC-SA 4.0 (no commercial use). A theme is a folder with an index.html (runs in a sandboxed iframe, draws only) and a saver.json. Put your own in ~/.dsh/plugins-data/dsh-screensaver/themes/<id>/, or publish it as an npm package with "dsh-screensaver": { "theme": "." } in its package.json. See docs/themes.md.

Make your own theme

skills/dsh-screensaver-theme is an agent skill with the rules every theme follows, whatever it looks like: an idle scene and a running scene with transitions, the session list, the status bar and clock, Touch ID feedback, hiding after 30 s, secondary displays and battery, the #demo page, packaging, and a script that records the two README GIFs. It leaves the art style entirely to you.

Copy the folder into ~/.claude/skills/ (or your project's .claude/skills/) for Claude Code, or point any coding agent at SKILL.md, then describe your idea: "make a dsh-screensaver theme where…". Read the two reference themes in themes/ for working code.

New themes, wild ideas and improvements to the skill itself are all welcome: open a PR with your theme under themes/, or an issue to pitch an idea. The skill is maintained together; if you hit a rule it doesn't cover, add it.

Which agent sessions are detected

Only themes that set "sessions": true receive sessions, and only while the screen saver is up. Everything is read from local files every 2 seconds; nothing is sent anywhere.

AgentWhere it readsRunning / waiting
Claude Code~/.claude/sessions/<pid>.json, ~/.claude/projects/**.jsonlprocess alive and status busy; waiting when status asks for permission or input
OpenAI Codex~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl, ~/.codex/session_index.jsonltask_started without task_complete / turn_aborted
DeepSeek Harness$DSH_HOME/sessions/*/*/session.v4.jsonl.zstd + session.locka dsh process holds the session lock and the last turn/start has no turn/end; waiting on an open approval/asked or ask_user_question

The theme shows each product's own icon (the Claude mark, the Codex app icon and the DeepSeek Harness whale) to label sessions. They are trademarks of their owners and are used only to identify those products.

How it works

  • A small always-on-top window covers each display; the primary one runs in kiosk mode (hides the Dock and menu bar, blocks ⌘Tab and Force Quit).
  • desk-unlock, a Swift helper (native/unlock/main.swift), embeds the system Touch ID view (LAAuthenticationView) in an invisible window above the screen saver, so touching the sensor unlocks with no dialog. With the lid closed the built-in sensor is off, so it waits for the lid to open (AppleClamshellState) and listens again right away. It also reads battery and Wi-Fi for the status bar (IOKit, CoreWLAN; no location permission, the network name is not read).
  • While up: powerSaveBlocker('prevent-display-sleep'). With lidAwake (default) and the authorization: pmset -a disablesleep 1, restored when the screen saver closes, when the process dies (a detached watchdog), at the next start if it was left on, and when the battery drops to 20%.

FAQ

Will my Claude Code / Codex / DeepSeek Harness session keep running while the screen saver is on? Yes. Terminal agents are not affected at all, the Mac does not idle-sleep, and the display does not turn off.

Does it work when I close the MacBook lid? Yes, after you allow it once: /screensaver lid authorize in dsh, or dsh-screensaver lid authorize (or setup) standalone. lidAwake is on by default, so from then on every screen saver keeps the Mac awake with the lid closed; set lidAwake: false to stop that. Keep the Mac plugged in; it turns itself off at 20% battery.

Is it a replacement for the macOS lock screen? No. It is a cover for when you step away at home or in the office and want your agents to keep working. For real security use ⌃⌘Q.

Do I need DeepSeek Harness? No. npx dsh-screensaver runs it standalone. dsh adds the /screensaver command, the agent tool and config.

Does it work on Windows or Linux? Not yet; it is macOS-only for now.

Does it send data anywhere? No. It reads local session files and system status, and it makes no network requests (apart from the one-time Electron download on first run).

Develop

git clone https://github.com/realRoc/dsh-screensaver && cd dsh-screensaver
npm install
npm test                       # vitest
npm run now                    # try it
npm run build:themes           # rebuild themes/*/index.html after editing themes/*/src
node skills/dsh-screensaver-theme/scripts/record-gif.mjs …   # record README GIFs; usage at the top of the script
DSH_SCREENSAVER_DEBUG=1 npm run now   # log page console messages

Release

Pushing a v* tag runs .github/workflows/publish.yml, which tests and publishes dsh-screensaver (themes included) to npm through Trusted Publishing (no token). A version already on npm is skipped.

  1. Bump version in package.json. Rebuild themes/subspace/index.html first if the theme source changed.
  2. Commit and push to main.
  3. Tag and push: git tag vX.Y.Z && git push origin vX.Y.Z. The tag must match the root package.json version.

License

Code is MIT (LICENSE). All visual assets, meaning every theme under themes/ and the screenshots under docs/images/, are CC BY-NC-SA 4.0: no commercial use (LICENSE-ASSETS.md). Third-party notices: themes/subspace/THIRD_PARTY_NOTICES.md, themes/magic-tower/THIRD_PARTY_NOTICES.md.

Comments

Loading…

Similar plugins

dsh-operator

by yffo

Computer Use for every DSH session: screen capture, mouse and keyboard, app launch, plan and skill replay, an audit log, guards for dangerous actions, a background code agent, and an OCR workflow (tex

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Nov 9, 2026

dsh plugin --profile web add dsh-operator

by PerryLink

Cross-platform native desktop control for DeepSeek Harness (Windows first): screen_shot, screen_read, click/type/scroll/key, app_list/app_launch - approval-gated, never stealing foreground focus

Tools & CapabilitiesManifest valid

★ 25

↓ 1.5k/wk

Apache-2.0

TypeScript

Nov 13, 2026

dsh plugin --profile web add dsh-click

by Junkrat9527

macOS desktop control for DeepSeek Harness: agent operates non-browser apps (CapCut, Photoshop, WPS, native clients) like a human — 14 tools for mouse, keyboard, scrolling, app activation, windows and

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

↓ 89/wk

MIT

JavaScript

Aug 20, 2026

dsh plugin --profile web add dsh-desktop-automation

by wangyong1972

Native macOS computer-use plugin for DeepSeek Harness with trusted mouse/keyboard control, screenshots, and multi-display selection.

Manifest valid

★ 0

MIT

TypeScript

Aug 23, 2026

dsh plugin --profile web add @wangyong1972/dsh-computer-use-macos

by ZRui-C

Text-first browser & background macOS control for DeepSeek Harness (DSH): target the right process and window without taking the user's pointer. 为 DSH 提供文本优先的电脑控制:后台操作 Chromium 与 macOS,不抢前台、不移动鼠标。

Tools & CapabilitiesManifest valid

★ 43

↓ 1.4k/wk

Apache-2.0

Swift

Oct 7, 2026

dsh plugin --profile web add dsh-computer-use

by Anionex

为 DeepSeek Harness 提供电脑控制插件:新鲜 Accessibility 观测、过期状态拒绝、作用域权限与安全输入(目前支持macos)|Accessibility-first macOS Computer Use bundle for DSH with fresh observations, stale-state rejection, scoped permissions, a

Tools & CapabilitiesManifest valid

★ 106

MIT

TypeScript

Nov 12, 2026

dsh plugin --profile web add @anionex/dsh-computer-use