Installation

Windows

1. Download the installer:

   https://contextcodedev.iaforged.com/downloads/ContextCode-Setup.exe

2. Run ContextCode-Setup.exe and follow the wizard (it is a standard NSIS installer: next, next, install).

3. When it finishes, open Context Code from the Start menu. You will see the splash screen with the logo and the tagline “Create without limits”.

Note

Context Code uses Microsoft WebView2, which already ships with Windows 11 and with most up-to-date Windows 10 installs. If your Windows does not have it, Windows itself offers it as an update.

The Windows installer: a few clicks and you are done.

macOS

1. Download the disk image:

   https://contextcodedev.iaforged.com/downloads/ContextCode.dmg

2. Open it with a double click and drag Context Code into the Applications folder.

3. Open the app from Launchpad or from Applications.

Note

The app is signed with a Developer ID and notarized by Apple, so it opens with no security warnings and without touching the Terminal. If an older version asked you to run xattr -cr, that is no longer needed.

Requires macOS 13 (Ventura) or later on a Mac with Apple Silicon (M1, M2, M3, M4…).

Linux

There are two formats:

• .deb — recommended for Ubuntu, Debian, Mint and derivatives. Install it with apt pointing at the file (the ./ is mandatory; that way dependencies resolve on their own):

  sudo apt install ./context-code-desktop_<versión>_amd64.deb
  context-code-desktop

  Caution

  Do not use a bare sudo dpkg -i: it does not resolve dependencies and can leave the package half installed on a brand-new system.

• .AppImage — universal, works on any modern x86_64 distribution (Fedora, Arch, openSUSE, Manjaro…). There is nothing to install: give it execute permission and open it.

  chmod +x context-code-desktop_<versión>_amd64.AppImage
  ./context-code-desktop_<versión>_amd64.AppImage

Linux Server (headless)

For a server or a VPS with no graphical environment, the one-line installer:

curl -fsSL https://contextcodedev.iaforged.com/downloads/install.sh | bash

It installs the .deb, verifies its SHA-256 checksum and offers to sign you in. To update, the same command. Then, over SSH:

contextcode chat                       # the agent in the terminal
contextcode serve --print-qr --public  # web/mobile access with QR

All the details are in Context Code from the terminal.

Android

The APK is downloaded from the downloads page, where there is a QR code to install it straight from your phone. Since it doesn’t come from the Play Store, Android will ask for permission once: tap Settings, enable “Allow from this source” for your browser, go back and tap Install. The permission is granted to that app only.

Requirements

• Windows: 64-bit Windows 10/11 with WebView2 (included in Windows 11).
• macOS: macOS 13 (Ventura) or later, on a Mac with Apple Silicon.
• Linux: a distribution with webkit2gtk 4.1 — Ubuntu 22.04+, Debian 12+ or equivalent. The .AppImage is the most portable option (on Ubuntu 22.04+ also install libfuse2).
• Android: Android 6 or later.
• You do not need to install Node, Rust or any development tooling: the installer brings everything with it. Since 3.6.0 that includes the engine for the real-time conversation — the voice agent, the server and the models — so that mode works right after installing and with no internet connection.
• To use cloud models you will need an account with the provider you choose; for local models, the more RAM (and GPU) you have, the bigger the models you can run.

After installing

The next step is connecting an AI provider and opening your first project: continue with Your first chat.

Mobile app (optional)

Context Code has a phone app that pairs with your PC by scanning a QR code. The details are in Mobile app.