Install
The first preview supports macOS 12 or later on Apple Silicon (M1 or newer).
Download
Section titled “Download”-
Open the latest release.
-
Download
Session.Bay_<version>_aarch64.dmg. You can check the download with the.sha256file next to it:Terminal window shasum -a 256 ~/Downloads/Session.Bay_*_aarch64.dmg -
Open the disk image and drag Session Bay into Applications.
Open it the first time
Section titled “Open it the first time”The preview is not notarized by Apple yet, so macOS blocks the first launch:
- Open Session Bay from Applications. macOS says it cannot verify the app. Choose Done.
- Open System Settings → Privacy & Security and scroll to Security.
- 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.
Install your agents
Section titled “Install your agents”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.
Update or uninstall
Section titled “Update or uninstall”Upgrading from 0.2.0
Section titled “Upgrading from 0.2.0”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.
Upgrading to 0.4.0
Section titled “Upgrading to 0.4.0”- 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 or remove the app
Section titled “Update or remove the app”- 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.
Linux and Windows
Section titled “Linux and Windows”They can be built from source but are not validated for release yet. See Build from source.