What is a workbench?
Kenaz is a desktop app for macOS and Linux. You use it to create and run workbenches.
A workbench is a Linux virtual machine that Kenaz starts on your computer from a profile. The profile is a saved recipe: which apps run inside, how much CPU, memory and disk the VM gets, which folder on your computer is shared into it, which AI provider the Harness uses, and which network destinations it may reach. Each workbench opens in its own Kenaz window, with one tab per app.
:::note Current state Kenaz is pre-release software. On macOS, opening a workbench needs a workbench image, and no images are published to the downloads site yet. Read Workbench images before you start. On Linux, Kenaz does not start a virtual machine at all; see Linux hosts. :::
What runs inside
The apps you can put in a workbench:
| App | What it is | How you see it |
|---|---|---|
| Kenaz Harness | The Kenaz Harness agent app | A tab in the workbench window |
| VS Code Server | VS Code in the browser | A tab |
| Jupyter Lab | Notebooks | A tab |
| Terminal | A shell in the VM | A tab |
| Browser | A Chromium browser running in the VM | A tab |
| Warp, Claude Desktop | Desktop apps running in the VM | A tab |
| Chromium · headless | A browser that agents drive | Listed under Background; no tab |
| Dev Toolchain | Language toolchains for your project | Listed under Background; no tab |
A new profile starts with the Harness only. The built-in Daily Driver profile has the Harness, VS Code Server and the headless browser.
How it works on each platform
| Host | What a workbench is |
|---|---|
| macOS (Apple Silicon) | A NixOS virtual machine run by Tart. Kenaz offers to install Tart for you the first time you open a workbench. |
| Linux | No virtual machine. Kenaz runs code-server as a process on your computer. |
Windows isn't published.
How it fits with the Harness and Fleet
- Kenaz Harness is the main app inside a workbench. You can also download and run the Harness on its own, without Kenaz.
- Kenaz Fleet is optional. Kenaz asks you to sign in on first launch, and you can skip that and sign in later.