Kodia

Kodia is an AI code editor built on VS Code. It started as a fork of Void, the open-source alternative to Cursor.

You bring the models: Kodia talks directly to the providers you configure, or to models running on your machine, without going through a Kodia server.

Features

• Chat sidebar with three modes: Normal (questions), Gather (reads and searches your code) and Agent (edits files and runs commands, asking for approval).
• Apply and Ctrl+K: apply suggested code, or edit a selection in place. Changes show as diffs you accept or reject.
• Checkpoints: undo everything a turn changed.
• Autocomplete with fill-in-the-middle models (Codestral and others), with context from your other open files.
• Agents window: long-running agent sessions with the Kodia agent, which runs every model shown in Kodia's model dropdown.
• Providers:
  • cloud: Anthropic, OpenAI, Gemini, Mistral, DeepSeek, xAI, Groq, OpenRouter. Each comes with its most recent model. Once you add a key, Kodia adds every day the other models a provider lists (on OpenRouter, its 5 best free models for code, then its 5 most used): those OpenRouter models and each provider's 5 most used on OpenRouter switched on, the others switched off;
  • cloud platforms: Google Vertex, Azure, AWS Bedrock, LiteLLM;
  • any OpenAI-compatible API.
• Local models: Ollama, LM Studio and vLLM, plus MLX on Apple Silicon.
• Tools: MCP servers, a terminal, file search and editing, and web pages (fetch_url, with your approval). Kodia also keeps a project memory in .kodia/memory.md.
• Long threads: when a thread outgrows the model's context window, the model summarizes the older messages, so the agent keeps what was decided.
• Project rules: Kodia follows .voidrules, and also AGENTS.md, CLAUDE.md, .cursorrules and .windsurfrules, so a project set up for another agent works as is.
• Attachments: images and PDFs, for the models that support them.
• Commit messages generated from your changes in Source Control.
• Import your settings and extensions from VS Code, Cursor or Windsurf.

Install

Download the latest version for macOS, Windows or Linux from the releases. Kodia checks for new versions itself.

Updating from Kodia 2.5.5 or earlier

Up to 2.5.5, Kodia used Void's identifiers. It now has its own, so it no longer gets mixed up with an installed Void. Your settings, API keys, chats and extensions carry over: on first launch, Kodia copies ~/.void-editor to ~/.kodia. What changes:

• macOS: install the new version from the .dmg. When macOS asks whether Kodia may use its keychain item ("Kodia Safe Storage"), choose Always Allow, or Kodia can't read your API keys.
• Linux: the package and the command are now called kodia. Uninstall the old void package.
• Windows: the installer also has its own identity now. Whether you run it or Kodia updates itself, it removes the previous Kodia (2.6.4 or earlier) and installs into the same folder with the same options, so Apps & features lists a single Kodia. An installed Void is left alone. If a taskbar or Start menu pin stops opening Kodia, pin it again.
• Everywhere: the command-line launcher is kodia (it was void), and links use kodia://.

Build from source

You need Node.js 24.18.0 (see .nvmrc), plus Xcode on macOS, Visual Studio Build Tools on Windows, or the build packages on Linux.

git clone https://github.com/jcommaret/kodia.git
cd kodia
nvm install && nvm use
npm install
npm run buildreact
npm run watch        # keep it running; wait for "Finished compilation"
./scripts/code.sh    # in another terminal (scripts\code.bat on Windows)

HOW_TO_CONTRIBUTE.md has the full instructions: prerequisites, common problems, checks and pull requests. KODIA_CODEBASE_GUIDE.md explains how the code is organized.

License

Kodia's additions are licensed under the Apache License 2.0. VS Code, on which Kodia is built, is licensed under the MIT License.

Kodia builds on the work of the Void, VS Code and VSCodium projects.