# Show HN: CleanSlate – an open-source coding agent for the IDE, CLI, and SDK

> Source: <https://github.com/TheWariend/CleanSlate>
> Published: 2026-08-02 03:25:41+00:00

**CleanSlate**

The open source coding agent.

The current release is **CleanSlate 1.0.2**. See the [release notes](https://github.com/TheWariend/CleanSlate-Releases/releases/tag/v1.0.2) 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](/TheWariend/CleanSlate/blob/main/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](/TheWariend/CleanSlate/blob/main/vscode-fork/.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](https://open-vsx.org). The Visual Studio Marketplace is Microsoft-only and can't be used by forks.

Issues and pull requests are welcome — see [CONTRIBUTING.md](/TheWariend/CleanSlate/blob/main/CONTRIBUTING.md) and our [Code of Conduct](/TheWariend/CleanSlate/blob/main/CODE_OF_CONDUCT.md).

To report a security issue, see [SECURITY.md](/TheWariend/CleanSlate/blob/main/SECURITY.md).

CleanSlate is MIT licensed.

It is a fork of [Visual Studio Code](https://github.com/microsoft/vscode) (MIT, © Microsoft Corporation) — see [LICENSE.txt](/TheWariend/CleanSlate/blob/main/vscode-fork/LICENSE.txt). CleanSlate is not affiliated with, endorsed by, or sponsored by Microsoft.