Skip to main content

Troubleshooting & FAQ

Common problems​

macOS​

tart: command not found The Workbench uses Tart to run the sandbox. Install it:

brew install cirruslabs/cli/tart

Build or launch fails right away Make sure the Xcode Command Line Tools are installed:

xcode-select --install

It won't run on my Mac The Workbench currently supports Apple Silicon (M-series) on macOS 13+. Intel Macs aren't supported yet. Check with uname -m (you want arm64) and your macOS version under → About This Mac.

Windows​

WSL2 isn't available / the sandbox won't provision Enable WSL2 and make it the default:

wsl --install
wsl --set-default-version 2

Restart when prompted. The Workbench targets Windows 11 (Windows 10 needs WSLg installed manually).

The control page​

My browser didn't open The launcher serves its control page on a fixed loopback address. Open it yourself:

http://127.0.0.1:8181

The page is blank or won't connect

  • Confirm the launcher is still running (it's the process that serves the page).
  • Make sure nothing else is using port 8181.
  • The launcher only binds to loopback (127.0.0.1) by design — it isn't reachable from other machines, so don't try to open it from a different device.

The workspace is slow to open The first open on a machine prepares the sandbox image and is the slowest step — give it a minute. Watch the activity log on the control page for progress. Later launches are quick.

FAQ​

Do I need Kenaz Fleet to use the Workbench? No. The Workbench (and the Harness inside it) work fully on their own. Fleet is an optional team control plane; signing in is opt-in. See Fleet overview.

Do I need Docker? No — not to run the Workbench. Docker is only used by maintainers when building the guest image.

Is my data sent anywhere? Kenaz is local-first. Your provider keys live in your OS keychain, and your prompts and files stay on your machine. If you sign in to Fleet, what it can sync is opt-in and bounded by your role and plan — see Connecting to Fleet.

Can I use the Harness without the Workbench? Yes. The Kenaz Harness runs standalone, natively, with no sandbox. The Workbench is the recommended way to run it (everything included, contained), but it's not required.

How is this different from just running an agent on my laptop? Inside the Workbench, agents and tools run in an isolated Linux environment — they can't see your home directory, keys, or other projects unless you share them in. That containment is the whole point.

Where do I download it? A signed download isn't published yet — for now you build from source. When the build is ready it'll be on the download page.

Will there be a Linux or Intel-Mac version? Not in the current release. Linux is the guest (what runs inside the sandbox), not a supported host; Intel Macs aren't supported yet.

Still stuck?​