Skip to main content

Install KnoxCoder

Download a desktop build from GitHub Releases. Knox Agent is inside the app. You do not install a VSIX, and you should not search Open VSX for Knox.

Current series: 2.2.x · Latest release · checksums in SHA256SUMS on the same page.

Pick the asset that matches your OS and CPU. Names look like KnoxCoder-<version>-<platform>-<arch>….

Apple Silicon (arm64) and Intel (x64) are separate builds.

AssetUse
KnoxCoder-darwin-arm64.dmg or KnoxCoder-<version>-darwin-arm64.zipApple Silicon
KnoxCoder-darwin-x64.dmg or KnoxCoder-<version>-darwin-x64.zipIntel

DMG (preferred). Open the disk image and drag KnoxCoder to Applications. macOS builds are signed, notarized, and stapled (./build_dmg.sh on the release machine). Gatekeeper should open the app without extra steps.

ZIP. Unzip and move KnoxCoder.app to Applications. If macOS says the app is from an unidentified developer, the DMG is the better download.

Confirm Help → About shows KnoxCoder and a 2.2.x product version.

Verify the download​

Every GitHub Release attaches SHA256SUMS. Check the file you downloaded:

# macOS / Linux
shasum -a 256 KnoxCoder-*
# compare the line to SHA256SUMS

# Windows (PowerShell)
Get-FileHash .\KnoxCoder-*-setup.exe -Algorithm SHA256

Auto-update uses the same hashes: the app fetches latest-<platform>-<arch>.json from https://github.com/knoxchat/knoxcoder/releases/latest/download/ and, on Windows, checks sha256hash before applying.

First launch​

  1. Open KnoxCoder. Knox is already in the Activity Bar (the Knox icon). You do not enable a preview flag.
  2. Do not install knoxchat.knoxchat from any marketplace. If a leftover copy exists, KnoxCoder disables it; the builtin vscode.knox wins.
  3. Open a folder (see Open a folder). Chat without a folder has nowhere safe to edit.
  4. Sign in or add a model (Sign in and models), then send a message (First chat).

Global state is created under ~/.knoxcoder on first use (C:\Users\<you>\.knoxcoder on Windows).

Auto-update​

Packaged builds poll GitHub Releases (no API token):

https://github.com/knoxchat/knoxcoder/releases/latest/download/latest-<platform>-<arch>[-<target>].json

The JSON productVersion is compared with Help → About. Download Update fetches that package URL, not the generic releases HTML page.

Turn updates off in the editor if you need a pinned version. There is no separate Knox updater besides the editor’s update service.

What this install does not give you​

  • Remote SSH / WSL / Dev Containers — the Knox host does not run on a remote file system in 2.2. Edit locally.
  • Web — gulp vscode-web skips Knox; activation refuses UIKind.Web.
  • Headless CLI — knox run is not in 2.2.
  • Building from source — not required for users. Contributors use the repo README.

Next​

Sign in or add a model, then send the first chat.