Agent Switch v0.2.3

Agent Switch 0.2.3

Fixed

• Apps launched from the Dock, Finder or Start menu no longer report the
  Codex/Claude CLIs as not installed: when the shell-less process PATH
  misses a CLI, the app now probes well-known install locations (Homebrew,
  npm/bun/volta globals, nvm/fnm/asdf/mise node trees, scoop, nvm-windows)
  and, on macOS/Linux, the user's login-shell PATH.
• The version probe adds the CLI's own directory to the child PATH so the
  #!/usr/bin/env node shebang resolves even in a minimal GUI environment.
• Ship the installer fixes committed after the v0.2.2 tag (release-metadata
  JSON parsing, Windows asset enumeration) — the published v0.2.2
  installers predate them.

Installation / 安装

Open the DMG and drag Agent Switch to Applications, or extract the CLI ZIP and place agent-switch on PATH. Codex CLI / Claude Code must be installed separately.

The app is ad-hoc signed and not notarized by Apple. Check SHA256SUMS.txt before opening it. If macOS blocks an app you trust, use System Settings → Privacy & Security → Open Anyway.

打开 DMG，将 Agent Switch 拖入“应用程序”；CLI 用户解压 ZIP 并将 agent-switch 放入 PATH。Codex CLI / Claude Code 需单独安装。应用采用 ad-hoc 签名、未公证，请先核对校验和；确认信任来源后，可在“隐私与安全性”中选择“仍要打开”。

These packages are for Apple Silicon; the Windows packages (NSIS, MSI and CLI ZIP) are added to this same release. Intel and Linux users can build from source.

Agent Switch v0.2.5

Agent Switch 0.2.5

Fixed

• Windows: the per-session start script is now written with a UTF-8 BOM, so
  workspace paths containing non-ASCII characters (e.g. Chinese) no longer
  come out garbled and break Set-Location when launching from the GUI.

Performance

• Status checks are faster: the Codex/Claude version probes run in parallel
  and the cache lock is released while they run.
• Launches no longer wait on the network: the Codex model-list sync now runs
  in the background.
• The Sessions page refresh is faster: transcript heads are streamed and stop
  reading as soon as the working directory and first message are known, and
  pools with many sessions parse in parallel.

Packages

• Windows x64: Agent.Switch_0.2.5_x64-setup.exe (NSIS), Agent.Switch.Setup.0.2.5.x64.msi, agent-switch-0.2.5-x86_64-pc-windows-msvc.zip (CLI)
• macOS (Apple Silicon): Agent.Switch_0.2.5_aarch64.dmg, agent-switch-0.2.5-aarch64-apple-darwin.zip (CLI)
• Linux x64: agent-switch-0.2.5-x86_64-unknown-linux-gnu.zip (CLI)

Installation / 安装

macOS: open the DMG and drag Agent Switch to Applications. Windows: run the NSIS installer (or the MSI). CLI: irm .../install.ps1 | iex (Windows) or curl .../install.sh | sh (macOS/Linux), or extract the CLI ZIP and put agent-switch on PATH. Codex CLI / Claude Code must be installed separately.

macOS: 打开 DMG，将 Agent Switch 拖入"应用程序"。Windows: 运行 NSIS 安装程序（或 MSI）。CLI: Windows 用 irm .../install.ps1 | iex，macOS/Linux 用 curl .../install.sh | sh，或解压 CLI ZIP 并将 agent-switch 放入 PATH。Codex CLI / Claude Code 需单独安装。

The macOS app is ad-hoc signed and not notarized by Apple; the Windows installer is not code-signed. Verify against SHA256SUMS.txt before opening. If macOS blocks an app you trust, use System Settings > Privacy & Security > Open Anyway.

macOS 应用为 ad-hoc 签名、未由 Apple 公证；Windows 安装程序未做代码签名。打开前请先核对 SHA256SUMS.txt。确认信任来源后，可在"隐私与安全性"中选择"仍要打开"。

Intel Mac and Linux ARM64 have no prebuilt packages yet; build from source.
Intel Mac 与 Linux ARM64 暂无预编译包，请从源码构建。

Agent Switch v0.2.4

Agent Switch 0.2.4

Added

• Built-in update system, on every end:
  • GUI: checks the official GitHub releases on launch (cached,
    non-blocking) and offers a confirmation dialog when a new version
    is available; confirming shows a download progress bar, verifies
    the package's SHA-256 against the release's SHA256SUMS.txt,
    replaces the old version and relaunches automatically (macOS
    swaps the .app bundle, Windows runs the new installer after the
    app exits). The About page adds a manual "check for updates"
    button.
  • CLI: a one-line notice on every launch when a newer version exists
    (network wait capped at 2.5s, disable with
    AGENT_SWITCH_NO_UPDATE_CHECK=1), plus agent-switch update
    which downloads, checksum-verifies and replaces the binary in
    place (--check only reports the latest version).

Installation / 安装

Open the DMG and drag Agent Switch to Applications, or extract the CLI ZIP and place agent-switch on PATH. Codex CLI / Claude Code must be installed separately.

The app is ad-hoc signed and not notarized by Apple. Check SHA256SUMS.txt before opening it. If macOS blocks an app you trust, use System Settings → Privacy & Security → Open Anyway.

打开 DMG，将 Agent Switch 拖入“应用程序”；CLI 用户解压 ZIP 并将 agent-switch 放入 PATH。Codex CLI / Claude Code 需单独安装。应用采用 ad-hoc 签名、未公证，请先核对校验和；确认信任来源后，可在“隐私与安全性”中选择“仍要打开”。

These packages are for Apple Silicon; the Windows packages (NSIS, MSI and CLI ZIP) are added to this same release. Intel and Linux users can build from source.

Agent Switch v0.2.2

Agent Switch 0.2.2 — macOS Apple Silicon + Windows x64

Fixed

• Parse GitHub release metadata as JSON, so both compact and formatted
  responses work with the macOS/Linux installer.

Documentation

• Document the Node.js prerequisite for the macOS/Linux install script.

Downloads

• macOS (Apple Silicon): Agent.Switch_0.2.2_aarch64.dmg (GUI), agent-switch-0.2.2-aarch64-apple-darwin.zip (CLI)
• Windows (x64): Agent.Switch_0.2.2_x64-setup.exe (NSIS installer), Agent.Switch.Setup.0.2.2.x64.msi (MSI), agent-switch-0.2.2-x86_64-pc-windows-msvc.zip (CLI)
• Checksums for every package: SHA256SUMS.txt

Installation / 安装

macOS: open the DMG and drag Agent Switch to Applications, or extract the CLI ZIP and place agent-switch on PATH.
Windows: run the NSIS or MSI installer, or extract the CLI ZIP and place agent-switch.exe on PATH.
Codex CLI / Claude Code must be installed separately.

macOS：打开 DMG，将 Agent Switch 拖入“应用程序”；CLI 用户解压 ZIP 并将 agent-switch 放入 PATH。
Windows：运行 NSIS 或 MSI 安装包，或解压 CLI ZIP 并将 agent-switch.exe 放入 PATH。
Codex CLI / Claude Code 需单独安装。macOS 应用采用 ad-hoc 签名、未公证，请先核对 SHA256SUMS.txt 校验和；确认信任来源后，可在“隐私与安全性”中选择“仍要打开”。

macOS packages are for Apple Silicon, Windows packages for x64. Intel and Linux users can build from source.