CleanSlate
The open source coding agent.
The current release is CleanSlate 1.0.2. See the release notes or download it directly:
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | |
Builds are signed and notarized.
Note
Intel macOS, Windows, and Linux aren't published yet. Build from source on those platforms.
The same agent runs without the editor:
npm install -g @cleanslate/cli
cleanslate
Or try it without installing:
npx @cleanslate/cli "fix the failing test"
Node 20 or later. It walks you through provider setup on first run, and works against any repository — the full tool set, not a reduced one.
See packages/cleanslate-cli for options, slash commands, sessions, and MCP configuration.
The engine behind both surfaces is published on its own:
npm install @cleanslate/sdk
It carries the execution loop, all 59 tools, the edit engine and a Node host, with no editor dependency. A surface supplies host capabilities — a filesystem, a way to run commands, optionally diagnostics and a browser — and the runtime drives the loop.
| Package | Version |
|---|---|
@cleanslate/cli |
1.0.2
· @cleanslate/sdk
1.0.2
· Note
The CLI and SDK follow semantic versioning. Breaking changes require a major version release.
Requires Node.js 22.21.1 (see .nvmrc).
cd vscode-fork
npm install
npm run watch
./scripts/code.sh
CleanSlate has two modes you can switch between per message.
Execution— Default, full-access mode for building things** Plan**— Read-only mode for analysis and code exploration- Cannot edit files or run commands
- Can still read, search, browse the web, and drive a browser
- Ideal for exploring unfamiliar codebases or planning changes
CleanSlate is not coupled to any provider. Bring your own key for OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, xAI Grok, NVIDIA, OpenRouter, or any OpenAI-compatible endpoint.
Or sign in to CleanSlate Pro for managed models, higher limits, and pay-as-you-go credits. Pro is optional — everything works with your own key, and no account is required.
- Read, search, and edit across your whole codebase
- Run commands, including long-running ones in the background
- Drive a real browser to check its own work
- Search and fetch from the web
- Call any MCP server you configure
Code search runs on your machine. Indexing and embeddings use a bundled model, so your code is never sent anywhere to be searched.
CleanSlate installs extensions from Open VSX. The Visual Studio Marketplace is Microsoft-only and can't be used by forks.
Issues and pull requests are welcome — see CONTRIBUTING.md and our Code of Conduct.
To report a security issue, see SECURITY.md.
CleanSlate is MIT licensed.
It is a fork of Visual Studio Code (MIT, © Microsoft Corporation) — see LICENSE.txt. CleanSlate is not affiliated with, endorsed by, or sponsored by Microsoft.