At a Glance:
Void is an open-source fork of VS Code that enables developers to use AI agents on their codebase, checkpoint and visualize changes, and bring any model or host locally for direct AI interactions without data retention.
Overview:
Void is a fork of the VS Code editor that integrates AI agents, local model hosting, and code change visualization directly into the desktop IDE. It enables developers to work with AI assistants on their codebase without relying on external services that retain user data, as messages are sent directly to providers. The project exposes its full build pipeline, including React and Tailwind integration, custom GitHub Actions for packaging and auto-updating, and a complete AI provider architecture built from scratch. Void also provides custom editing services that support streaming diffs and background file synchronization.
Key Decision Points:
Deprecated but valuable as a reference: Void is no longer accepting contributions but remains one of the best open-source references for forking VS Code.
Built from scratch AI provider: The AI provider code is custom-built to support autocomplete with fill-in-the-middle and custom response handling, with exposed grammars for common XML and tool tags.
Full build pipeline available: Void's GitHub Actions for packaging, signing, and auto-updating the editor are available, solving a normally private part of VS Code development.
Data privacy model: Messages are sent directly to AI providers without Void retaining user data.
Custom file editing architecture: EditCodeService streams diffs token by token, and VoidModelService syncs OS files with text buffers in the background.
Core Features:
AI agents on codebase: Run AI models directly on your code through the editor interface.
Checkpoint and visualize changes: Track and visually inspect code modifications during AI-assisted workflows.
Local model hosting: Bring any model or host locally for AI interactions without external dependencies.
Streaming diff visualization: View code diffs as they stream in, token by token, through EditCodeService.
Background file synchronization: VoidModelService edits files in the background while syncing OS files with text buffers.
Custom build pipeline with GitHub Actions: Package, sign, and auto-update Void using provided CI/CD workflows.
Use Cases:
Developers who want to fork VS Code and need a production-ready reference implementation with AI integration and a complete build pipeline.
Developers who want to use AI agents on their codebase with direct provider connections and no data retention by the editor.
Self-hosting code editor hackers who need examples of mounting React and Tailwind within VS Code's build pipeline.
Open-Source Alternative Value:
Void's primary open-source value lies in its role as a reference implementation for developers forking VS Code. It provides 100% open-source solutions to challenges that are normally private or difficult when building on VS Code: integrating React and Tailwind into the build pipeline, creating GitHub Actions for packaging and auto-updating, and building AI provider code from scratch. The project's architecture for IPC communication, CSP satisfaction, and custom file editing services with streaming diffs provides a documented foundation that other VS Code forks can reference and extend.
