Seperate
A macOS workbench for running coding agents (Claude Code, Codex) and shells side by side across projects and git worktrees, built on libghostty.
Install
- Download
Seperate-<version>.dmg from the latest release and open it.
- Double-click Install Seperate (安装 Seperate). The installer copies Seperate into Applications (replacing an older copy) and opens it.
- Builds are not notarized yet, so macOS blocks the installer the first time. Open System Settings → Privacy & Security and click Open Anyway. You only do this once. Seperate itself then opens without a warning.
Requires macOS 14 or later on Apple Silicon.
Updates
Seperate updates itself through Sparkle. You can choose how updates arrive from the Seperate menu:
| Menu item | What it does |
|---|
| 检查更新… | Checks right away and shows the update dialog. |
| 自动检查更新 | Checks once a day in the background (on by default). When a new version is found, a 新版本 x.y.z button appears in the top bar. Click it to review and install. |
| 自动下载并安装更新 | Downloads new versions in the background and installs them the next time you quit. |
Every update is verified with an EdDSA signature before it is installed.
Build from source
Requirements: Xcode 26, Rust (rustup), Apple Silicon.
scripts/setup-ghostty.sh # once: builds GhosttyKit into Vendor/ (downloads Zig)
scripts/build-app.sh debug --open
swift test
scripts/package-dmg.sh # build/Seperate-<version>.dmg (styled, with installer) and .zip
swift scripts/make-installer-assets.swift # after changing the DMG background or installer icon
Releasing
Releases are built by GitHub Actions (release.yml).
scripts/release.sh 0.2.0 # tags v0.2.0 and pushes it
gh run watch
The workflow builds the app, packages the DMG and the update zip, signs the zip with the Sparkle key, writes appcast.xml, and publishes the GitHub Release. Installed apps read the feed from releases/latest/download/appcast.xml.
One-time setup, already done for this repo: scripts/sparkle-keys.sh creates the Sparkle key pair in the login Keychain and stores the private key as the SPARKLE_PRIVATE_KEY secret. The public key is in scripts/build-app.sh.
To sign with a Developer ID and notarize the app and the DMG (removes every Gatekeeper warning), add these repository secrets (same names and values as a Tauri app's signing setup):
| Secret | Value |
|---|
APPLE_CERTIFICATE | The "Developer ID Application" certificate exported as .p12, base64-encoded |
APPLE_CERTIFICATE_PASSWORD | Password chosen when exporting the .p12 |
APPLE_ID | Apple ID email of the developer account |
APPLE_PASSWORD | App-specific password from appleid.apple.com |
APPLE_TEAM_ID | Team ID, e.g. UKPFND4844 |
With them set, the release is signed and notarized, and the DMG background drops its Gatekeeper hint.
