Install the Desktop app

Download, verify, and open the exact AgentKit Desktop package for a supported platform.

After this page, you will have opened a checksum-verified AgentKit Desktop v2.19.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.19.0 release.

Platform	Artifact	Bytes	SHA-256
macOS Intel	`ak-gui_2.19.0_darwin_amd64.zip`	15,203,798	`878a1a42c81876131406004b6c2c06bdc14dfed32dfaaed3591d40d2ba33b339`
macOS Apple silicon	`ak-gui_2.19.0_darwin_arm64.zip`	14,019,592	`7ac62139fe2251b19d4d4df74a463ff90c42e469a2f0bf264454b52898d61080`
Linux x64	`ak-gui_2.19.0_linux_amd64.AppImage`	92,105,208	`fcb9b5f8a5b23c29b925e527fcb1c39b1b0558d0f0a3c0ed0e44d1afd3aff3fc`
Windows x64	`ak-gui_2.19.0_windows_amd64.zip`	15,318,873	`1ffd2c600315cafc38d7da46480923669a86050cd5fc7cf4b6bc84995b124157`

No Desktop artifact was published for Linux ARM64 or Windows ARM64 in v2.19.0. Do not substitute the similarly named ak_2.19.0_* 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.19.0_darwin_arm64.zip

Replace arm64 with amd64 for an Intel Mac.

Linux

sha256sum ak-gui_2.19.0_linux_amd64.AppImage

Windows PowerShell

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

The macOS and Linux sidecars include the build runner's original absolute path. Compare the digest value itself; do not expect a direct -c check of those sidecar files to find your download.

Install and open it

macOS

Expand the matching zip.
Move agentkit.app to /Applications.
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.19.0_linux_amd64.AppImage
./ak-gui_2.19.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.

The Desktop window also needs the WebKitGTK 4.1 runtime from your distribution:

Distribution	Package
Debian and Ubuntu	`libwebkit2gtk-4.1-0`
Fedora	`webkit2gtk4.1`
Arch	`webkit2gtk-4.1`

Without it, the app reports the missing runtime and exits instead of opening a window. The CLI does not use WebKitGTK and keeps working either way.

The AppImage is currently verified on Debian and Ubuntu. It bundles its own WebKitGTK library, which looks for WebKit's helper processes at a location fixed when that library was built. On distributions that install those helpers elsewhere, such as Fedora and Arch, the window can still fail to open even with the 4.1 runtime installed.

Windows

Extract ak-gui_2.19.0_windows_amd64.zip to a user-controlled applications folder.
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.19.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.19.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.

On this page