Desktop app
Desktop app
Choose the AgentKit Desktop App when you want a native interface for local setup, Kits, projects, activity, sessions, MCP, and configuration.
These pages describe AgentKit Desktop v2.12.0. Artifact filenames,
bytes, and SHA-256 hashes are refreshed from the release page.
Screenshots in public/gui/ may still show earlier layouts and will be
recaptured in a follow-up pass; the described behavior matches the
v2.12.0 packages.
AgentKit Desktop gives you a native window for inspecting and managing the AgentKit state on this computer. Use it when you want guided first-run setup, visual Kit lifecycle controls, or local activity and session views without driving each operation from a terminal.
Choose the right surface
Desktop, the CLI, and the browser dashboard share AgentKit data, but they are different launch surfaces.
| Surface | Best for | How it runs |
|---|---|---|
| Desktop app | Guided setup and visual local management | A separate Wails package with an embedded interface and in-process Go APIs |
ak CLI | Exact commands, automation, headless hosts, and full command coverage | A terminal executable installed separately on PATH |
| Browser dashboard | A visual interface in a browser, including remote or headless use when configured safely | A local HTTP server started by ak config start; loopback 127.0.0.1:8766 by default |
Installing Desktop does not install the standard ak CLI on PATH. The
normal CLI artifact also does not contain Wails: running ak gui from it prints
a Desktop download hint rather than finding an app you installed elsewhere.
Read the ak gui reference for
the exact command boundary.
Supported v2.12.0 packages
| Operating system | Desktop architectures |
|---|---|
| macOS | Intel (amd64) and Apple silicon (arm64) |
| Linux | x64 (amd64) only |
| Windows | x64 (amd64) only |
There is no v2.12.0 Desktop package for Linux ARM64 or Windows ARM64. The CLI remains available on both. Other operating systems, architectures, and 32-bit hosts are not included in the Desktop release matrix.
Continue to Installation for the exact package names and SHA-256 values.
What you can do
After activating an App license on this device, Desktop can:
- Scan installed coding agents, registered projects, available Kits, health, configuration, and update status;
- Browse Kits and skills, install licensed Kits, and preview and apply supported Kit updates;
- Register local projects and inspect project-scoped and global Kit installs;
- Inspect local Activity and supported Claude Code and Codex session evidence;
- List, verify, and preview supported MCP configuration changes before applying them; and
- Edit AgentKit configuration, inspect effective settings, and locate local AgentKit data stores.
Desktop v2.12.0 does not launch a Kit skill or agent run. Run the installed skill inside its coding assistant, or use the appropriate CLI command. Desktop then reads the resulting local Activity and session evidence where that runtime is supported.
Start safely
- Install and verify Desktop.
- Activate the App and complete first launch.
- Review Desktop update behavior before enabling auto-update.
- Keep Troubleshooting available for platform prompts, session boundaries, and staged-update recovery.