Install Sisyphus
Sisyphus comes in two parts that share the same engine and the same test files:
- Sisyphus Studio, a desktop app for writing, recording, debugging and running tests. Start here if you’re new.
sis, a command-line tool for running tests from a terminal, in CI, or from an AI agent.
You can use either, or both. A test written in Studio runs unchanged with sis, and the other way round.
Sisyphus Studio (macOS)
Section titled “Sisyphus Studio (macOS)”- Open the downloaded
.dmgand drag Sisyphus to Applications. - Open it. The welcome screen offers New project… and Open project….
- Go to Settings → Web runtime and let Sisyphus install its browser runtime. It downloads once, into Sisyphus’s own folder; nothing is installed system-wide.
Studio updates itself: it checks for a new version at most once a day (a notice with Update… says when there is one), and About → Check for Updates checks now. About is the version at the bottom right, or Sisyphus → About Sisyphus in the menu bar.
The sis command
Section titled “The sis command”Put sis somewhere on your PATH, then install the browser runtime:
sis setup # the browser runtime, with Chromiumsis setup firefox webkit # other browsers, if your tests use themsis doctor # checks the runtime and permissionssis doctor prints a ✓ or ✗ for each thing Sisyphus needs, and how to fix the ✗s.
macOS permissions
Section titled “macOS permissions”Testing web apps needs no permissions. Testing desktop apps on macOS (native, Electron menus, Tauri) does, because Sisyphus reads and drives other apps the way assistive software does. macOS asks you once:
| Permission | Why | Needed for |
|---|---|---|
| Accessibility (called Device Control and Data Access on macOS 27 and later) | Read other apps’ screens and click and type in them | Any desktop app test |
| Screen Recording | Screenshots of desktop apps, for failures and the Inspector | Screenshots (tests still run without it) |
| Input Monitoring | Watch your clicks and keys while recording | The Recorder, for desktop apps |
In Studio, Settings → macOS permissions shows what’s granted, with an Allow button for each that opens the right pane of System Settings. Screen Recording takes effect after restarting Sisyphus.
For sis, macOS grants the permission to the app that runs it: your terminal (Terminal, iTerm, your editor) or, in CI, the runner. sis doctor tells you which one needs it.
Check it works
Section titled “Check it works”sis doctorEvery line should have a ✓ (the macOS permissions only matter for desktop apps). Then write your first test.
