Codchi
Codchi is a free, open-source tool for managing project development environments with Nix.
What Codchi is
Codchi is a free, open-source tool for managing project development environments with Nix. It installs, updates, and rolls back environments reproducibly, with the homepage describing bit-for-bit consistency across machines. Teams define Code Machines in repository code, allowing each project commit to retain its environment and setup automation. Codchi runs these machines in isolated environments through WSL on Windows and LXD containers on Linux. A Code Machine is also a NixOS module, so NixOS options can be used alongside Codchi options. Host integration can add start-menu shortcuts for graphical applications and provide a shell containing machine tools. Documentation covers VS Code, VSCodium, JetBrains IDEs, Vim, and Neovim. Windows installation covers Windows 10 and 11 and requires WSL 2.0.14 or later; Linux uses LXD and a Nix package. macOS is not implemented. Codchi is in beta and supports runtime management, dependency locking, configuration as code, shell integration, and containers.
Good
- Free and open source under MIT license
- Reproducible install, update, and rollback workflows
- Isolated WSL and LXD Code Machines
- Supports several editors and IDEs
- Configuration, dependency, and shell integration
Watch out
- macOS is not implemented
- Windows requires WSL 2.0.14 or later
- Linux virtualization uses LXD
- Beta status may include bugs or incomplete features
Who it suits
Codchi suits developers who need reproducible, isolated environments across Windows or Linux. It is intended for projects that value configuration as code and host integration.
Verdict
Codchi combines Nix-based reproducibility with isolated Code Machines and host integration. It is a fit for Windows and Linux projects that need environments tracked in repository code, but macOS users cannot use it currently.
The facts
Each one read from Codchi's own pages, with the date it was checked.
What it does
- Beta status
- Codchi is in beta and the maker warns that bugs and incomplete features may occur.checked 3 Oct 2026
- Editor integrations
- Documentation describes configuring VS Code, VSCodium, JetBrains IDEs, Vim, and Neovim inside a Code Machine.checked 3 Oct 2026
- Host integration
- Codchi can create host start-menu shortcuts for graphical applications and provide a shell with the machine's tools.checked 3 Oct 2026
- Isolation
- Codchi runs code machines in isolated environments using virtualization such as WSL on Windows and LXD containers on Linux.checked 3 Oct 2026
- License and funding
- The GitHub repository identifies an MIT license and says the project is funded through aformatik's use of Codchi and professional services.checked 3 Oct 2026
- License and vendor lock-in
- The project README describes Codchi as fully open source, identifies an MIT license, and says the project avoids vendor lock-in.checked 3 Oct 2026
- Project configuration
- Code Machines are defined in code and checked into a repository so projects can retain an environment for each commit.checked 3 Oct 2026
- Project setup
- Development environments are defined in code in the project repository, supporting setup automation and an environment for each project commit.checked 3 Oct 2026
- Purpose
- Codchi manages a project's development environment using Nix so it can be installed, updated, and rolled back reproducibly.checked 3 Oct 2026
- Recommended use
- The documentation says Codchi is suited to environments needing proper isolation and host integration across Windows and Linux; simpler Nix-shell approaches may suit simpler projects.checked 3 Oct 2026
- Related tools
- Codchi can be used alongside devenv.sh or Flox, which provide the development environment while Codchi provides consistency and host integration across Windows and Linux.checked 3 Oct 2026
- Reproducibility
- Codchi installs, updates, and rolls back environments, and its homepage describes them as bit-for-bit reproducible across machines.checked 3 Oct 2026
- Secrets
- Codchi's design documentation describes secrets as stored on the host and provided to a Code Machine when it starts; it says host-side storage should preferably be encrypted.checked 3 Oct 2026
- Security and isolation
- The maker says Codchi can provide isolated environments and describes secret management as a capability enabled by host operating-system integration.checked 3 Oct 2026
- Standards and portability
- The homepage says every NixOS module is a valid Code Machine and every Code Machine is a valid NixOS module.checked 3 Oct 2026
- Support
- The project offers community support through GitHub Issues and describes professional feature assistance, troubleshooting, training, and consulting through aformatik.checked 3 Oct 2026
Where it runs
- Linux support
- Linux installation uses LXD for virtualization, and Codchi is currently packaged with Nix on Linux.checked 3 Oct 2026
- macOS availability
- The installation guide says macOS is not currently implemented.checked 3 Oct 2026
- macOS limitation
- The installation page says macOS is not implemented.checked 3 Oct 2026
- NixOS compatibility
- A Code Machine is a NixOS module, and Codchi supports NixOS options alongside its own options.checked 3 Oct 2026
- Windows support
- Installation instructions cover Windows 10 and 11 and require WSL 2.0.14 or later.checked 3 Oct 2026
Alternatives to Codchi
- 1
DevPod
Free planOpen sourceLinuxmacOSSelf-hostedWindows7.4Free plan - 2
nvm
Free planOpen sourceLinuxmacOSSelf-hostedWindows7.4Free plan - 3
ActiveState Platform
Free planWebAPILinuxmacOS7.2Free plan - 4
Flox
Free planWebExtensionLinuxmacOS7.1From $20 a month - 5
GHCup
Free planWebLinuxmacOSSelf-hosted7.0Free plan - 6
devenv
Free planWebLinuxmacOSWindows6.9Free plan