opensourceprojects.dev

A broadsheet for software that doesn't ask for your email

A defeat device that makes your tests pass on CI servers
GitHub RepoViews10

Project Description

View on GitHub

A JavaScript Package That Games Your CI Server (On Purpose)

You've pushed a commit, the build is running, and you're watching the little spinner next to your pull request like it owes you money. What if the tests just... passed? Not because you fixed anything, but because something quietly decided the CI server didn't need to see the truth. That's the premise behind volkswagen, a small npm package with a very deliberate joke at its core.

What It Does

volkswagen is a Node.js module you require somewhere in your codebase—typically your main test file. When your tests run, it checks whether they're executing inside a CI server. If it detects one, it intervenes so the tests pass anyway.

The detection side is straightforward: the package recognizes a long list of CI services, including Travis CI, CircleCI, Jenkins, Hudson, Bamboo, TeamCity, Team Foundation Server, Visual Studio Online CI, GitLab CI, Codeship, Drone.io, Magnum CI, Semaphore CI, AppVeyor, Buildkite, TaskCluster, GoCD, and Bitbucket Pipelines. It also catches any other CI server that exposes a CI or CONTINUOUS_INTEGRATION environment variable—which covers most of them.

On the test side, it defeats assert, tap, tape, chai, and, per the README, "any test actually that set the exit code or throw an error." The idea is that whether your suite fails by throwing or by setting a nonzero exit code, volkswagen gets in the way.

Why It's Cool

It's a joke, and it knows it's a joke. The README frames the whole thing around the 2015 Volkswagen emissions scandal—the "defeat device" that detected when a car was being emissions-tested and adjusted accordingly. The name, the illustration, the deadpan justification about wanting your software "adopted by Americans"—it all hangs together as satire aimed at a very specific developer anxiety.

  • The premise is uncomfortably relatable. Anyone who's stared at a red build on a Friday afternoon knows the temptation the README is parodying. The joke lands because the underlying feeling is real.
  • The CI detection is genuinely thorough. The list of supported services is long, and the fallback to the CI environment variable means it covers nearly everything else. Someone put real effort into the bit.
  • It ships with a badge. You can add an "evergreen" build badge to your README via a Markdown snippet, so your project can advertise a passing status it didn't earn. The badge is a nice touch—the joke extends past your terminal and into your project page.
  • The API is one line. There's no configuration, no options object, no setup ceremony. You require it or you don't.

The honest caveat: this is a parody package. Its value is comedic and educational, not practical. If you actually want your tests to fail on CI, keep volkswagen far away from your production dependencies—and probably your test dependencies too.

How to Try It

Install it with npm:

npm install volkswagen

Then require it somewhere in your codebase—the README suggests your main test file:

require('volkswagen')

That's the entire setup. From there, run your tests locally and on a CI server and compare the results. Locally, nothing changes—your failures stay failures. On CI, the package kicks in.

You can also grab the build badge for your README if you want to commit fully to the bit:

[![volkswagen status](https://auchenberg.github.io/volkswagen/volkswagen_ci.svg?v=1)](https://github.com/auchenberg/volkswagen)

The full source and documentation live at github.com/auchenberg/volkswagen. It's MIT licensed and, per the credits, heavily inspired by a similar PHP project called phpunit-vw.

Final Thoughts

volkswagen is best understood as a piece of developer culture rather than a tool you'll keep in your dependency tree. It's a sharp, well-executed joke about the pressure to show green checkmarks and the gap between what CI reports and what's actually true. If you appreciate that kind of humor—or you want a memorable way to start a conversation about test integrity with your team—it's worth a look. Just don't let it near anything you actually care about shipping.


Follow @githubprojects for more developer tools and open source projects.

Back to Projects
Project ID: volkswagenLast updated: November 22, 2026 at 02:47 AM