Skip to content

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.

  1. Open the downloaded .dmg and drag Sisyphus to Applications.
  2. Open it. The welcome screen offers New project… and Open project….
  3. 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.

Put sis somewhere on your PATH, then install the browser runtime:

Terminal window
sis setup # the browser runtime, with Chromium
sis setup firefox webkit # other browsers, if your tests use them
sis doctor # checks the runtime and permissions

sis doctor prints a ✓ or ✗ for each thing Sisyphus needs, and how to fix the ✗s.

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.

Terminal window
sis doctor

Every line should have a ✓ (the macOS permissions only matter for desktop apps). Then write your first test.

Made by Bussin Bytes© 2026 Bussin Bytes Ltd · sisyphus.bussinbytes.io