Ana Sayfa / Kod ve Scriptler / DeskCheck Desktop Test Harness for Coding Agents

DeskCheck Desktop Test Harness for Coding Agents

DeskCheck, kodlama ajanları için YAML masaüstü testleri çalıştırır; uygulama izin listesi, ekran görüntüleri ve geçti/kaldı raporları sunar.

  • Yayın tarihi11 Kasım 2026
  • Paket içeriği.rb, .yml/.yaml, composer.json
  • Son güncelleme12 Kasım 2026
  • Canlı demoVar
DeskCheck Desktop Test Harness for Coding Agents

Overview

DeskCheck is a test harness for coding agents that build desktop software. The agent writes a small YAML test — launch this app, click here, type this, take a screenshot, check the window is showing — and DeskCheck runs exactly those steps and hands back a pass/fail report. The steps are data, never code: there is no shell or exec step, so a test can't turn into arbitrary commands.

An agent that can click anywhere on a real desktop can also wander into your mail, your password manager, and a browser where you're already signed in. DeskCheck's headline feature is the allowlist: only the apps you name may be launched or touched, everything else is denied by default, and whole categories — password managers, credential stores, system settings, browsers carrying real profiles — are refused outright. The check runs at launch and again at every input step.

What it does:

- YAML test steps: launch, wait, click, type, key, screenshot, assert — nothing else exists

- Named-app allowlist with default deny, enforced at launch and at every input step

- Mock driver for hermetic runs — prove the loop works with no real desktop

- Real drivers for Linux (xdotool + scrot) and Windows (PowerShell + .NET)

- Reports in Markdown and HTML, a JSONL action log, and a screenshot per screenshot step

- Pixel-diff assertions: fail when a view changes more than your tolerance

- MCP server included, so an agent can call DeskCheck as a tool

- Exit codes say what happened: 0 pass, 1 fail, 2 setup/parse error, 3 interrupted

What's inside the download:

- DeskCheck source code (Python package, drivers for Linux / Windows / mock)

- README.md — what it is and how to run it

- INSTALL.md — step-by-step setup

- Worked examples: a passing demo test, a pixel-diff test, and a denied-app test that shows the allowlist blocking an app

- docs/ — the security model and the research behind it

- The full test suite, so you can check the harness itself before trusting it

- LICENSE — MIT license

How you run it: Install it with `pip install -e .`, then run the demo test with the mock driver (command above, step 4). It passes without touching a real desktop. On a real machine, swap --driver mock for --driver linux or --driver windows and point the test at a real app from your allowlist.

Open source, stated plainly: DeskCheck is my own code, and the same code is free on GitHub under the MIT license. This package is the supported download — the tested release zipped with its docs, examples, and test suite, and email support from me if something in the package is broken. If you'd rather clone the repo, that door is open. I'd rather you knew before you paid.

You pay once — there is no subscription and no account to create.