testing-in-vms
Skill4.4k starsChanged 4 days agoMITView on GitHub
Tests Zen inside a local virtual machine running another operating system. Use when a change needs checking on macOS, Linux or Windows, when reproducing an OS-specific bug, or when a test needs a clean machine or a real desktop session.
- Installs packages
Trending
Quiet since March.about the whole repository
Who's talking about ZenPrivacy/zen-desktop
- @technews4869.bsky.social“github.com/ZenPrivacy/zen-... GitHub - ZenPrivacy/zen-desktop: Simple, free and efficient ad-blocker and …”Bluesky · Oct 20, 2025 · 4 likes
- @sakak.bsky.social“GitHub - ZenPrivacy/zen-desktop: Simple, free and efficient ad-blocker and privacy guard for Windows, macOS …”Bluesky · Dec 6, 2025 · 3 likes
- irbis-sh/zen-core“ Add NSS certificate store support for browsers”GitHub · Dec 1, 2025 · 3 reactions
- @golangch.bsky.social“A simple, free and efficient ad-blocker and privacy guard for Windows, macOS and Linux #golang …”Bluesky · May 7, 2025 · 3 likes
- irbis-sh/zen-desktop“improve error wrapping in Set (sysproxy) for DE error handling”GitHub · Oct 21, 2025 · 2 reactions
The biggest 5 of 54 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 54
Talked about on GitHub and Bluesky (54 times).
On GitHub · 50
- Dec 1, 2025 Add NSS certificate store support for browsers — irbis-sh/zen-core3 reactions · 3 comments
- Oct 21, 2025improve error wrapping in Set (sysproxy) for DE error handling — irbis-sh/zen-desktop2 reactions · 1 comment
- Oct 10, 2025feat(csp): patch CSP meta tags and update PatchHeaders signature — irbis-sh/zen-desktop2 reactions · 3 comments
- Mar 3, 2026Implement HTTP/3 proxying in `proxy` — irbis-sh/zen-core1 reaction
- Nov 10, 2025Zen Privacy corrupting all file downloads — irbis-sh/zen-desktop1 reaction · 7 comments
45 more on GitHub
- Sep 5, 2025Consider/add dependency injection — irbis-sh/zen-desktop1 reaction · 1 comment
- Apr 6, 2025Add Zen (github.com/ZenPrivacy/zen-desktop) to projects in README — aidarnouman/awesome-made-in-kz1 reaction · 2 comments
- Feb 28, 2026Update Zen filter list URLs to use jsDelivr; ad no-doomscroll filter for YouTube shorts — irbis-sh/zen-desktop0 reactions · 1 comment
- Feb 22, 2026Unable to filter ads in the Firefox browser — irbis-sh/zen-desktop0 reactions
- Feb 20, 2026Pass file descriptor instead of path in downloadAndVerifyFile — irbis-sh/zen-desktop0 reactions · 1 comment
- Feb 18, 2026Resource leak in downloadAndVerifyFile: file descriptor and temp file cleanup — irbis-sh/zen-desktop0 reactions · 3 comments
- Feb 18, 2026Fix false positive golangci-lint taint analysis warnings — irbis-sh/zen-desktop0 reactions · 1 comment
- Feb 2, 2026Fix the update-changelog workflow — irbis-sh/zen-desktop0 reactions · 1 comment
- Feb 2, 2026Add cleanup for whitelistSrv if StartProxy fails after initialization — irbis-sh/zen-desktop0 reactions
- Jan 30, 2026Handle unsupported de error on proxy stop — irbis-sh/zen-desktop0 reactions · 1 comment
- Jan 20, 2026Update GitHub stars count in hero section — irbis-sh/www0 reactions · 1 comment
- Dec 11, 2025Optimize ruletree matching by only starting traversal from special characters — irbis-sh/zen-core0 reactions · 1 comment
- Nov 25, 2025Rename the "My rules" tab to simply "Rules" — irbis-sh/zen-desktop0 reactions · 1 comment
- Nov 11, 2025Fix incorrect document navigation detection — irbis-sh/zen-core0 reactions · 2 comments
- Nov 8, 2025Fix Windows uninstaller failing to terminate Zen — irbis-sh/zen-desktop0 reactions · 2 comments
- Nov 4, 2025Fix hosts rules parsing by fixing the store pattern — irbis-sh/zen-core0 reactions · 1 comment
- Oct 28, 2025Update zen-core to v1.0.3 — irbis-sh/zen-desktop0 reactions · 1 comment
- Oct 28, 2025Remove nil checks for filterLists and myRules in NewFilter — irbis-sh/zen-core0 reactions · 1 comment
- Oct 27, 2025Fix modifier escaping — irbis-sh/zen-core0 reactions · 1 comment
- Oct 25, 2025Add mitm exclusions — irbis-sh/zen-core0 reactions
- Oct 15, 2025Add syntax highlighting in My Rules — irbis-sh/zen-desktop0 reactions
- Oct 15, 2025MITM Certificate Error in Firefox on Linux — irbis-sh/zen-desktop0 reactions · 3 comments
- Oct 14, 2025Convert RuleTree to a radix tree — irbis-sh/zen-desktop0 reactions · 2 comments
- Oct 11, 2025Add interactive onboarding for users — irbis-sh/zen-desktop0 reactions · 3 comments
- Sep 27, 2025Implement tree-level lock for RuleTree.Compact() to avoid race conditions — irbis-sh/zen-desktop0 reactions
- Sep 24, 2025Benchmarks — irbis-sh/zen-desktopsays it tested it0 reactions · 1 comment
- Sep 19, 2025Document or fix CI signing failure on forks — irbis-sh/zen-desktop0 reactions
- Sep 9, 2025Implement the `:matches-attr` extended pseudo-class — irbis-sh/zen-desktop0 reactions
- Sep 9, 2025Interpret `:has`, `:is`, and `:not` as native CSS if they contain a non-extended selector list — irbis-sh/zen-core0 reactions · 4 comments
- Sep 8, 2025Consider adding StatusNoContent and StatusNotModified guards to `filter.go` — irbis-sh/zen-core0 reactions · 2 comments
- Sep 8, 2025Avoid global polyfill injection in babel configuration for injected bundles — irbis-sh/zen-desktop0 reactions
- Aug 29, 2025Change MyRules: add line numbering, split logic and JSX and fix empty line deletion — irbis-sh/zen-desktop0 reactions · 3 comments
- Jul 17, 2025back2source: Also match Go/TypeScript source symbols to Mach0 binary symbols — aboutcode-org/scancode.io0 reactions · 3 comments
- Jul 15, 2025Windows Installer isn't code signed — irbis-sh/zen-desktop0 reactions · 1 comment
- Jul 14, 2025Better scriptlet argument splitting — irbis-sh/zen-desktop0 reactions
- Jun 30, 2025Fix/single instance flag — irbis-sh/zen-desktop0 reactions · 4 comments
- Jun 30, 2025feat(app): Implement single-instance lock — irbis-sh/zen-desktop0 reactions
- Jun 26, 2025"Export debug data" functionality — irbis-sh/zen-desktop0 reactions · 7 comments
- Jun 11, 2025Issue form title — fmhy/edit0 reactions · 1 comment
- May 26, 2025Add privacy filter list with initial sanitize-clipboard scriptlet rules — irbis-sh/filter-lists0 reactions
- May 24, 2025Windows installer installs a binary without self-updates — irbis-sh/zen-desktop0 reactions
- May 17, 2025Reduce memory footprint — irbis-sh/zen-desktop0 reactions · 13 comments
- May 6, 2025Add artifact attestation generation; pin action versions in build CI workflow — irbis-sh/zen-desktop0 reactions
- Apr 25, 2025Retry `networksetup` commands with `elevate` if they fail with `Command requires admin privileges` — irbis-sh/zen-desktop0 reactions · 6 comments
- Apr 21, 2025Proxy-side JSON pruning — irbis-sh/zen-desktop0 reactions
On Bluesky · 4
- Oct 20, 2025github.com/ZenPrivacy/zen-... GitHub - ZenPrivacy/zen-desktop: Simple, free and efficient ad-blocker and privacy guard for Win... — @technews4869.bsky.social4 likes and reposts
- Dec 6, 2025GitHub - ZenPrivacy/zen-desktop: Simple, free and efficient ad-blocker and privacy guard for Windows, macOS and Linux… — @sakak.bsky.social3 likes and reposts
- May 7, 2025A simple, free and efficient ad-blocker and privacy guard for Windows, macOS and Linux #golang github.com/ZenPrivacy/... — @golangch.bsky.social3 likes and reposts · 1 reply
- Oct 19, 2025Zen-desktopはシステム全体で動作する広告ブロッカー兼プライバシーガードで、ブラウザ外のアプリのトラッカーも防いでくれるらしい。 yug1224 starred ZenPrivacy/zen-desktop… — @yug1224.com2 likes and reposts
In this repository2 other files it gives its agents.
- AGENTS.mdAGENTS.md
- writing-commit-messagesSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Use SSH for everything a shell can do: building, starting the app, reading logs, checking system state.
- Distinctive: line 18
Only Apple Silicon Macs have been tested as hosts.
- Distinctive: line 70
Check outcomes over SSH instead of reading them off the screen:
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Testing in VMs
task vm -- <command> <guest> runs a guest, copies the checkout into it, and gives SSH and screen access. <guest> is macos, linux or windows, which means this checkout's own guest of that OS, see "Several guests". The script behind it is tasks/vm/vm.sh, with one backend file per guest OS next to it.
Use SSH for everything a shell can do: building, starting the app, reading logs, checking system state. Use the screen only for what has no other route, such as system dialogs and the app's own window.
Host requirements
Only Apple Silicon Macs have been tested as hosts.
| Guest | Needs | Disk | First up |
macos | Tart, see below | about 60 GB | 24 GB download, then 7 to 10 minutes |
linux | QEMU: brew install qemu | about 10 GB | 1 GB download, about 8 minutes in total |
windows | QEMU and a Windows ISO, see below | about 22 GB | 0.9 GB download, then about 17 minutes |
For Tart: brew install openai/tools/tart. Homebrew refuses untrusted taps, so the person installing must first run brew trust --formula openai/tools/tart openai/tools/softnet. The terminal app also needs Local Network permission (System Settings > Privacy & Security > Local Network); without it SSH to the macOS guest fails with "No route to host".
For Windows: Microsoft has no download that a script can use, so a person must fetch the Windows 11 ARM64 ISO, in English (United States), from https://www.microsoft.com/software-download/windows11arm64 and save it as ~/.zen-vms/images/windows-arm64.iso, or set ZEN_VM_WINDOWS_ISO to its path. The install accepts Microsoft's licence terms on that person's behalf and leaves Windows unactivated. Setup differs between Windows releases and editions, and the recipe has not been run with all of them. If up is still waiting after half an hour, look at the screen with shot windows:base-build: Setup may have stopped at a question the answer file does not cover.
The Linux guest runs at the host's architecture, so on Apple Silicon it is an ARM build. The Windows guest is always Windows on ARM and needs an ARM host. Linux hosts have not been tried. The scripts use KVM there. On an ARM host they also need QEMU's ARM firmware, which they only know how to find on Debian and Ubuntu (package qemu-efi-aarch64). macOS guests need a Mac.
Commands
| Command | Effect |
up <guest> | Create the guest if needed, start it, wait for SSH and the desktop. |
sync <guest> | Copy this checkout, uncommitted changes included, to ~/zen in the guest. |
ssh <guest> [args] | Run a command, or pass ssh options such as -L. |
gui <guest> <command> | Run a command inside the desktop session. |
shot <guest> [file] | Save a screenshot and print its path. |
vnc <guest> <actions> | Send vncdo actions: move 720 394 click 1, type admin, key enter, pause 2. |
reset <guest> | Replace the guest's disk with a clean copy of the base. Takes under a minute. |
down <guest> | Shut the guest down. Its disk is kept. |
rm <guest> | Shut the guest down and delete it. |
list | List all guests with their state and checkout. |
ssh or gui. An SSH session is outside the desktop session. On macOS a program started from it can open windows, but any password dialog it triggers fails; on Linux and Windows it cannot show a window at all. Start GUI programs with gui. It stays attached until the program exits, so run it in the background for anything long-lived. On macOS and Linux, ending that gui command also ends a program that prints output, as Zen does; on Windows the program keeps running.
Several guests
Each checkout has its own guest per OS, named after the checkout's directory: in the worktree fix-638, linux means linux:fix-638. Sessions that work in different checkouts therefore never share a guest. Write the full name to reach any other guest: task vm -- up linux:clean creates a second one for this checkout.
- A new guest is cheap. All guests of an OS start as copies of one base, so creating one takes under a minute and little disk space. Only the first guest of an OS on a machine has to build the base, and a session that asks for a guest during that build waits for it.
- A running guest is not cheap. Each Linux or Windows guest takes 4 processor cores and up to 8 GB of memory, and macOS lets two macOS guests run at a time. Shut guests down when a test is done, and delete them with
rmwhen the work is.listmarks the guests whose checkout no longer exists. <os>:base-buildis the machine that builds a base. Whileupwaits for a Linux or Windows build, or after one failed,ssh,shotandvncwork on it.
A typical run
task vm -- up linux
task vm -- sync linux
task vm -- ssh linux 'cd zen && task build-dev' # 2 to 3 minutes the first time
task vm -- gui linux '~/zen/build/bin/Zen' & # macOS: ssh macos 'open ~/zen/build/bin/Zen.app'
task vm -- shot linux # then read the image
task vm -- vnc linux move 753 800 click 1 # click where the screenshot shows the Start buttonThe screen is 1440x900, or 1024x768 on Windows, and a pixel in the screenshot is the coordinate to click. Windows do not open in the same place every time, so read coordinates from a fresh screenshot, and take another after each action rather than assuming the result.
Check outcomes over SSH instead of reading them off the screen:
| Zen's log | System proxy | Trusted CA | |
| macOS | ~/Library/Logs/Zen/application.log | scutil --proxy | security dump-trust-settings -d |
| Linux | ~/.local/share/Zen/logs/application.log | gsettings get org.gnome.system.proxy mode | ls /usr/local/share/ca-certificates |
| Windows | $LOCALAPPDATA/Zen/Logs/application.log | reg query 'HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings' //v AutoConfigURL | certutil -user -store Root "Zen Personal CA" |
For a request through the proxy: curl -x http://127.0.0.1:<port> -sI https://<host>, with the port from the log line proxy listening on port. A blocked request returns 403. On Windows use /c/Windows/System32/curl.exe --ssl-no-revoke in place of curl, see below.
Dev mode
task vm -- gui linux 'cd zen && task dev' &
task vm -- ssh linux -f -N -L 34116:localhost:34115 # Windows: 34116:127.0.0.1:34115http://localhost:34116 on the host then serves the guest's UI. Use another host port if a second session already forwards this one. Forward 34115, the Wails dev server: it serves the UI together with the script that connects it to the Go side. The Vite port, 5173, serves the UI without that script.
macOS specifics
- Login. User
admin, passwordadmin. - First proxy start shows three password dialogs in a row. The first, "Authorize Zen to install the root CA certificate", has its password field focused: type the password and press enter. The next two, "You are making changes to the System Certificate Trust Settings", look identical and do not focus the field: click the field, type, then click "Update Settings".
- The guest is not a typical user's Mac. The image turns Gatekeeper off, logs in automatically and allows
sudowithout a password. Do not use it to judge first-launch warnings for unsigned builds. - "Connection was closed cleanly" from
shotorvncmeans the VM has crashed. Tart's VNC server crashes on the first connection after a minute or two without any client.upkeeps onevncdoconnection open in the background to prevent this, so do not kill that process. If it happens anyway, runupagain; the guest's disk is intact. - DNS. On some hosts the DNS server offered to VMs does not answer. Provisioning detects this and sets public DNS servers in the guest.
Linux specifics
- The guest is Ubuntu 26.04 with the GNOME desktop on Wayland. User
zen, passwordzen,sudowithout a password.upprints the host ports for SSH and VNC, which only listen on the loopback address. - First proxy start shows two password dialogs in a row, one to write the CA file and one to run
update-ca-certificates. Both have the password field focused: type the password and press enter. - Run Firefox once before Zen's first proxy start. Zen adds its CA to Firefox profiles only at the moment it installs the CA, and a profile exists only after Firefox has run. Otherwise Firefox rejects every page behind the proxy.
- Firefox does not show its first-run "Welcome" dialog, whose only button accepts Mozilla's terms of use. Provisioning turns it off with the
SkipTermsOfUsepolicy in/etc/firefox/policies/policies.json. - Firefox comes from Mozilla's package repository, not from the snap that Ubuntu installs by default. Ubuntu's package installs the snap, and fails the whole install when the snap store is unreachable. Profiles are therefore in
~/.config/mozilla/firefox, not under~/snap. certutilis installed (libnss3-tools), which a stock Ubuntu desktop lacks. Remove the package to test how Zen behaves without it.
Windows specifics
- The guest is Windows 11 Pro on ARM. User
zen, passwordzen, a member of Administrators.upprints the host ports for SSH and VNC, which only listen on the loopback address. - The remote shell is Git Bash, so
cd zen && task build-dev,tail,grepand~work as on the other guests. Two things differ:- Git Bash rewrites arguments that look like Unix paths, which breaks Windows options such as
/v. Write them with two slashes,//v, or putMSYS_NO_PATHCONV=1in front of the command. - Its
curltrusts its own list of CAs, not the Windows one that Zen installs into./c/Windows/System32/curl.exeuses the Windows list; it needs--ssl-no-revokebecause Zen's certificates name no revocation server.
- Git Bash rewrites arguments that look like Unix paths, which breaks Windows options such as
- SSH commands run with full administrator rights,
guicommands with the rights of a program the user starts by hand. Start Zen withgui, or it runs elevated, which no user does. - First proxy start shows one "Security Warning" dialog asking whether to install the certificate. It opens behind Zen's window, so the screenshot only shows Zen with a spinner. Press alt+tab to bring it forward (
vnc windows keydown alt key tab keyup alt), then click Yes. - Edge:
gui windows '"/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe" --no-first-run <url>' &. Without--no-first-runEdge opens its sign-in and data-sharing questions first. - The guest is not a typical user's PC. Windows is not activated, automatic updates are off, the machine has no TPM, and the user logs in automatically.
Storage and rebuilding
~/.zen-vms holds the SSH key, logs and screenshots, and for Linux and Windows also the disks: images/ has the downloads, which are only needed to build a base, <os>/base.qcow2 the provisioned base, and <os>/guests/<name>/disk.qcow2 a guest, which only stores its differences from the base. macOS disks live in Tart's storage (tart list) as zen-macos-base and zen-macos-<name>.
A base installs Go, Node and Wails at the versions the repo asks for at the time. To rebuild one, for example after a Node major version bump, delete it and run reset: tart delete zen-macos-base for macOS, rm ~/.zen-vms/<os>/base.qcow2 for Linux and Windows. Shut down the other guests of that OS first: a Linux or Windows rebuild deletes the disks of all of them, since they are of no use without the base they were made from.
The rebuild starts from the OS image that was downloaded the first time. For a newer one, run tart pull ghcr.io/cirruslabs/macos-tahoe-vanilla:latest for macOS, or delete ~/.zen-vms/images/ubuntu-*.img for Linux, before the rebuild.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

