Repository navigation
Releases
ScriptDeck v0.4.1
What's new
- Popover in the right place. On Retina screens the popover sometimes opened in the middle of the screen. It now opens under the menu bar icon.
- Faster. Opening the popover or Settings scans each project's packages about three times faster in large monorepos. Script output no longer holds up other scripts and windows, and starting or restarting a script no longer freezes the app.
- Cleaner scrollback. A long terminal history no longer starts with half an escape code like
[36m. - Dev-server links. An address printed after an invalid one is now picked up.
- Homebrew. Install with
brew install --cask svichas/tap/scriptdeck.
See the README for install notes. The macOS app is not notarized, so the first launch needs System Settings > Privacy & Security > Open Anyway.
ScriptDeck v0.4.0
What's new
- Branches and worktrees. Each project in a git repository shows the branch it's on, a dot for uncommitted changes and what's left to pull. Click it to check out another branch, make one, pull, or switch the project to another worktree. Its scripts then run in that folder while what's already running keeps running, so the same
devcan run on two branches at once, each in its own terminal. Settings lists a project's worktrees with what's running in each, makes new ones, and clones repositories. - Test results. A notification when tests pass or fail, however quick: any script with test, e2e, vitest or jest in its name or command. It's on by default; switch it off in Settings › Preferences.
- Allow notifications. While macOS blocks ScriptDeck's notifications, Preferences shows an Allow button above the switches. After an earlier Don't Allow, it opens System Settings instead.
- A tidier project page. Groups show their scripts as chips you add from a searchable menu, and run from Settings too. The toolkit says what each tool runs and does. Restart on crash is a pulse icon on a script's row, lit while it's on.
Settings › General is now Settings › Preferences.
See the README for install notes. The macOS app is not notarized, so the first launch needs System Settings > Privacy & Security > Open Anyway.
ScriptDeck v0.3.1
ScriptDec is now ScriptDeck
Same app, new name. The code moved to github.com/svichas/ScriptDeck and the website to svichas.github.io/ScriptDeck. Old GitHub links redirect. Your projects and settings carry over, and on a Mac so does Launch at login.
If you're updating from ScriptDec:
- The app keeps its old file name. Updating in place leaves it at
/Applications/ScriptDec.app, and it works fine there. To haveScriptDeck.appinstead, quit, delete ScriptDec.app and install the disk image below. If Launch at login was on, turn it off and on again afterwards. - AI agents (MCP) need adding again. The app's binary is now
scriptdeck, so a server added with ScriptDec can't start. Runclaude mcp remove scriptdec --scope user, then copy the new command from Settings > General. - On Windows, ScriptDeck installs next to ScriptDec. After updating, uninstall ScriptDec from Settings > Apps, and turn Launch at login back on in ScriptDeck if you use it.
What's new
- CPU as a share of the whole Mac. 100% now means every core is busy. Before, it was a share of one core, so a busy script could read 250%. A script's row in the menu bar window shows the figure from 10% CPU, about one busy core, instead of 30%.
Fixed: saving a project in one window could undo a change made in the other, such as a script pinned from the menu bar, or a custom script, group or setting changed in Settings.
See the README for install notes. The macOS app is not notarized, so the first launch needs System Settings > Privacy & Security > Open Anyway.
ScriptDec v0.3.0
What's new
- Script groups. Start and stop the scripts you always run together, such as web, api and a worker, with one click. Each still gets its own terminal.
- Restart on crash. Switch it on per script in Settings. A script that dies on its own comes back after 1, 2, 4, 8 and 16 s, then gives up.
- Port already in use. When a script can't start because its port is taken, its row names what holds the port, and Free port stops that and restarts yours. macOS only.
- Find in the terminal. Cmd+F (Ctrl+F on Windows) searches a terminal's whole scrollback. Cmd+click (Ctrl+click) opens a web link a script prints.
- Reopen after a restart. Turn it on in Settings > General, and the scripts still running when you quit, log out or update start again with ScriptDec.
- Run with arguments. Option-click a script's Run button, or press Shift+Enter on a search result, to add arguments such as
--watch. - Durations. Each script shows how long it has been running, or how long it took. A script that runs for 30 seconds or more posts a notification when it finishes.
- CPU and memory. Hover a script's terminal tab to see what all its processes use. macOS only.
- AI agents (MCP). Turn it on in Settings > General, and Claude Code or another agent can read and search your scripts' output and start, restart or stop them. Off by default, and macOS only.
Fixed: a script restarting while you quit could keep running after ScriptDec closed.
See the README for install notes. The macOS app is not notarized, so the first launch needs System Settings > Privacy & Security > Open Anyway.
ScriptDec v0.2.0
See the README for install notes. The macOS app is not notarized, so the first launch needs System Settings > Privacy & Security > Open Anyway.
ScriptDec v0.1.0
The first public release of ScriptDec, a menu bar app that runs your package.json scripts in the background, each in its own terminal.
What it does
- Every script, one click away: root scripts, every workspace package's scripts and your own commands, for pnpm, yarn, npm and bun.
- Leave them running: each script has its own real terminal. Type into it, restart it or stop it; quitting ScriptDec stops everything it started.
- Search everything: find any script in any project from the menu bar, or open it from any app with a global shortcut.
- Node per project: follows
.nvmrc,.node-versionor a Volta pin, or pick any version installed with nvm, fnm or Volta. - Edit
package.jsonscripts without disturbing key order, indentation or line endings. - Crash notifications, links to dev servers, pinned scripts, light and dark themes, and launch at login.
Install
macOS: download ScriptDec_0.1.0_universal.dmg (Apple silicon and Intel), open it and drag ScriptDec to Applications. The app is ad-hoc signed, not notarized, so macOS blocks the first launch: open it once, then click Open Anyway in System Settings > Privacy & Security.
Windows: run ScriptDec_0.1.0_x64-setup.exe. The installer isn't signed, so SmartScreen may warn about it: click More info, then Run anyway. ScriptDec is developed on macOS, so please report anything that behaves differently on Windows.
Found a bug? Open an issue.