Skip to content

v3.2.3 — macOS Portable (Apple Silicon)

Choose a tag to compare

View all tags
@mdoty4 mdoty4 released this 01 Jul 05:04
v3.2.3
a956aec

BatonBot v3.2.3 — Portable (macOS Apple Silicon)

Download. Unzip. Double-click. No git, no npm, no Node required.

v3.2.3 brings the portable-bundle story from v3.2.2 to macOS. If you're on
an Apple Silicon Mac (M1 / M2 / M3 / M4), you can now run BatonBot with
zero prerequisites — the ZIP includes a pinned Node 20 LTS arm64 binary
and a double-clickable start.command launcher.

🚀 Quick start (macOS Apple Silicon)

  1. Download batonbot-portable-mac-arm64.zip below.
  2. Double-click the ZIP to extract it (Finder does this automatically).
  3. First launch only: right-click (or Control-click) start.command
    inside the extracted folder → Open → click Open in the
    confirmation dialog. macOS remembers your choice from then on.
  4. Your default browser opens to http://localhost:4321.

That's it. Your settings, projects, and logs live in the config/ folder
next to start.command — delete the folder to uninstall cleanly.

✅ What works in this build

  • Full BatonBot UI on macOS 12+ (Apple Silicon)
  • All bundled agents: Baton Code, Baton Code (Thinking), Aider, Cline, Telegram
  • Anthropic, OpenAI-compatible, and LM Studio providers
  • No Node, npm, or git required on the host machine

🐛 Bug fixes / changes in v3.2.3

  • v3.2.3 — New: macOS Apple Silicon (arm64) portable bundle with
    start.command launcher.
  • v3.2.3 — Refactored scripts/build-portable/ — extracted shared
    logic into common.js so build-win.js and build-mac.js stay in sync.
  • v3.2.3 — README rewritten install-first: Portable is now listed as
    Option A, ahead of the git-clone flow.

Windows users: the v3.2.2 Windows portable bundle is unchanged and continues
to ship in this release.

🔐 Verify your download (optional but recommended)

A SHA256 checksum is published alongside each ZIP. To verify on macOS:

shasum -a 256 batonbot-portable-mac-arm64.zip

The output should match the value in
batonbot-portable-mac-arm64.zip.sha256.

⚠️ Known issues / caveats

  • Gatekeeper "unidentified developer" warning on first launch is
    expected. This bundle is not Apple-notarized yet. The right-click →
    Open workaround above is the standard Mac approach; macOS remembers your
    choice after the first run. Alternatively, run
    xattr -dr com.apple.quarantine . inside the unzipped folder once.
  • Intel Macs (x86_64): not in this release. Planned for a future
    update. Intel-Mac developers should use the git clone + npm install
    flow from the README until then.
  • Linux portable bundle: not in this release. Planned for a future
    update. Linux developers should use the git clone + npm install flow.
  • Code signing: not yet. Signing/notarization is on the roadmap.

👩‍💻 Developers

The dev workflow is unchanged. git clone + npm install + npm run dev
continues to work as before. To build the portable bundles yourself:

# Windows x64 (bundled node.exe + start.cmd)
npm run build:portable:win

# macOS Apple Silicon (bundled node arm64 + start.command)
npm run build:portable:mac

Bundles land in dist/batonbot-portable-win-x64.zip and
dist/batonbot-portable-mac-arm64.zip.

Full changelog

See ROADMAP.md item v3.2 — Portable for the full plan. Items still
open: Intel Mac portable, Linux portable, 30-second install GIF, launch
announcement post.

Assets 6
Loading