Skip to content

Install

The first preview supports macOS 12 or later on Apple Silicon (M1 or newer).

  1. Open the latest release.

  2. Download Session.Bay_<version>_aarch64.dmg. You can check the download with the .sha256 file next to it:

    Terminal window
    shasum -a 256 ~/Downloads/Session.Bay_*_aarch64.dmg
  3. Open the disk image and drag Session Bay into Applications.

The preview is not notarized by Apple yet, so macOS blocks the first launch:

  1. Open Session Bay from Applications. macOS says it cannot verify the app. Choose Done.
  2. Open System Settings → Privacy & Security and scroll to Security.
  3. Next to “Session Bay” was blocked, choose Open Anyway and confirm with your password or Touch ID.

You only do this once per app identity. Later versions with the same identity can be opened normally after you install them the same way.

Session Bay launches the agent CLIs you already use; it does not bundle them. Install and sign in to each agent first, following its own documentation. If an agent is missing, Session Bay still shows its existing history.

0.3.0 and later upgrade the local catalog to schema v8 for boards. 0.2.0 can no longer open that catalog after the upgrade. Agent history is unchanged.

Upgrading within 0.3.x needs no migration: install the new .dmg over the old app.

  • After the upgrade, Session Bay shows a notice that the background service is from another version. Choose Restart background service once, when no agent is doing work you need: the restart ends running agents. Later upgrades replace an idle service automatically.
  • OpenCode CLI 1.x is no longer supported. Install OpenCode 2.x, and open older OpenCode history once with 2.x so it is migrated.

If you are upgrading from 0.1.0, note that 0.2.0 changed the app identity to dev.fullstackladder.sessionbay. Session Bay’s data from 0.1.0 is not migrated; the new profile starts fresh and reads your agents’ history again. macOS requires Open Anyway and notification permission again.

  • Update: Session Bay shows a notice in the bottom-left corner when a new version is on GitHub. Choose View release, download the new version and replace the app in Applications. Running agents keep going while you update; close Session Bay first.
  • Uninstall: delete the app. Session Bay’s own data (catalog, boards, settings and layout) is in ~/Library/Application Support/dev.fullstackladder.sessionbay; delete that folder too if you want. Your agents’ history is never touched.

They can be built from source but are not validated for release yet. See Build from source.