Installation
Windows
Section titled “Windows”-
Download the installer:
https://contextcodedev.iaforged.com/downloads/ContextCode-Setup.exe -
Run
ContextCode-Setup.exeand follow the wizard (it is a standard NSIS installer: next, next, install). -
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”.
-
Download the disk image:
https://contextcodedev.iaforged.com/downloads/ContextCode.dmg -
Open it with a double click and drag Context Code into the Applications folder.
-
Open the app from Launchpad or from Applications.
Requires macOS 13 (Ventura) or later on a Mac with Apple Silicon (M1, M2, M3, M4…).
There are two formats:
-
.deb— recommended for Ubuntu, Debian, Mint and derivatives. Install it withaptpointing at the file (the./is mandatory; that way dependencies resolve on their own):Ventana de terminal sudo apt install ./context-code-desktop_<versión>_amd64.debcontext-code-desktop -
.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.Ventana de terminal chmod +x context-code-desktop_<versión>_amd64.AppImage./context-code-desktop_<versión>_amd64.AppImage
Linux Server (headless)
Section titled “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 | bashIt 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 terminalcontextcode serve --print-qr --public # web/mobile access with QRAll the details are in Context Code from the terminal.
Android
Section titled “Android”The Android app is installed from Google Play. The downloads page has a QR code that opens its listing straight on your phone: scan it, tap Install and Google Play keeps it up to date.
Requirements
Section titled “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
.AppImageis the most portable option (on Ubuntu 22.04+ also installlibfuse2). - Android: Android 7.0 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
Section titled “After installing”The next step is connecting an AI provider and opening your first project: continue with Your first chat.
Mobile app (optional)
Section titled “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.
Extra devices
Section titled “Extra devices”Each plan allows Context Code to be activated on a maximum number of devices at the same time. If you try to activate it on one more, the app tells you and offers Add a device.
- Click Add a device in the app notice, or go to My account on the website and, under Devices on your plan, click Add device. There you can see how many devices you use and how many your plan allows.
- Each extra device costs 10 USD per month on monthly plans or 100 USD per year on yearly plans. Confirming creates a pending request with that price; you can cancel it while it is still pending.
- Make the payment through the channel you are given. Once it is confirmed, the request is approved and your limit goes up.
- In the app, click I already paid / revalidate and the device that was blocked is activated.
If the request is rejected, you will see the reason in My account.
Documentation assistant
Answers only from the Context Code manual
Hi. Ask me how to use Context Code and I'll answer with what this documentation says, linking to the pages.
Listening…
Speak normally. When you pause, I answer out loud.
It can make mistakes: check the details on the linked pages. 0/500