Install the Desktop app

After this page, you will have opened a checksum-verified AgentKit Desktop v2.12.0 package. Desktop is a manual download in this release; the CLI installer does not install it.

Download the matching package

Download the artifact and its .sha256 sidecar from the official AgentKit v2.12.0 release.

There is no Desktop artifact for Linux ARM64 or Windows ARM64 in v2.12.0. Do not substitute the similarly named ak_2.12.1-beta.3_* archive: that is the CLI artifact and contains no Wails window.

Verify the download

Calculate the digest of the artifact itself and compare all 64 hexadecimal characters with the table and downloaded sidecar. Stop if the file size or digest differs.

macOS

shasum -a 256 ak-gui_2.12.0_darwin_arm64.zip

Replace arm64 with amd64 for an Intel Mac.

Linux

sha256sum ak-gui_2.12.0_linux_amd64.AppImage

Windows PowerShell

Get-FileHash .\ak-gui_2.12.0_windows_amd64.zip -Algorithm SHA256

Install and open it

macOS

1. Expand the matching zip.
2. Move agentkit.app to /Applications.
3. Open agentkit.app.

If Gatekeeper blocks the first launch, confirm the digest first. Then attempt to open the app once and use System Settings → Privacy & Security → Open Anyway for that exact app. If you deliberately use the command-line fallback for the verified bundle, run:

xattr -rd com.apple.quarantine /Applications/agentkit.app

SHA-256 verification confirms the downloaded bytes, but it is separate from Apple notarization. Do not assume this package is notarized. Keep Gatekeeper on; do not apply a system-wide exception.

Linux

Keep the AppImage in a user-controlled applications directory, then run:

chmod +x ak-gui_2.12.0_linux_amd64.AppImage
./ak-gui_2.12.0_linux_amd64.AppImage

If it reports a FUSE error, install your distribution's FUSE compatibility package and retry the same verified AppImage. Do not run it as root.

Windows

1. Extract ak-gui_2.12.0_windows_amd64.zip to a user-controlled applications folder.
2. Run ak-gui.exe from the extracted folder.

If SmartScreen appears, recheck the SHA-256 first. For the matching official artifact, choose More info → Run anyway. Keep endpoint protection enabled.

Install the CLI separately when needed

Desktop can manage its interface without an HTTP port, but terminal commands and Desktop's paired updater need the standard ak CLI installed separately. Follow CLI installation, then confirm:

ak --version

The CLI and Desktop should report the same release before you enable Desktop auto-update. Running ak gui from the standard CLI does not launch the separate Desktop installation.

Remove Desktop

There is no Desktop uninstaller in v2.12.0. Quit the app, optionally sign out from Profile to clear the local App session, then remove only the item you installed:

• /Applications/agentkit.app on macOS;
• The exact ak-gui_2.12.0_linux_amd64.AppImage on Linux; or
• The extracted Desktop folder containing ak-gui.exe on Windows.

This does not remove the CLI, installed Kits, runtime files, or AgentKit state. ak uninstall is a managed-project removal command, not a Desktop uninstaller. Do not delete ~/.agentkit, %USERPROFILE%\.agentkit, .claude, or .codex wholesale. Continue with First launch.