<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: VX</title>
    <description>The latest articles on DEV Community by VX (@vzn-vx).</description>
    <link>https://dev.to/vzn-vx</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4172151%2F5cf8fc26-89c1-4591-8d21-8dd3f2f0fa46.png</url>
      <title>DEV Community: VX</title>
      <link>https://dev.to/vzn-vx</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/vzn-vx"/>
    <language>en</language>
    <item>
      <title>Turborepo, Nx and Vite Task undo your commit on a cache hit</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Tue, 10 Nov 2026 20:56:45 +0000</pubDate>
      <link>https://dev.to/vzn-vx/turborepo-nx-and-vite-task-undo-your-commit-on-a-cache-hit-5hd9</link>
      <guid>https://dev.to/vzn-vx/turborepo-nx-and-vite-task-undo-your-commit-on-a-cache-hit-5hd9</guid>
      <description>&lt;p&gt;Commit a file that lives in a task's output folder, then build. Turborepo&lt;br&gt;
puts the old copy back and calls it &lt;code&gt;FULL TURBO&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;$ git log -1 --oneline -- packages/site/out/LICENSE
aa424fd v3
$ turbo run build
   • turbo 2.11.10
   • Packages in scope: site
   • Running build in 1 package
   • Remote caching disabled
site:build: cache hit, replaying logs d02065a43c947846
site:build: $ cat src/*.txt &amp;gt; out/index.txt
 Tasks:    1 successful, 1 total
Cached:    1 cached, 1 total
  Time:    5ms &amp;gt;&amp;gt;&amp;gt; FULL TURBO
$ git diff --stat
 packages/site/out/LICENSE | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;small&gt;Turborepo 2.11.10 · &lt;code&gt;inputs: ["src/**"]&lt;/code&gt;, &lt;code&gt;outputs: ["out/**"]&lt;/code&gt; · &lt;code&gt;out/LICENSE&lt;/code&gt; committed · setup warnings cut · 2026-11-10&lt;/small&gt;&lt;/p&gt;

&lt;p&gt;&lt;code&gt;out/LICENSE&lt;/code&gt; is source. The build never writes it. The cache kept a&lt;br&gt;
copy anyway, and the hit restored it over your commit.&lt;/p&gt;
&lt;h2&gt;
  
  
  Four of six tools lose the commit
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Case&lt;/th&gt;
&lt;th&gt;vx&lt;/th&gt;
&lt;th&gt;moon&lt;/th&gt;
&lt;th&gt;Turborepo&lt;/th&gt;
&lt;th&gt;Nx&lt;/th&gt;
&lt;th&gt;Vite Task&lt;/th&gt;
&lt;th&gt;Nix&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;committed edit under the outputs kept&lt;/td&gt;
&lt;td&gt;pass&lt;/td&gt;
&lt;td&gt;pass&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;committed &lt;code&gt;chmod +x&lt;/code&gt; under the outputs kept&lt;/td&gt;
&lt;td&gt;pass&lt;/td&gt;
&lt;td&gt;pass&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;force-added file under ignored outputs kept&lt;/td&gt;
&lt;td&gt;pass&lt;/td&gt;
&lt;td&gt;pass&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;td&gt;fail&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;small&gt;Turborepo 2.11.10 · Nx 24.0.2 · Vite Task 1.4.0 · moon 2.6.5 · Nix 2.34.6 · &lt;a href="https://vznjs.github.io/vx/conformance/" rel="noopener noreferrer"&gt;conformance cases&lt;/a&gt;, compiled from the test suites of Nx, Turborepo, Vite Task, moon, Nix and vx&lt;/small&gt;&lt;/p&gt;

&lt;p&gt;Nix fails another way: it drops &lt;code&gt;LICENSE&lt;/code&gt; from the tree. The run stays&lt;br&gt;
green in every tool, so nobody sees it until review.&lt;/p&gt;
&lt;h2&gt;
  
  
  Where it bites
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgQ1t5b3UgY29tbWl0IG91dC9DTkFNRV0gLS0-IEhbY2FjaGUgaGl0IGZvciBidWlsZF0KICBIIC0tPnxyZXN0b3JlcyB0aGUgZW50cnl8IE9bb2xkIG91dC9DTkFNRV0KICBPIC0tPiBEW2dpdCBkaWZmIHNob3dzIHlvdXIgY2hhbmdlIHJldmVydGVkXQo%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgQ1t5b3UgY29tbWl0IG91dC9DTkFNRV0gLS0-IEhbY2FjaGUgaGl0IGZvciBidWlsZF0KICBIIC0tPnxyZXN0b3JlcyB0aGUgZW50cnl8IE9bb2xkIG91dC9DTkFNRV0KICBPIC0tPiBEW2dpdCBkaWZmIHNob3dzIHlvdXIgY2hhbmdlIHJldmVydGVkXQo%3FbgColor%3Dwhite" alt="diagram" width="909" height="112"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;A &lt;code&gt;CNAME&lt;/code&gt; in the site's output folder, a hand-written &lt;code&gt;.d.ts&lt;/code&gt; in &lt;code&gt;dist/&lt;/code&gt;,&lt;br&gt;
a vendored file in &lt;code&gt;lib/&lt;/code&gt;. Each is tracked by git and sits under an&lt;br&gt;
output glob.&lt;/p&gt;
&lt;h2&gt;
  
  
  vx keys what git tracks under the outputs
&lt;/h2&gt;

&lt;p&gt;The same project under vx, after committing a new &lt;code&gt;out/LICENSE&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;$ vx run build --all
  Tasks     status  cache     ±usual    time   cpu    mem outputs  blocks worker  task
            success miss        −2ms     7ms   29%      —     17B       0 local  packages/site#build
$ git diff --stat
$ cat packages/site/out/LICENSE
license v2
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;vx treats a tracked file under an output glob as part of the key. Your&lt;br&gt;
commit changes the key, the task runs, and &lt;code&gt;LICENSE&lt;/code&gt; stays as committed.&lt;/p&gt;

&lt;p&gt;Every case and each tool's detail: &lt;a href="https://vznjs.github.io/vx/conformance/" rel="noopener noreferrer"&gt;Conformance&lt;/a&gt;.&lt;br&gt;
More at &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/a-cache-hit-undoes-your-commit/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>DTE workers that fit the work, and a footer that says how full they ran</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Sun, 08 Nov 2026 00:18:59 +0000</pubDate>
      <link>https://dev.to/vzn-vx/dte-workers-that-fit-the-work-and-a-footer-that-says-how-full-they-ran-5740</link>
      <guid>https://dev.to/vzn-vx/dte-workers-that-fit-the-work-and-a-footer-that-says-how-full-they-ran-5740</guid>
      <description>&lt;p&gt;On vx's own main branch, nine Linux workers ran 88% busy for one run.&lt;br&gt;
The footer prints that for every worker, every run.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FeHljaGFydC1iZXRhCiAgdGl0bGUgIk1hY2hpbmUgYnVzeSwgcGVyIHdvcmtlciAoJSkiCiAgeC1heGlzIFsic21hbGwjMSIsICIjMiIsICIjMyIsICIjNCIsICIjNSIsICIjNiIsICIjNyIsICIjOCIsICIjOSIsICJtYWMjMyJdCiAgeS1heGlzICIlIiAwIC0tPiAxMDAKICBiYXIgWzk0LCA5MiwgODksIDkwLCA4OCwgOTIsIDg1LCA4OCwgODYsIDc2XQo%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FeHljaGFydC1iZXRhCiAgdGl0bGUgIk1hY2hpbmUgYnVzeSwgcGVyIHdvcmtlciAoJSkiCiAgeC1heGlzIFsic21hbGwjMSIsICIjMiIsICIjMyIsICIjNCIsICIjNSIsICIjNiIsICIjNyIsICIjOCIsICIjOSIsICJtYWMjMyJdCiAgeS1heGlzICIlIiAwIC0tPiAxMDAKICBiYXIgWzk0LCA5MiwgODksIDkwLCA4OCwgOTIsIDg1LCA4OCwgODYsIDc2XQo%3FbgColor%3Dwhite" alt="diagram" width="700" height="500"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;small&gt;vx CI on GitHub runners, 160 tasks to run · 4a86e02 · 2026-11-07 · &lt;a href="https://github.com/vznjs/vx/actions/runs/42373931129" rel="noopener noreferrer"&gt;the run&lt;/a&gt;&lt;/small&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  A Mac starts only for a Mac task
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="nf"&gt;dte&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;workers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="na"&gt;hosted&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="na"&gt;machines&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="na"&gt;small&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;max&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;9&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;cpu&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;memory&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;16GB&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;platform&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;linux-x64&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="na"&gt;arm&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;max&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;cpu&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;memory&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;16GB&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;platform&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;linux-arm64&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="na"&gt;mac&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;max&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;cpu&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;memory&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;7GB&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;platform&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;darwin-arm64&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A task runs on a machine of its own platform, Linux unless it names&lt;br&gt;
another. A Mac starts only when a task needs macOS, and only as many as&lt;br&gt;
those tasks fill. &lt;code&gt;exec.worker&lt;/code&gt; sends a task to one named type.&lt;/p&gt;

&lt;h2&gt;
  
  
  A task is booked by what it used last time
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgSFtydW4gaGlzdG9yeV0gLS0-fHBlYWsgbWVtb3J5LCBhdmVyYWdlIENQVXwgQltib29raW5nXQogIEIgLS0-IEZ7YSBjb3JlIGZyZWUgYW5kIHRoZSBtZW1vcnkgZml0cz99CiAgRiAtLT58eWVzfCBXW3NlbnQgdG8gdGhlIHdvcmtlcl0KICBGIC0tPnxub3wgUVt3YWl0cywgbG9uZ2VzdCBjaGFpbiBmaXJzdF0K%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgSFtydW4gaGlzdG9yeV0gLS0-fHBlYWsgbWVtb3J5LCBhdmVyYWdlIENQVXwgQltib29raW5nXQogIEIgLS0-IEZ7YSBjb3JlIGZyZWUgYW5kIHRoZSBtZW1vcnkgZml0cz99CiAgRiAtLT58eWVzfCBXW3NlbnQgdG8gdGhlIHdvcmtlcl0KICBGIC0tPnxub3wgUVt3YWl0cywgbG9uZ2VzdCBjaGFpbiBmaXJzdF0K%3FbgColor%3Dwhite" alt="diagram" width="1095" height="214"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Memory is booked at its peak, since running out kills a task. CPU is&lt;br&gt;
booked at its average, so a worker is not left half idle.&lt;/p&gt;

&lt;h2&gt;
  
  
  A server stops once no task needs it
&lt;/h2&gt;

&lt;p&gt;A dev server or database a test depends on starts on that test's&lt;br&gt;
worker. It stops when no task left in the run uses it, and its CPU is&lt;br&gt;
charged to the tasks it served.&lt;/p&gt;

&lt;h2&gt;
  
  
  The footer shows three numbers per worker
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;  hosted.small#1  left     12 done · warm-up 91.9s
                  declared 4c/16G · actual 4c/17G
                  online 122.2s · busy 122.1s · idle 0.1s
                  cpu utilization machine 94% · tasks 67% · worker 3%
  best            8 × hosted.small + 1 × hosted.arm + 2 × hosted.mac: 160.9s
  total           cpu utilization machine 88% · tasks 63% · worker 2%
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;machine&lt;/code&gt; counts any process on the box, &lt;code&gt;tasks&lt;/code&gt; only your tasks, and&lt;br&gt;
&lt;code&gt;worker&lt;/code&gt; vx itself. The &lt;code&gt;best&lt;/code&gt; line says which workers would have run&lt;br&gt;
this run soonest, with the fewest machines.&lt;/p&gt;

&lt;p&gt;How DTE places work: &lt;a href="https://github.com/vznjs/vx/tree/main/packages/vx-dte#what-runs-where" rel="noopener noreferrer"&gt;vx-dte&lt;/a&gt;.&lt;br&gt;
More at &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/workers-that-fit-the-work/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>A DTE relay that stores nothing</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Sun, 08 Nov 2026 00:18:23 +0000</pubDate>
      <link>https://dev.to/vzn-vx/a-dte-relay-that-stores-nothing-53c4</link>
      <guid>https://dev.to/vzn-vx/a-dte-relay-that-stores-nothing-53c4</guid>
      <description>&lt;p&gt;The relay behind &lt;a href="https://vznjs.github.io/vx/blog/one-run-on-your-own-runners/" rel="noopener noreferrer"&gt;vx DTE&lt;/a&gt; keeps no&lt;br&gt;
message, sets no timer and writes no storage row. A quiet run of four&lt;br&gt;
sockets sends 60 frames through it in ten heartbeats.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgT1tvcmNoZXN0cmF0b3JdIDwtLT58InNvY2tldDogbnVtYmVyZWQsIGFja2VkInwgUigocmVsYXkpKQogIFIgPC0tPnwic29ja2V0OiBudW1iZXJlZCwgYWNrZWQifCBXMVsid29ya2VyIHNtYWxsIzEiXQogIFIgPC0tPnwic29ja2V0OiBudW1iZXJlZCwgYWNrZWQifCBXMlsid29ya2VyIHNtYWxsIzIiXQo%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgT1tvcmNoZXN0cmF0b3JdIDwtLT58InNvY2tldDogbnVtYmVyZWQsIGFja2VkInwgUigocmVsYXkpKQogIFIgPC0tPnwic29ja2V0OiBudW1iZXJlZCwgYWNrZWQifCBXMVsid29ya2VyIHNtYWxsIzEiXQogIFIgPC0tPnwic29ja2V0OiBudW1iZXJlZCwgYWNrZWQifCBXMlsid29ya2VyIHNtYWxsIzIiXQo%3FbgColor%3Dwhite" alt="diagram" width="912" height="152"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  One route, one socket each
&lt;/h2&gt;

&lt;p&gt;Each side opens one websocket and joins on it, with its CI OIDC token.&lt;br&gt;
There is no other route. A refused join gets its socket closed, with&lt;br&gt;
the reason in the last frame and in the close.&lt;/p&gt;
&lt;h2&gt;
  
  
  The two ends make sure a message lands
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2Fc2VxdWVuY2VEaWFncmFtCiAgcGFydGljaXBhbnQgTyBhcyBvcmNoZXN0cmF0b3IKICBwYXJ0aWNpcGFudCBSIGFzIHJlbGF5CiAgcGFydGljaXBhbnQgVyBhcyB3b3JrZXIKICBPLT4-UjogbWVzc2FnZSA3LCBhbiBvcmRlcgogIFItLXhXOiBzb2NrZXQgZ29uZSwgZHJvcHBlZAogIE5vdGUgb3ZlciBPOiBubyBhY2sgYWZ0ZXIgYSBoZWFydGJlYXQKICBPLT4-UjogbWVzc2FnZSA3LCBhZ2FpbgogIFItPj5XOiBtZXNzYWdlIDcKICBXLT4-UjogYWNrIDcKICBSLT4-TzogYWNrIDcK%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2Fc2VxdWVuY2VEaWFncmFtCiAgcGFydGljaXBhbnQgTyBhcyBvcmNoZXN0cmF0b3IKICBwYXJ0aWNpcGFudCBSIGFzIHJlbGF5CiAgcGFydGljaXBhbnQgVyBhcyB3b3JrZXIKICBPLT4-UjogbWVzc2FnZSA3LCBhbiBvcmRlcgogIFItLXhXOiBzb2NrZXQgZ29uZSwgZHJvcHBlZAogIE5vdGUgb3ZlciBPOiBubyBhY2sgYWZ0ZXIgYSBoZWFydGJlYXQKICBPLT4-UjogbWVzc2FnZSA3LCBhZ2FpbgogIFItPj5XOiBtZXNzYWdlIDcKICBXLT4-UjogYWNrIDcKICBSLT4-TzogYWNrIDcK%3FbgColor%3Dwhite" alt="diagram" width="666" height="538"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;The relay pushes a message down the receiver's socket, or drops it. Each&lt;br&gt;
side numbers what it sends and sends it again until the other acks it.&lt;br&gt;
The receiver takes each number once, in order.&lt;/p&gt;
&lt;h2&gt;
  
  
  A closed socket is a lost worker
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FeHljaGFydC1iZXRhCiAgdGl0bGUgIkZyYW1lcywgcXVpZXQgcnVuLCA0IHNvY2tldHMsIDEwIGhlYXJ0YmVhdHMiCiAgeC1heGlzIFsicmVsYXkgcGluZ3MgZXZlcnkgc29ja2V0IiwgInBlZXJzIHByb2JlIG9ubHkgdGhlIHF1aWV0Il0KICB5LWF4aXMgImZyYW1lcyIgMCAtLT4gMTAwCiAgYmFyIFs5MiwgNjBdCg%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FeHljaGFydC1iZXRhCiAgdGl0bGUgIkZyYW1lcywgcXVpZXQgcnVuLCA0IHNvY2tldHMsIDEwIGhlYXJ0YmVhdHMiCiAgeC1heGlzIFsicmVsYXkgcGluZ3MgZXZlcnkgc29ja2V0IiwgInBlZXJzIHByb2JlIG9ubHkgdGhlIHF1aWV0Il0KICB5LWF4aXMgImZyYW1lcyIgMCAtLT4gMTAwCiAgYmFyIFs5MiwgNjBdCg%3FbgColor%3Dwhite" alt="diagram" width="700" height="500"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;small&gt;1 orchestrator, 3 idle workers · 88-96 frames before, 24 up and 36 down after (&lt;a href="https://github.com/vznjs/vx/pull/4309" rel="noopener noreferrer"&gt;#4309&lt;/a&gt;)&lt;/small&gt;&lt;/p&gt;

&lt;p&gt;When a socket closes, the relay drops its worker at once. A worker that&lt;br&gt;
goes quiet on an open socket is asked after 1.5 heartbeats. No answer,&lt;br&gt;
and it is lost in about 4 s.&lt;/p&gt;

&lt;p&gt;When the orchestrator's socket closes, every worker's closes too.&lt;/p&gt;
&lt;h2&gt;
  
  
  Free on Cloudflare, or one container
&lt;/h2&gt;

&lt;p&gt;On Cloudflare the run is one Durable Object, there only to hold its&lt;br&gt;
sockets. What a woken object needs rides on each socket.&lt;/p&gt;

&lt;p&gt;A join costs one request, and every 20 websocket messages count as one&lt;br&gt;
more.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;docker build &lt;span class="nt"&gt;-t&lt;/span&gt; vx-dte-server packages/vx-dte-server
docker run &lt;span class="nt"&gt;-p&lt;/span&gt; 8080:8080 &lt;span class="nt"&gt;-e&lt;/span&gt; &lt;span class="nv"&gt;ALLOW&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;https://gitlab.com:group/app:.gitlab-ci.yml &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-e&lt;/span&gt; &lt;span class="nv"&gt;AUDIENCE&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;https://relay.example.com vx-dte-server
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The container is the same relay on Bun. CI builds the image and carries&lt;br&gt;
a run through it (&lt;code&gt;test.live&lt;/code&gt;).&lt;/p&gt;

&lt;p&gt;&lt;a href="https://github.com/vznjs/vx/tree/main/packages/vx-dte-server" rel="noopener noreferrer"&gt;Relay README&lt;/a&gt; ·&lt;br&gt;
more at &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/relay-stores-nothing/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>One test suite, six task runners, the same 984 cases</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Sun, 08 Nov 2026 00:17:47 +0000</pubDate>
      <link>https://dev.to/vzn-vx/one-test-suite-six-task-runners-the-same-984-cases-36fp</link>
      <guid>https://dev.to/vzn-vx/one-test-suite-six-task-runners-the-same-984-cases-36fp</guid>
      <description>&lt;p&gt;Each case is a small workspace and the outcome a user would see. All six&lt;br&gt;
tools run the same 984 cases, each in a sandbox.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FeHljaGFydC1iZXRhCiAgdGl0bGUgIkNhc2VzIHBhc3NlZCwgb2YgOTg0IgogIHgtYXhpcyBbdngsIE54LCBUdXJib3JlcG8sIG1vb24sICJWaXRlIFRhc2siLCBOaXhdCiAgeS1heGlzICJjYXNlcyIgMCAtLT4gOTg0CiAgYmFyIFs5ODIsIDY0MCwgNjI3LCA1NzksIDQ5OSwgNDczXQo%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FeHljaGFydC1iZXRhCiAgdGl0bGUgIkNhc2VzIHBhc3NlZCwgb2YgOTg0IgogIHgtYXhpcyBbdngsIE54LCBUdXJib3JlcG8sIG1vb24sICJWaXRlIFRhc2siLCBOaXhdCiAgeS1heGlzICJjYXNlcyIgMCAtLT4gOTg0CiAgYmFyIFs5ODIsIDY0MCwgNjI3LCA1NzksIDQ5OSwgNDczXQo%3FbgColor%3Dwhite" alt="diagram" width="700" height="500"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;small&gt;vx 747b26f · Turborepo 2.11.10 · Nx 24.0.2 · Vite Task 1.4.0 · moon 2.6.5 · Nix 2.34.6 · 2026-11-07 · &lt;a href="https://vznjs.github.io/vx/conformance/" rel="noopener noreferrer"&gt;every case&lt;/a&gt;&lt;/small&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  The cases come from every tool's own tests
&lt;/h2&gt;

&lt;p&gt;The cases are compiled from the test suites of Nx, Turborepo, Vite&lt;br&gt;
Task, moon, Nix and vx. A case names no tool's config. It says which&lt;br&gt;
projects exist, what each task runs, and what must hold afterwards.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgV1tzbWFsbCB3b3Jrc3BhY2VdIC0tPiBTW3N0ZXBzOiBlZGl0LCBjb21taXQsIHJ1bl0KICBTIC0tPiBBMVt3aGljaCBjb21tYW5kcyByYW5dCiAgUyAtLT4gQTJbZmlsZXMgbGVmdCBvbiBkaXNrXQogIFMgLS0-IEEzW2V4aXQgY29kZV0KICBTIC0tPiBBNFt3aGF0IHRoZSB0b29sIHJlcG9ydHNdCg%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgV1tzbWFsbCB3b3Jrc3BhY2VdIC0tPiBTW3N0ZXBzOiBlZGl0LCBjb21taXQsIHJ1bl0KICBTIC0tPiBBMVt3aGljaCBjb21tYW5kcyByYW5dCiAgUyAtLT4gQTJbZmlsZXMgbGVmdCBvbiBkaXNrXQogIFMgLS0-IEEzW2V4aXQgY29kZV0KICBTIC0tPiBBNFt3aGF0IHRoZSB0b29sIHJlcG9ydHNdCg%3FbgColor%3Dwhite" alt="diagram" width="572" height="376"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;A thin adapter turns the case into each tool's own config. The harness&lt;br&gt;
marks each command as it starts and ends, so "ran" means it ran.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where the scores split
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Group&lt;/th&gt;
&lt;th&gt;Cases&lt;/th&gt;
&lt;th&gt;vx&lt;/th&gt;
&lt;th&gt;Nx&lt;/th&gt;
&lt;th&gt;Turborepo&lt;/th&gt;
&lt;th&gt;moon&lt;/th&gt;
&lt;th&gt;Vite Task&lt;/th&gt;
&lt;th&gt;Nix&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;graph&lt;/td&gt;
&lt;td&gt;149&lt;/td&gt;
&lt;td&gt;149&lt;/td&gt;
&lt;td&gt;113&lt;/td&gt;
&lt;td&gt;91&lt;/td&gt;
&lt;td&gt;84&lt;/td&gt;
&lt;td&gt;86&lt;/td&gt;
&lt;td&gt;57&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;inputs&lt;/td&gt;
&lt;td&gt;302&lt;/td&gt;
&lt;td&gt;302&lt;/td&gt;
&lt;td&gt;186&lt;/td&gt;
&lt;td&gt;187&lt;/td&gt;
&lt;td&gt;192&lt;/td&gt;
&lt;td&gt;177&lt;/td&gt;
&lt;td&gt;175&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;outputs&lt;/td&gt;
&lt;td&gt;223&lt;/td&gt;
&lt;td&gt;223&lt;/td&gt;
&lt;td&gt;156&lt;/td&gt;
&lt;td&gt;160&lt;/td&gt;
&lt;td&gt;122&lt;/td&gt;
&lt;td&gt;139&lt;/td&gt;
&lt;td&gt;158&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;affected&lt;/td&gt;
&lt;td&gt;97&lt;/td&gt;
&lt;td&gt;97&lt;/td&gt;
&lt;td&gt;57&lt;/td&gt;
&lt;td&gt;68&lt;/td&gt;
&lt;td&gt;69&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;watch&lt;/td&gt;
&lt;td&gt;31&lt;/td&gt;
&lt;td&gt;31&lt;/td&gt;
&lt;td&gt;27&lt;/td&gt;
&lt;td&gt;28&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;sandbox&lt;/td&gt;
&lt;td&gt;18&lt;/td&gt;
&lt;td&gt;18&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;15&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;A case a tool cannot express counts as not passed. Its users cannot get&lt;br&gt;
that behaviour either.&lt;/p&gt;

&lt;h2&gt;
  
  
  Each case says why it matters
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Args forwarded to a server reach it as typed, never expanded by a shell
vx        pass
moon      pass
Nx        fail  seen.txt is "&amp;lt;0&amp;gt;&amp;lt;0&amp;gt;…", expected "&amp;lt;$(id -u)&amp;gt;&amp;lt;`id -u`&amp;gt;…"
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Every case carries three or four sentences on what goes wrong without&lt;br&gt;
it. Here a second shell ran &lt;code&gt;$(id -u)&lt;/code&gt;, a command nobody typed.&lt;/p&gt;

&lt;p&gt;vx misses 2 cases. Both need programs a dependency puts on PATH, which&lt;br&gt;
vx left to the tools you already have.&lt;/p&gt;

&lt;p&gt;All cases, filters and each tool's detail: &lt;a href="https://vznjs.github.io/vx/conformance/" rel="noopener noreferrer"&gt;Conformance&lt;/a&gt;.&lt;br&gt;
More at &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/one-suite-six-task-runners/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>$12k a year saved with vx vs Nx Cloud</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Sun, 08 Nov 2026 00:16:48 +0000</pubDate>
      <link>https://dev.to/vzn-vx/12k-a-year-saved-with-vx-vs-nx-cloud-4mmb</link>
      <guid>https://dev.to/vzn-vx/12k-a-year-saved-with-vx-vs-nx-cloud-4mmb</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Alpha&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;&lt;code&gt;@vzn/vx-dte&lt;/code&gt; and &lt;code&gt;@vzn/vx-dte-server&lt;/code&gt; are alpha. They are open source,&lt;br&gt;
MIT, in &lt;a href="https://github.com/vznjs/vx/tree/main/packages/vx-dte" rel="noopener noreferrer"&gt;the vx&lt;br&gt;
repository&lt;/a&gt;, and&lt;br&gt;
vx's own CI runs on them every push.&lt;/p&gt;

&lt;p&gt;Names and options may still change.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;vx's CI runs on its own GitHub runners, spread by &lt;code&gt;@vzn/vx-dte&lt;/code&gt;. On Nx&lt;br&gt;
Cloud's Team plan with Nx's agents, the same CI would cost about&lt;br&gt;
&lt;strong&gt;$12,192 a year&lt;/strong&gt;. On vx it costs $0.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Scenario&lt;/th&gt;
&lt;th&gt;Nx Cloud Team, Nx's agents&lt;/th&gt;
&lt;th&gt;vx DTE&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;this repository&lt;/td&gt;
&lt;td&gt;$1,016 a month, $12,192 a year&lt;/td&gt;
&lt;td&gt;$0&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;a 20-person team&lt;/td&gt;
&lt;td&gt;$1,902 a month, $22,824 a year&lt;/td&gt;
&lt;td&gt;$0&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;small&gt;This repository: 108 CI runs a day, week to 2026-10-23 · Nx's public prices read 2026-10-23 · Mac work and concurrent connections not counted · the math&lt;/small&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  One run, two minutes, six workers
&lt;/h2&gt;

&lt;p&gt;The first green main as one DTE run&lt;br&gt;
(&lt;a href="https://github.com/vznjs/vx/pull/4119" rel="noopener noreferrer"&gt;#4119&lt;/a&gt;,&lt;br&gt;
&lt;a href="https://github.com/vznjs/vx/actions/runs/39985872848" rel="noopener noreferrer"&gt;49adc41&lt;/a&gt;) took 1&lt;br&gt;
min 59 s, docs deploy included.&lt;/p&gt;

&lt;p&gt;It was three jobs before: Linux, arm64 and macOS.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;What&lt;/th&gt;
&lt;th&gt;Count&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;tasks&lt;/td&gt;
&lt;td&gt;129&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;answered by the local cache&lt;/td&gt;
&lt;td&gt;96&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;downloaded from the remote cache&lt;/td&gt;
&lt;td&gt;8&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;ran on workers&lt;/td&gt;
&lt;td&gt;22&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;workers that ran tasks (4 Linux, 2 Mac)&lt;/td&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;workers started, then cancelled as not needed&lt;/td&gt;
&lt;td&gt;13&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;A Mac or arm worker starts only when the graph has a task for it&lt;br&gt;
(&lt;code&gt;exec.platforms&lt;/code&gt;). Each worker's warm-up and time online:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Worker&lt;/th&gt;
&lt;th&gt;Warm-up&lt;/th&gt;
&lt;th&gt;Online&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;small#1&lt;/td&gt;
&lt;td&gt;19.9 s&lt;/td&gt;
&lt;td&gt;47.3 s&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;small#4&lt;/td&gt;
&lt;td&gt;21.1 s&lt;/td&gt;
&lt;td&gt;58.9 s&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;small#6&lt;/td&gt;
&lt;td&gt;20.3 s&lt;/td&gt;
&lt;td&gt;19.8 s&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;small#8&lt;/td&gt;
&lt;td&gt;19.8 s&lt;/td&gt;
&lt;td&gt;52.8 s&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;mac#17&lt;/td&gt;
&lt;td&gt;37.2 s&lt;/td&gt;
&lt;td&gt;52.5 s&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;mac#19&lt;/td&gt;
&lt;td&gt;31.9 s&lt;/td&gt;
&lt;td&gt;15.4 s&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;
&lt;h2&gt;
  
  
  How the pieces talk
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IFRCCiAgb3JjaFt5b3VyIENJIGpvYjogdnggcnVuLCB0aGUgb3JjaGVzdHJhdG9yXQogIGFwaVtDSSBBUEldCiAgd29ya2Vyc1t5b3VyIENJIGpvYnM6IHZ4IGR0ZSB3b3JrZXIsIG9uZSBwZXIgd29ya2VyXQogIHJlbGF5WyhyZWxheTogb25lIHNvY2tldCBlYWNoLCBub3RoaW5nIHN0b3JlZCldCiAgY2FjaGVbKHlvdXIgcmVtb3RlIGNhY2hlKV0KICBvcmNoIC0tPnxkaXNwYXRjaCwgY2FuY2VsfCBhcGkKICBhcGkgLS0-IHdvcmtlcnMKICBvcmNoIDwtLT58b3JkZXJzIGFuZCBzdGF0dXMsIGVuY3J5cHRlZHwgcmVsYXkKICB3b3JrZXJzIDwtLT58ZW5jcnlwdGVkfCByZWxheQogIHdvcmtlcnMgLS0-fHNhdmUgb3V0cHV0cyBieSBrZXl8IGNhY2hlCiAgY2FjaGUgLS0-fHJlc3RvcmUgYnkga2V5fCBvcmNoCg%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IFRCCiAgb3JjaFt5b3VyIENJIGpvYjogdnggcnVuLCB0aGUgb3JjaGVzdHJhdG9yXQogIGFwaVtDSSBBUEldCiAgd29ya2Vyc1t5b3VyIENJIGpvYnM6IHZ4IGR0ZSB3b3JrZXIsIG9uZSBwZXIgd29ya2VyXQogIHJlbGF5WyhyZWxheTogb25lIHNvY2tldCBlYWNoLCBub3RoaW5nIHN0b3JlZCldCiAgY2FjaGVbKHlvdXIgcmVtb3RlIGNhY2hlKV0KICBvcmNoIC0tPnxkaXNwYXRjaCwgY2FuY2VsfCBhcGkKICBhcGkgLS0-IHdvcmtlcnMKICBvcmNoIDwtLT58b3JkZXJzIGFuZCBzdGF0dXMsIGVuY3J5cHRlZHwgcmVsYXkKICB3b3JrZXJzIDwtLT58ZW5jcnlwdGVkfCByZWxheQogIHdvcmtlcnMgLS0-fHNhdmUgb3V0cHV0cyBieSBrZXl8IGNhY2hlCiAgY2FjaGUgLS0-fHJlc3RvcmUgYnkga2V5fCBvcmNoCg%3FbgColor%3Dwhite" alt="diagram" width="562" height="640"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;The orchestrator&lt;/strong&gt; is your CI job's &lt;code&gt;vx run&lt;/code&gt;. It plans how many
workers the misses need, starts them and hands out tasks. It runs none
itself.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A worker&lt;/strong&gt; is &lt;code&gt;vx dte worker&lt;/code&gt; in a CI job. It runs what it is sent
and saves outputs to your cache under the task's key.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The relay&lt;/strong&gt; passes messages, since CI runners take no inbound
connection. It keeps none: each side numbers its messages and sends one
again until the other acks it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The cache&lt;/strong&gt; carries every file. No file goes through the relay.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Adapters start workers: &lt;code&gt;github()&lt;/code&gt;, &lt;code&gt;gitlab()&lt;/code&gt;, &lt;code&gt;local()&lt;/code&gt; (git&lt;br&gt;
worktrees) and &lt;code&gt;docker()&lt;/code&gt;.&lt;/p&gt;
&lt;h2&gt;
  
  
  The relay stores nothing
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://github.com/vznjs/vx/tree/main/packages/vx-dte-server" rel="noopener noreferrer"&gt;&lt;code&gt;@vzn/vx-dte-server&lt;/code&gt;&lt;/a&gt; depends only on&lt;br&gt;
&lt;a href="https://github.com/panva/jose" rel="noopener noreferrer"&gt;&lt;code&gt;jose&lt;/code&gt;&lt;/a&gt; and speaks&lt;br&gt;
&lt;a href="https://github.com/vznjs/vx/blob/main/packages/vx-dte-server/PROTOCOL.md" rel="noopener noreferrer"&gt;PROTOCOL.md&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;It has one route: a websocket that joins as it opens. It pushes each&lt;br&gt;
message down the receiver's socket and keeps no copy.&lt;/p&gt;

&lt;p&gt;It runs one Durable Object per run on Cloudflare's free plan, or on Bun&lt;br&gt;
in Docker. One var, &lt;code&gt;ALLOW&lt;/code&gt;, lists who may join as&lt;br&gt;
&lt;code&gt;issuer:owner/repo:workflow&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FeHljaGFydC1iZXRhCiAgdGl0bGUgIlJlbGF5IGZyYW1lcywgcXVpZXQgcnVuLCA0IHNvY2tldHMsIDEwIGhlYXJ0YmVhdHMiCiAgeC1heGlzIFsicmVsYXkgcGluZ3MgZXZlcnkgc29ja2V0IiwgInBlZXJzIHByb2JlIG9ubHkgdGhlIHF1aWV0Il0KICB5LWF4aXMgImZyYW1lcyIgMCAtLT4gMTAwCiAgYmFyIFs5MiwgNjBdCg%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FeHljaGFydC1iZXRhCiAgdGl0bGUgIlJlbGF5IGZyYW1lcywgcXVpZXQgcnVuLCA0IHNvY2tldHMsIDEwIGhlYXJ0YmVhdHMiCiAgeC1heGlzIFsicmVsYXkgcGluZ3MgZXZlcnkgc29ja2V0IiwgInBlZXJzIHByb2JlIG9ubHkgdGhlIHF1aWV0Il0KICB5LWF4aXMgImZyYW1lcyIgMCAtLT4gMTAwCiAgYmFyIFs5MiwgNjBdCg%3FbgColor%3Dwhite" alt="diagram" width="700" height="500"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;small&gt;1 orchestrator and 3 idle workers · before: 88-96 frames, 44-48 each way · after: 24 up, 36 down (&lt;a href="https://github.com/vznjs/vx/pull/4309" rel="noopener noreferrer"&gt;#4309&lt;/a&gt;) · each participant joins with one request; Workers bills 20 websocket messages as one request, and the relay writes no storage row (&lt;a href="https://developers.cloudflare.com/durable-objects/platform/pricing/" rel="noopener noreferrer"&gt;pricing&lt;/a&gt;, read 2026-10-23) · &lt;a href="https://vznjs.github.io/vx/blog/relay-stores-nothing/" rel="noopener noreferrer"&gt;how it works&lt;/a&gt;&lt;/small&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  The relay reads nothing it carries
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2Fc2VxdWVuY2VEaWFncmFtCiAgcGFydGljaXBhbnQgVyBhcyB3b3JrZXIKICBwYXJ0aWNpcGFudCBSIGFzIHJlbGF5CiAgcGFydGljaXBhbnQgTyBhcyBvcmNoZXN0cmF0b3IKICBXLT4-Ujogb3BlbiBzb2NrZXQsIGpvaW4gKENJIE9JREMgdG9rZW4pCiAgUi0-Pk86IGEgd29ya2VyIGpvaW5lZAogIFctPj5SOiBOb2lzZSBtZXNzYWdlIDE6IGUgKHBzayksIGpvaW4gaW5mbyBlbmNyeXB0ZWQKICBSLT4-TzogbWVzc2FnZSAxCiAgTy0-PlI6IE5vaXNlIG1lc3NhZ2UgMjogZSwgZWUKICBSLT4-VzogbWVzc2FnZSAyCiAgTm90ZSBvdmVyIFcsTzogdHJhbnNwb3J0IGtleXMgZXhpc3Qgb25seSBvbiBXIGFuZCBPCiAgTy0-PlI6IG9yZGVyICh0YXNrLCBrZXlzLCBlbnYpLCBlbmNyeXB0ZWQKICBSLT4-Vzogb3JkZXIKICBXLT4-UjogYmVndW4sIHJhbiwgc2F2ZWQsIGVuY3J5cHRlZAogIFItPj5POiBzdGF0dXMK%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2Fc2VxdWVuY2VEaWFncmFtCiAgcGFydGljaXBhbnQgVyBhcyB3b3JrZXIKICBwYXJ0aWNpcGFudCBSIGFzIHJlbGF5CiAgcGFydGljaXBhbnQgTyBhcyBvcmNoZXN0cmF0b3IKICBXLT4-Ujogb3BlbiBzb2NrZXQsIGpvaW4gKENJIE9JREMgdG9rZW4pCiAgUi0-Pk86IGEgd29ya2VyIGpvaW5lZAogIFctPj5SOiBOb2lzZSBtZXNzYWdlIDE6IGUgKHBzayksIGpvaW4gaW5mbyBlbmNyeXB0ZWQKICBSLT4-TzogbWVzc2FnZSAxCiAgTy0-PlI6IE5vaXNlIG1lc3NhZ2UgMjogZSwgZWUKICBSLT4-VzogbWVzc2FnZSAyCiAgTm90ZSBvdmVyIFcsTzogdHJhbnNwb3J0IGtleXMgZXhpc3Qgb25seSBvbiBXIGFuZCBPCiAgTy0-PlI6IG9yZGVyICh0YXNrLCBrZXlzLCBlbnYpLCBlbmNyeXB0ZWQKICBSLT4-Vzogb3JkZXIKICBXLT4-UjogYmVndW4sIHJhbiwgc2F2ZWQsIGVuY3J5cHRlZAogIFItPj5POiBzdGF0dXMK%3FbgColor%3Dwhite" alt="diagram" width="894" height="722"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Each worker runs a &lt;a href="https://noiseprotocol.org/noise.html" rel="noopener noreferrer"&gt;Noise&lt;/a&gt;&lt;br&gt;
handshake with the orchestrator, on WebCrypto, checked against the&lt;br&gt;
cacophony vectors (&lt;code&gt;packages/vx-dte/src/noise.ts&lt;/code&gt;).&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;With a run key (&lt;code&gt;VX_DTE_SECRET&lt;/code&gt;) it is
&lt;code&gt;Noise_NNpsk0_25519_AESGCM_SHA256&lt;/code&gt;. On GitHub Actions with no key it is
&lt;code&gt;Noise_NN_25519_AESGCM_SHA256&lt;/code&gt;, bound by OIDC tokens of the same repo.&lt;/li&gt;
&lt;li&gt;Keys are ephemeral, so a leaked run key opens no past run.&lt;/li&gt;
&lt;li&gt;Each task gets only the env its config passes, encrypted.&lt;/li&gt;
&lt;li&gt;Workers borrow the orchestrator's short-lived cache token. Nothing is
stored.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;
  
  
  How a run schedules
&lt;/h2&gt;

&lt;p&gt;Only misses need workers. A run the cache answers whole starts none.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;How many workers:&lt;/strong&gt; the planner (&lt;code&gt;packages/vx-dte/src/planner.ts&lt;/code&gt;)
starts a worker only when a task would otherwise miss the best end.
Tasks with slack wait for room on workers already running. Idle
workers leave.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Where a task goes:&lt;/strong&gt; to a worker with room, holding most of its
dependencies' outputs, then the fullest one.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Which first:&lt;/strong&gt; the longest tail of recorded time.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;What it books:&lt;/strong&gt; the cores and memory its history used. No history
gets one free core.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Each is a layer you swap with &lt;code&gt;dte({ scheduler })&lt;/code&gt;&lt;br&gt;
(&lt;code&gt;packages/vx-dte/src/strategy.ts&lt;/code&gt;):&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Layer&lt;/th&gt;
&lt;th&gt;Choices (default first)&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;order&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;critical-path&lt;/code&gt; (HEFT's rank), &lt;code&gt;graphene&lt;/code&gt; (long and wide first, Grandl OSDI'16), &lt;code&gt;fifo&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;place&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;best-fit&lt;/code&gt; (fewest cores left), &lt;code&gt;tetris&lt;/code&gt; (needs aligned with what is free, SIGCOMM'14), &lt;code&gt;worst-fit&lt;/code&gt;, &lt;code&gt;first-fit&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;book&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;measured&lt;/code&gt; (history), &lt;code&gt;margin&lt;/code&gt; (a fifth more, as Borg does), &lt;code&gt;whole&lt;/code&gt; (a worker each)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;scale&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;plan&lt;/code&gt; (the planner above), &lt;code&gt;backlog&lt;/code&gt; (cores for what is ready or running, as Spark's dynamic allocation)&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;
&lt;h2&gt;
  
  
  The simulator matches real runs
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;packages/vx-dte/tests/sim.ts&lt;/code&gt; plays a run on a virtual clock with the&lt;br&gt;
plugin's own code, so minutes play in milliseconds.&lt;/p&gt;

&lt;p&gt;Main's run at&lt;br&gt;
&lt;a href="https://github.com/vznjs/vx/actions/runs/40014645919" rel="noopener noreferrer"&gt;c5d8353&lt;/a&gt;, with&lt;br&gt;
each task's measured time, CPU and memory:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;c5d8353&lt;/th&gt;
&lt;th&gt;Real&lt;/th&gt;
&lt;th&gt;Simulated&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;run end&lt;/td&gt;
&lt;td&gt;113.8 s&lt;/td&gt;
&lt;td&gt;112.7 s&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;CPU used&lt;/td&gt;
&lt;td&gt;53%&lt;/td&gt;
&lt;td&gt;56%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;workers&lt;/td&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;cancelled workers&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Every strategy on main's a09b987 run (65 misses, 4-core workers, 20 s&lt;br&gt;
warm-up). The best end on unlimited workers is 120.5 s:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Strategy&lt;/th&gt;
&lt;th&gt;Simulated end&lt;/th&gt;
&lt;th&gt;Workers&lt;/th&gt;
&lt;th&gt;Utilization&lt;/th&gt;
&lt;th&gt;Worker time&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;default&lt;/td&gt;
&lt;td&gt;120.5 s&lt;/td&gt;
&lt;td&gt;10&lt;/td&gt;
&lt;td&gt;86%&lt;/td&gt;
&lt;td&gt;13.1 min&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;order: graphene&lt;/td&gt;
&lt;td&gt;120.5 s&lt;/td&gt;
&lt;td&gt;10&lt;/td&gt;
&lt;td&gt;89%&lt;/td&gt;
&lt;td&gt;12.7 min&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;order: fifo&lt;/td&gt;
&lt;td&gt;120.5 s&lt;/td&gt;
&lt;td&gt;10&lt;/td&gt;
&lt;td&gt;76%&lt;/td&gt;
&lt;td&gt;14.8 min&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;place: tetris&lt;/td&gt;
&lt;td&gt;120.5 s&lt;/td&gt;
&lt;td&gt;10&lt;/td&gt;
&lt;td&gt;77%&lt;/td&gt;
&lt;td&gt;14.6 min&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;place: worst-fit&lt;/td&gt;
&lt;td&gt;120.5 s&lt;/td&gt;
&lt;td&gt;10&lt;/td&gt;
&lt;td&gt;77%&lt;/td&gt;
&lt;td&gt;14.6 min&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;place: first-fit&lt;/td&gt;
&lt;td&gt;120.5 s&lt;/td&gt;
&lt;td&gt;10&lt;/td&gt;
&lt;td&gt;86%&lt;/td&gt;
&lt;td&gt;13.1 min&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;book: margin&lt;/td&gt;
&lt;td&gt;120.5 s&lt;/td&gt;
&lt;td&gt;12&lt;/td&gt;
&lt;td&gt;69%&lt;/td&gt;
&lt;td&gt;16.2 min&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;book: whole&lt;/td&gt;
&lt;td&gt;348.9 s&lt;/td&gt;
&lt;td&gt;11&lt;/td&gt;
&lt;td&gt;19%&lt;/td&gt;
&lt;td&gt;58.9 min&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;scale: backlog&lt;/td&gt;
&lt;td&gt;120.5 s&lt;/td&gt;
&lt;td&gt;12&lt;/td&gt;
&lt;td&gt;86%&lt;/td&gt;
&lt;td&gt;13.1 min&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;bun &lt;span class="nb"&gt;test&lt;/span&gt; packages/vx-dte/tests/sim.test.ts
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h2&gt;
  
  
  Other ways to split a run
&lt;/h2&gt;

&lt;p&gt;Five ways, on 4 vCPU machines that take 20 s to start:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;One machine:&lt;/strong&gt; every task on one job.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Static matrix:&lt;/strong&gt; N YAML jobs, each a fixed share, tuned once.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Build stage, then a matrix:&lt;/strong&gt; one job builds, N jobs split the rest.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Naive DTE:&lt;/strong&gt; N workers up front, one task each, all stay to the end.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;vx DTE:&lt;/strong&gt; the default above.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;small&gt;Machine time is billed 4 vCPU minutes, warm-up included; the 1 vCPU orchestrator counts a quarter · CPU used is work over billed cores · every way but vx DTE played by the ideal packer, vx DTE by the full simulator · &lt;code&gt;bun packages/vx-dte/scripts/compare.ts&lt;/code&gt;&lt;/small&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;vx's main run, a09b987.&lt;/strong&gt; 65 tasks, 45.0 core-minutes, a flat graph.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Way&lt;/th&gt;
&lt;th&gt;Ends&lt;/th&gt;
&lt;th&gt;Machine time&lt;/th&gt;
&lt;th&gt;CPU used&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;One machine&lt;/td&gt;
&lt;td&gt;751.0 s&lt;/td&gt;
&lt;td&gt;12.5 min&lt;/td&gt;
&lt;td&gt;90%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Static matrix, 10 jobs&lt;/td&gt;
&lt;td&gt;126.0 s&lt;/td&gt;
&lt;td&gt;18.3 min&lt;/td&gt;
&lt;td&gt;62%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Build stage, then 10 jobs&lt;/td&gt;
&lt;td&gt;190.0 s&lt;/td&gt;
&lt;td&gt;18.6 min&lt;/td&gt;
&lt;td&gt;60%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Naive DTE, 10 workers&lt;/td&gt;
&lt;td&gt;392.8 s&lt;/td&gt;
&lt;td&gt;67.1 min&lt;/td&gt;
&lt;td&gt;17%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;vx DTE, 10 workers&lt;/td&gt;
&lt;td&gt;120.5 s&lt;/td&gt;
&lt;td&gt;16.9 min&lt;/td&gt;
&lt;td&gt;67%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;strong&gt;A vx PR.&lt;/strong&gt; 16 tasks, 9.2 core-minutes. A bar is a task, as tall as&lt;br&gt;
its cores. Orange is warm-up, grey is billed and idle.&lt;/p&gt;
A vx PR, as it runs

&lt;span&gt;One machine&lt;/span&gt;&lt;span&gt;189.9 s · 3.2 min&lt;/span&gt;&lt;span&gt;Static matrix, 10 jobs&lt;/span&gt;&lt;span&gt;90.1 s · 13.2 min&lt;/span&gt;&lt;span&gt;Build stage, then 10 jobs&lt;/span&gt;&lt;span&gt;110.1 s · 13.6 min&lt;/span&gt;&lt;span&gt;Naive DTE, 10 workers&lt;/span&gt;&lt;span&gt;120.2 s · 20.5 min&lt;/span&gt;&lt;span&gt;vx DTE, 3 workers&lt;/span&gt;&lt;span&gt;90.1 s · 4.4 min&lt;/span&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Way&lt;/th&gt;
&lt;th&gt;Ends&lt;/th&gt;
&lt;th&gt;Machine time&lt;/th&gt;
&lt;th&gt;CPU used&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;One machine&lt;/td&gt;
&lt;td&gt;189.9 s&lt;/td&gt;
&lt;td&gt;3.2 min&lt;/td&gt;
&lt;td&gt;73%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Static matrix, 10 jobs&lt;/td&gt;
&lt;td&gt;90.1 s&lt;/td&gt;
&lt;td&gt;13.2 min&lt;/td&gt;
&lt;td&gt;17%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Build stage, then 10 jobs&lt;/td&gt;
&lt;td&gt;110.1 s&lt;/td&gt;
&lt;td&gt;13.6 min&lt;/td&gt;
&lt;td&gt;17%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Naive DTE, 10 workers&lt;/td&gt;
&lt;td&gt;120.2 s&lt;/td&gt;
&lt;td&gt;20.5 min&lt;/td&gt;
&lt;td&gt;11%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;vx DTE, 3 workers&lt;/td&gt;
&lt;td&gt;90.1 s&lt;/td&gt;
&lt;td&gt;4.4 min&lt;/td&gt;
&lt;td&gt;53%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;strong&gt;An app monorepo after a base library change.&lt;/strong&gt; 24 chained libraries,&lt;br&gt;
4 apps, 84 tasks, 71.0 core-minutes.&lt;/p&gt;
The app monorepo after a base library change, as it runs

&lt;span&gt;One machine&lt;/span&gt;&lt;span&gt;1205.0 s · 20.1 min&lt;/span&gt;&lt;span&gt;Static matrix, 6 jobs&lt;/span&gt;&lt;span&gt;810.0 s · 73.1 min&lt;/span&gt;&lt;span&gt;Build stage, then 6 jobs&lt;/span&gt;&lt;span&gt;1060.0 s · 27.3 min&lt;/span&gt;&lt;span&gt;Naive DTE, 6 workers&lt;/span&gt;&lt;span&gt;765.0 s · 79.7 min&lt;/span&gt;&lt;span&gt;vx DTE, 6 workers&lt;/span&gt;&lt;span&gt;720.0 s · 34.7 min&lt;/span&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Way&lt;/th&gt;
&lt;th&gt;Ends&lt;/th&gt;
&lt;th&gt;Machine time&lt;/th&gt;
&lt;th&gt;CPU used&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;One machine&lt;/td&gt;
&lt;td&gt;1205.0 s&lt;/td&gt;
&lt;td&gt;20.1 min&lt;/td&gt;
&lt;td&gt;88%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Static matrix, 6 jobs&lt;/td&gt;
&lt;td&gt;810.0 s&lt;/td&gt;
&lt;td&gt;73.1 min&lt;/td&gt;
&lt;td&gt;24%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Build stage, then 6 jobs&lt;/td&gt;
&lt;td&gt;1060.0 s&lt;/td&gt;
&lt;td&gt;27.3 min&lt;/td&gt;
&lt;td&gt;65%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Naive DTE, 6 workers&lt;/td&gt;
&lt;td&gt;765.0 s&lt;/td&gt;
&lt;td&gt;79.7 min&lt;/td&gt;
&lt;td&gt;22%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;vx DTE, 6 workers&lt;/td&gt;
&lt;td&gt;720.0 s&lt;/td&gt;
&lt;td&gt;34.7 min&lt;/td&gt;
&lt;td&gt;51%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;strong&gt;The same monorepo, one app changed.&lt;/strong&gt; 3 tasks, 9.3 core-minutes.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Way&lt;/th&gt;
&lt;th&gt;Ends&lt;/th&gt;
&lt;th&gt;Machine time&lt;/th&gt;
&lt;th&gt;CPU used&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;One machine&lt;/td&gt;
&lt;td&gt;260.0 s&lt;/td&gt;
&lt;td&gt;4.3 min&lt;/td&gt;
&lt;td&gt;53%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Static matrix, 6 jobs&lt;/td&gt;
&lt;td&gt;260.0 s&lt;/td&gt;
&lt;td&gt;10.0 min&lt;/td&gt;
&lt;td&gt;23%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Build stage, then 6 jobs&lt;/td&gt;
&lt;td&gt;280.0 s&lt;/td&gt;
&lt;td&gt;7.3 min&lt;/td&gt;
&lt;td&gt;32%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Naive DTE, 6 workers&lt;/td&gt;
&lt;td&gt;260.0 s&lt;/td&gt;
&lt;td&gt;27.1 min&lt;/td&gt;
&lt;td&gt;9%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;vx DTE, 1 worker&lt;/td&gt;
&lt;td&gt;260.0 s&lt;/td&gt;
&lt;td&gt;5.4 min&lt;/td&gt;
&lt;td&gt;43%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;One machine&lt;/strong&gt; bills least and ends last when there is work to spread.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A static matrix&lt;/strong&gt; fits the graph it was tuned for. On a PR all 10
jobs still start: 13.2 machine-minutes against 4.4.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A build stage&lt;/strong&gt; makes every test wait for the slowest build.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Naive DTE&lt;/strong&gt; keeps every worker to the end: 17% CPU on main.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;vx DTE&lt;/strong&gt; ends first or level in all four. One machine bills less
when one task sets the end.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;
  
  
  What it costs, next to Nx Cloud
&lt;/h2&gt;

&lt;p&gt;Nx Cloud is the closest product. Since 2026-10-22 its &lt;a href="https://nx.dev/blog/dynamic-task-packing-ultracache" rel="noopener noreferrer"&gt;dynamic task&lt;br&gt;
packing&lt;/a&gt; packs&lt;br&gt;
tasks by measured CPU and memory, as vx DTE does.&lt;/p&gt;

&lt;p&gt;The difference is where it runs and what it costs. Running Nx Cloud&lt;br&gt;
yourself is its Enterprise plan, at a custom price.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Item&lt;/th&gt;
&lt;th&gt;Nx Cloud&lt;/th&gt;
&lt;th&gt;vx DTE&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Hobby plan&lt;/td&gt;
&lt;td&gt;free, 50,000 credits a month, 5 contributors, 10 concurrent CI connections; features turn off when credits run out&lt;/td&gt;
&lt;td&gt;—&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Team plan&lt;/td&gt;
&lt;td&gt;$29 a month, $29 of usage included&lt;/td&gt;
&lt;td&gt;—&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Extra credits&lt;/td&gt;
&lt;td&gt;$5.50 per 10,000&lt;/td&gt;
&lt;td&gt;—&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Each CI pipeline execution&lt;/td&gt;
&lt;td&gt;500 credits&lt;/td&gt;
&lt;td&gt;nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Contributors beyond 5&lt;/td&gt;
&lt;td&gt;$19 each&lt;/td&gt;
&lt;td&gt;nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Concurrent CI connections beyond 10&lt;/td&gt;
&lt;td&gt;$2.25 each&lt;/td&gt;
&lt;td&gt;nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Its agents, Linux x64&lt;/td&gt;
&lt;td&gt;5 credits/min per vCPU (4 vCPU: 20)&lt;/td&gt;
&lt;td&gt;your CI's own runners&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Its agents, Linux arm64&lt;/td&gt;
&lt;td&gt;26 credits/min for 4 vCPU&lt;/td&gt;
&lt;td&gt;your CI's own runners&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Its agents, macOS&lt;/td&gt;
&lt;td&gt;no resource class listed&lt;/td&gt;
&lt;td&gt;your CI's own runners&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Self-hosted&lt;/td&gt;
&lt;td&gt;Enterprise plan, custom price&lt;/td&gt;
&lt;td&gt;every plan there is: MIT, all of it&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;small&gt;Read 2026-10-23 from &lt;a href="https://nx.dev/pricing" rel="noopener noreferrer"&gt;nx.dev/pricing&lt;/a&gt;, &lt;a href="https://nx.dev/docs/reference/nx-cloud/credits-pricing" rel="noopener noreferrer"&gt;Credit Pricing&lt;/a&gt;, &lt;a href="https://nx.dev/docs/features/ci-features#what-happens-when-i-use-up-my-credits" rel="noopener noreferrer"&gt;CI with Nx Cloud&lt;/a&gt; · 30-day months, Team plan, a 4 vCPU agent per worker, reports off, Mac work, concurrent connections and taxes not counted · the $29 fee buys $29 of usage&lt;/small&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FcGllIHNob3dEYXRhCiAgdGl0bGUgIlRoaXMgcmVwb3NpdG9yeSdzIENJIHJ1bnMsIDcgZGF5cyB0byAyMDI2LTEwLTIzIgogICJQUiIgOiA0NTEKICAibWFpbiIgOiAzMDQKICAibWFudWFsIiA6IDUK%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FcGllIHNob3dEYXRhCiAgdGl0bGUgIlRoaXMgcmVwb3NpdG9yeSdzIENJIHJ1bnMsIDcgZGF5cyB0byAyMDI2LTEwLTIzIgogICJQUiIgOiA0NTEKICAibWFpbiIgOiAzMDQKICAibWFudWFsIiA6IDUK%3FbgColor%3Dwhite" alt="diagram" width="635" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;This repository:&lt;/strong&gt; 760 runs in a week (GitHub's API, cancelled not&lt;br&gt;
counted), 3,257 a month. From the 54 runs after&lt;br&gt;
&lt;a href="https://github.com/vznjs/vx/pull/4150" rel="noopener noreferrer"&gt;#4150&lt;/a&gt;, a PR run kept Linux&lt;br&gt;
workers online 4.2 minutes on average, a main run 2.1.&lt;/p&gt;

&lt;p&gt;That is 567 credits a run with the 500 per execution: 1,846,529 a month,&lt;br&gt;
$1,016. The Hobby plan's 50,000 credits last 88 runs (&lt;a href="https://github.com/vznjs/vx/pull/4167" rel="noopener noreferrer"&gt;per-run&lt;br&gt;
numbers&lt;/a&gt;).&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;A 20-person team&lt;/strong&gt;, a made-up case: 200 executions a working day, 21&lt;br&gt;
days, 10 agent minutes each. 2,940,000 credits is $1,617, plus 15 seats&lt;br&gt;
at $19. $1,902 a month.&lt;/p&gt;

&lt;p&gt;vx DTE has no plan, credits or seats. Its compute is the CI minutes your&lt;br&gt;
runners already bill.&lt;/p&gt;
&lt;h2&gt;
  
  
  Try it
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;bun add -d @vzn/vx-dte&lt;/code&gt;, and host a relay&lt;br&gt;
(&lt;a href="https://github.com/vznjs/vx/tree/main/packages/vx-dte-server#run-it" rel="noopener noreferrer"&gt;README&lt;/a&gt;):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// in .vx/workspace.ts's plugins&lt;/span&gt;
&lt;span class="nf"&gt;dte&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;relay&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'https://relay.example.com'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;workers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;linux&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;machines&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;small&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;max&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;8&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;cpu&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;memory&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'16GB'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;adapter&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;github&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The run's job needs &lt;code&gt;id-token: write&lt;/code&gt; and &lt;code&gt;actions: write&lt;/code&gt;, and a&lt;br&gt;
&lt;code&gt;vx-worker.yml&lt;/code&gt; whose jobs run &lt;code&gt;bunx @vzn/vx dte worker&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;The &lt;a href="https://github.com/vznjs/vx/tree/main/packages/vx-dte#on-github" rel="noopener noreferrer"&gt;package README&lt;/a&gt; has both workflows, GitLab's pipeline&lt;br&gt;
and every option. vx's own are &lt;a href="https://github.com/vznjs/vx/blob/main/.github/workflows/ci.yml" rel="noopener noreferrer"&gt;ci.yml&lt;/a&gt; and&lt;br&gt;
&lt;a href="https://github.com/vznjs/vx/blob/main/.github/workflows/vx-worker.yml" rel="noopener noreferrer"&gt;vx-worker.yml&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;More at &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/one-run-on-your-own-runners/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>A sandboxed task reads what it depends on, and nothing beside it</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Sun, 08 Nov 2026 00:16:44 +0000</pubDate>
      <link>https://dev.to/vzn-vx/a-sandboxed-task-reads-what-it-depends-on-and-nothing-beside-it-1d1j</link>
      <guid>https://dev.to/vzn-vx/a-sandboxed-task-reads-what-it-depends-on-and-nothing-beside-it-1d1j</guid>
      <description>&lt;p&gt;One project builds a tool, every other project runs it, and each stays&lt;br&gt;
in its sandbox. The tool's sources stay hidden.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgU1t0b29scy9zcmNdIC0tPnx0b29scyNidWlsZHwgT1t0b29scy9vdXRdCiAgTyAtLT58cmVhZGFibGV8IEFbYXBwI2J1aWxkLCBzYW5kYm94ZWRdCiAgUyAtLi0-fGhpZGRlbnwgQQo%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgU1t0b29scy9zcmNdIC0tPnx0b29scyNidWlsZHwgT1t0b29scy9vdXRdCiAgTyAtLT58cmVhZGFibGV8IEFbYXBwI2J1aWxkLCBzYW5kYm94ZWRdCiAgUyAtLi0-fGhpZGRlbnwgQQo%3FbgColor%3Dwhite" alt="diagram" width="771" height="128"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  Depend on a task, read its outputs
&lt;/h2&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="nx"&gt;build&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;dependsOn&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;packages/tools#build&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
  &lt;span class="nx"&gt;exec&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nl"&gt;command&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;cat ../tools/out/bin/greet ../tools/src/greet.sh &amp;gt; greeting.txt&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nx"&gt;sandbox&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;allow&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;read&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;.&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="na"&gt;write&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;greeting.txt&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="nx"&gt;inputs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;files&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;src/**&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="nx"&gt;outputs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;files&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;greeting.txt&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="nx"&gt;cache&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;The output reads fine. The source does not exist for this task:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;┌─ packages/app#build &amp;gt; failed (exit 1)

$ cat ../tools/out/bin/greet ../tools/src/greet.sh &amp;gt; greeting.txt

├─ OUTPUT ────────────────────────────────────────────────────

cat: ../tools/src/greet.sh: No such file or directory

├─ SANDBOX ───────────────────────────────────────────────────

vx: the sandbox hid paths outside the project that exist on this machine, which are not reported as violations: /work/demo/packages/tools/src/greet.sh. If the task reads one, grant it, e.g. `allow: { read: ['../tools/src/greet.sh'] }`.

└─ packages/app#build ── (59ms) failed (exit 1)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;small&gt;Demo workspace · Linux, bubblewrap · vx 18d0a91 · 2026-11-07&lt;/small&gt;&lt;/p&gt;

&lt;p&gt;The outputs are safe to read. The task's key already moves with every&lt;br&gt;
file that made them, so a cache hit never hides a changed tool.&lt;/p&gt;
&lt;h2&gt;
  
  
  hermetic: true closes off the machine too
&lt;/h2&gt;

&lt;p&gt;A plain sandbox walls off the workspace. &lt;code&gt;hermetic: true&lt;/code&gt; moves that&lt;br&gt;
wall to &lt;code&gt;/&lt;/code&gt;. The task reads only what you grant, plus the shell vx needs.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;┌─ packages/app#build &amp;gt; failed (exit 127)

$ cat ../tools/src/greet.sh &amp;gt; greeting.txt

├─ OUTPUT ────────────────────────────────────────────────────

/usr/bin/sh: 1: cat: not found
[vx] exit 127 is the shell's "command not found": cat is /usr/bin/cat on the host, but no sandbox grant reads it, so inside the sandbox it is not there — add it (or its directory) to exec.sandbox.allow.read

└─ packages/app#build ── (124ms) failed (exit 127)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The task reached for the host's &lt;code&gt;cat&lt;/code&gt; and found nothing. vx names the&lt;br&gt;
host path and the grant that would fix it. A build cannot lean on a tool&lt;br&gt;
that only your laptop has.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Sandbox&lt;/th&gt;
&lt;th&gt;Workspace&lt;/th&gt;
&lt;th&gt;Rest of the machine&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;none&lt;/td&gt;
&lt;td&gt;everything&lt;/td&gt;
&lt;td&gt;everything&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;sandbox: {...}&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;what you grant&lt;/td&gt;
&lt;td&gt;readable&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;hermetic: true&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;what you grant&lt;/td&gt;
&lt;td&gt;what you grant&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;How to grant reads: &lt;a href="https://vznjs.github.io/vx/docs/sandboxing/" rel="noopener noreferrer"&gt;Sandboxing&lt;/a&gt;.&lt;br&gt;
More at &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/a-task-reads-what-it-depends-on/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>Branch caches a server enforces</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Wed, 21 Oct 2026 18:19:30 +0000</pubDate>
      <link>https://dev.to/vzn-vx/branch-caches-a-server-enforces-5ejf</link>
      <guid>https://dev.to/vzn-vx/branch-caches-a-server-enforces-5ejf</guid>
      <description>&lt;p&gt;A pull request reuses everything &lt;code&gt;main&lt;/code&gt; built. Nothing it builds can&lt;br&gt;
land in &lt;code&gt;main&lt;/code&gt;'s cache, so one bad build cannot poison the next run.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2Fc2VxdWVuY2VEaWFncmFtCiAgcGFydGljaXBhbnQgUFIgYXMgUFIgcnVuIChmZWF0LXgpCiAgcGFydGljaXBhbnQgUyBhcyBjYWNoZSBzZXJ2ZXIKICBQUi0-PlM6IHJlYWQsIHNjb3BlczogZmVhdC14LCB0aGVuIG1haW4KICBTLS0-PlBSOiBmaXJzdCBoaXQKICBQUi0-PlM6IHdyaXRlLCB3aXRoIENJJ3Mgc2lnbmVkIE9JREMgdG9rZW4KICBTLT4-UzogdG9rZW4gc2F5cyBmZWF0LXgsIHN0b3JlIGluIGZlYXQteCBvbmx5Cg%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2Fc2VxdWVuY2VEaWFncmFtCiAgcGFydGljaXBhbnQgUFIgYXMgUFIgcnVuIChmZWF0LXgpCiAgcGFydGljaXBhbnQgUyBhcyBjYWNoZSBzZXJ2ZXIKICBQUi0-PlM6IHJlYWQsIHNjb3BlczogZmVhdC14LCB0aGVuIG1haW4KICBTLS0-PlBSOiBmaXJzdCBoaXQKICBQUi0-PlM6IHdyaXRlLCB3aXRoIENJJ3Mgc2lnbmVkIE9JREMgdG9rZW4KICBTLT4-UzogdG9rZW4gc2F5cyBmZWF0LXgsIHN0b3JlIGluIGZlYXQteCBvbmx5Cg%3FbgColor%3Dwhite" alt="diagram" width="592" height="383"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Decision&lt;/th&gt;
&lt;th&gt;Who makes it&lt;/th&gt;
&lt;th&gt;From what&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Where a write lands&lt;/td&gt;
&lt;td&gt;the server&lt;/td&gt;
&lt;td&gt;the CI's signed OIDC token&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Which branches a read sees&lt;/td&gt;
&lt;td&gt;the client&lt;/td&gt;
&lt;td&gt;one header, own branch first, then &lt;code&gt;main&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;
&lt;h2&gt;
  
  
  The token decides writes
&lt;/h2&gt;

&lt;p&gt;The server checks the CI's signed OIDC token against its trust policy. A&lt;br&gt;
matching token writes the trusted cache. Any other token from the repo&lt;br&gt;
writes only its own branch. No token writes nothing.&lt;/p&gt;

&lt;p&gt;No header or key can change that.&lt;/p&gt;
&lt;h2&gt;
  
  
  One header steers reads
&lt;/h2&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight http"&gt;&lt;code&gt;&lt;span class="err"&gt;HEAD /v8/artifacts/0a1b2c3d4e5f6789
x-artifact-read-scopes: refs/heads/feat-x, refs/heads/main
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;The server returns the first hit in that order. Keys are the same on&lt;br&gt;
every branch, so a hit on &lt;code&gt;main&lt;/code&gt; is the bytes &lt;code&gt;feat-x&lt;/code&gt; would have built.&lt;br&gt;
A server that ignores the header keeps one shared cache.&lt;/p&gt;

&lt;p&gt;CI refs come from env (&lt;code&gt;GITHUB_HEAD_REF&lt;/code&gt; or &lt;code&gt;GITHUB_REF&lt;/code&gt;, then&lt;br&gt;
&lt;code&gt;GITHUB_BASE_REF&lt;/code&gt;; &lt;code&gt;CI_COMMIT_REF_NAME&lt;/code&gt;, then&lt;br&gt;
&lt;code&gt;CI_MERGE_REQUEST_TARGET_BRANCH_NAME&lt;/code&gt;).&lt;/p&gt;

&lt;p&gt;On a laptop they come from git: the current branch, then &lt;code&gt;origin/HEAD&lt;/code&gt;.&lt;/p&gt;
&lt;h2&gt;
  
  
  Two client modes
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;code&gt;scope&lt;/code&gt;&lt;/th&gt;
&lt;th&gt;Key&lt;/th&gt;
&lt;th&gt;Read request&lt;/th&gt;
&lt;th&gt;For&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;'header'&lt;/code&gt; (default)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;hash(inputs)&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;plain key + &lt;code&gt;x-artifact-read-scopes&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;servers that implement the rules below&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;'key'&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;hash(inputs + ref)&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;one batch with each ref's key, first hit wins&lt;/td&gt;
&lt;td&gt;servers that ignore the header (Vercel)&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// .vx/workspace.ts&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;defineWorkspace&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;@vzn/vx/config&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;turboCache&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;@vzn/vx-migrate&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="nf"&gt;defineWorkspace&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;plugins&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nf"&gt;turboCache&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;scope&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;key&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;})],&lt;/span&gt; &lt;span class="c1"&gt;// a server that ignores the header&lt;/span&gt;
&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// .vx/workspace.ts&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;defineWorkspace&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;@vzn/vx/config&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;turboCache&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;@vzn/vx-migrate&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="nf"&gt;defineWorkspace&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;plugins&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nf"&gt;turboCache&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;scope&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;key&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;})],&lt;/span&gt; &lt;span class="c1"&gt;// a server that ignores the header&lt;/span&gt;
&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;&lt;code&gt;'key'&lt;/code&gt; separates branches but secures nothing: anyone can compute&lt;br&gt;
&lt;code&gt;main&lt;/code&gt;'s key. Only a server can enforce, so &lt;code&gt;'header'&lt;/code&gt; is the default.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;nxCache()&lt;/code&gt; sends plain requests, since the Nx spec has no batch query.&lt;/p&gt;
&lt;h2&gt;
  
  
  Building the server half
&lt;/h2&gt;

&lt;p&gt;Everything below is the Turbo artifacts API (&lt;code&gt;/v8/artifacts&lt;/code&gt;) plus one&lt;br&gt;
header.&lt;/p&gt;
&lt;h3&gt;
  
  
  Server config
&lt;/h3&gt;

&lt;p&gt;vx's own &lt;a href="https://vznjs.github.io/vx/docs/servers/cache/" rel="noopener noreferrer"&gt;cache server&lt;/a&gt; does this over its&lt;br&gt;
&lt;code&gt;/v1&lt;/code&gt; wire. For a server on the Turbo wire, here is an example: a trust&lt;br&gt;
policy per team.&lt;/p&gt;

&lt;p&gt;A rule names token claims; each value is an exact string, a glob, or a&lt;br&gt;
list.&lt;/p&gt;

&lt;p&gt;A token matches a rule when every claim in it matches.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;trust&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="c1"&gt;// GitHub: main and merge queue, only from the main-branch workflow&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="na"&gt;iss&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;https://token.actions.githubusercontent.com&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;repository_id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;123456789&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;event_name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;push&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;merge_group&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="c1"&gt;// pull_request_target and issue_comment run PR code with ref=main&lt;/span&gt;
      &lt;span class="na"&gt;ref&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;refs/heads/main&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;refs/heads/gh-readonly-queue/main/*&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
      &lt;span class="na"&gt;ref_protected&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;true&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="c1"&gt;// an unprotected branch can be pushed with unreviewed code&lt;/span&gt;
      &lt;span class="na"&gt;job_workflow_ref&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;org/repo/.github/workflows/ci.yml@refs/heads/main&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="c1"&gt;// GitLab: protected main, on our own runners&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="na"&gt;iss&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;https://gitlab.com&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;project_id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;4567&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;ref_path&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;refs/heads/main&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;ref_protected&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;true&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;pipeline_source&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;push&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;schedule&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="c1"&gt;// a manual pipeline can inject CI variables&lt;/span&gt;
      &lt;span class="na"&gt;runner_environment&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;self-hosted&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;],&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Pin &lt;code&gt;repository_id&lt;/code&gt; or &lt;code&gt;project_id&lt;/code&gt;, not the name: after a rename or&lt;br&gt;
delete, another repository can take the name, never the id.&lt;/p&gt;

&lt;p&gt;Trusted is &lt;code&gt;main&lt;/code&gt; and its merge queue only: anyone who can push can tag&lt;br&gt;
any commit, so a tag's run writes to its own scope, as a branch does.&lt;/p&gt;
&lt;h3&gt;
  
  
  Write scope
&lt;/h3&gt;

&lt;p&gt;Built into the server, not configurable. A token that matches no rule&lt;br&gt;
writes to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;GitHub:&lt;/strong&gt; &lt;code&gt;refs/heads/&amp;lt;head_ref&amp;gt;&lt;/code&gt; on a PR run, otherwise &lt;code&gt;ref&lt;/code&gt;. A PR
run writes to its head branch, so a laptop finds it from git alone.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;GitLab:&lt;/strong&gt; &lt;code&gt;ref_path&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  Rules
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Auth.&lt;/strong&gt; Accept GitHub and GitLab OIDC tokens as &lt;code&gt;Authorization:
Bearer&lt;/code&gt;, and verify the signature (the issuer's JWKS), &lt;code&gt;iss&lt;/code&gt;, &lt;code&gt;aud&lt;/code&gt;
and &lt;code&gt;exp&lt;/code&gt;.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Every read needs a token. Each developer creates their own read-only&lt;br&gt;
   token, and a shared read-only token may serve other CIs; neither ever&lt;br&gt;
   writes.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Audience.&lt;/strong&gt; &lt;code&gt;aud&lt;/code&gt; must be this server's own, so a token minted for
another service can't be replayed here.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Trust match.&lt;/strong&gt; As above: every claim a rule names must match.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Write&lt;/strong&gt; (&lt;code&gt;PUT /v8/artifacts/:hash&lt;/code&gt;). A token that matches a rule
stores to trusted. Any other token stores to its write scope. A token
from a repository or project no rule names writes nothing. Entries
are immutable.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Read&lt;/strong&gt; (&lt;code&gt;GET&lt;/code&gt; and &lt;code&gt;HEAD /v8/artifacts/:hash&lt;/code&gt;, and the batch
&lt;code&gt;POST /v8/artifacts&lt;/code&gt;). For each ref in the header, in order: if it
matches a rule's ref glob, look in trusted; otherwise look in that
ref's scope. Return the first hit.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No header.&lt;/strong&gt; Read from trusted only, so plain Turbo clients keep
working.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Per repository.&lt;/strong&gt; Every scope, trusted included, lives in that
repository's own bucket, taken from the token (&lt;code&gt;repository_id&lt;/code&gt;,
&lt;code&gt;project_id&lt;/code&gt;, or the read token's repository). One team's repositories
never share a branch.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Header limits.&lt;/strong&gt; Each entry must be a &lt;code&gt;refs/...&lt;/code&gt; string; dedupe the
list and cap it at 8 refs. vx sends at most 8.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Merge queue.&lt;/strong&gt; It writes to trusted before its code lands, so a
queued PR that drops out leaves trusted entries behind. That is
accepted: queue code is approved code.&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;
  
  
  GitHub
&lt;/h3&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Run&lt;/th&gt;
&lt;th&gt;Token holds&lt;/th&gt;
&lt;th&gt;&lt;code&gt;x-artifact-read-scopes&lt;/code&gt;&lt;/th&gt;
&lt;th&gt;Server reads (first hit)&lt;/th&gt;
&lt;th&gt;Server writes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;main push&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ref=refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;trusted&lt;/td&gt;
&lt;td&gt;trusted&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;merge queue&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ref=refs/heads/gh-readonly-queue/main/…&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/gh-readonly-queue/main/…, refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;trusted&lt;/td&gt;
&lt;td&gt;trusted&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;PR #12 (feature→main)&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;ref=refs/pull/12/merge&lt;/code&gt;, &lt;code&gt;head_ref=feature&lt;/code&gt;, &lt;code&gt;base_ref=main&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature, refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;feature, trusted&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;branch push&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ref=refs/heads/feature&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature, refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;feature, trusted&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;fork PR&lt;/td&gt;
&lt;td&gt;no token&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/&amp;lt;head&amp;gt;, refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;nothing (no token)&lt;/td&gt;
&lt;td&gt;nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;local on main&lt;/td&gt;
&lt;td&gt;personal token (read-only)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;trusted&lt;/td&gt;
&lt;td&gt;nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;local on feature&lt;/td&gt;
&lt;td&gt;personal token (read-only)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature, refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;feature, trusted&lt;/td&gt;
&lt;td&gt;nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;
&lt;h3&gt;
  
  
  GitLab
&lt;/h3&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Run&lt;/th&gt;
&lt;th&gt;Token holds&lt;/th&gt;
&lt;th&gt;&lt;code&gt;x-artifact-read-scopes&lt;/code&gt;&lt;/th&gt;
&lt;th&gt;Server reads (first hit)&lt;/th&gt;
&lt;th&gt;Server writes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;main pipeline&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ref_path=refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;trusted&lt;/td&gt;
&lt;td&gt;trusted&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;merge train&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ref_path=refs/heads/feature&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature, refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;feature, trusted&lt;/td&gt;
&lt;td&gt;nothing (client read-only)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;MR or merged results (feature→main)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ref_path=refs/heads/feature&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature, refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;feature, trusted&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;branch pipeline&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ref_path=refs/heads/feature&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature, refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;feature, trusted&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;fork MR&lt;/td&gt;
&lt;td&gt;fork project's token&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature, refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;nothing (wrong project)&lt;/td&gt;
&lt;td&gt;nothing (wrong project)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;local on main&lt;/td&gt;
&lt;td&gt;personal token (read-only)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;trusted&lt;/td&gt;
&lt;td&gt;nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;local on feature&lt;/td&gt;
&lt;td&gt;personal token (read-only)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;refs/heads/feature, refs/heads/main&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;feature, trusted&lt;/td&gt;
&lt;td&gt;nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;A GitLab token has no merge-train claim, so the server would store a&lt;br&gt;
train's results in the source branch's scope.&lt;/p&gt;

&lt;p&gt;Those results are built from the branch merged with main and the MRs&lt;br&gt;
ahead of it, so the branch almost never reuses them. The CI knows it is&lt;br&gt;
a train, so turn writes off there:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;build&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;rules&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;if&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;$CI_MERGE_REQUEST_EVENT_TYPE == "merge_train"&lt;/span&gt;
      &lt;span class="na"&gt;variables&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
        &lt;span class="na"&gt;VX_CACHE_POLICY&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;local:rw,remote:r&lt;/span&gt;
    &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;when&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;on_success&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A stacked PR (feature-b→feature) reads &lt;code&gt;feature-b, feature, main&lt;/code&gt; in CI&lt;br&gt;
and &lt;code&gt;feature-b, main&lt;/code&gt; on a laptop.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the client sends
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Task keys reach every remote plain.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;turboCache()&lt;/code&gt; sends &lt;code&gt;x-artifact-read-scopes&lt;/code&gt; on every read; a &lt;code&gt;PUT&lt;/code&gt;
names no scope.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;VX_CACHE_SCOPE&lt;/code&gt;, &lt;code&gt;github({ cacheScope })&lt;/code&gt; and &lt;code&gt;gitlab({ cacheScope })&lt;/code&gt;
scope only what plugins store themselves (&lt;code&gt;ctx.cache&lt;/code&gt;, run records).&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The remote cache page's &lt;a href="https://vznjs.github.io/vx/docs/remote-cache/#cache-scopes-and-tokens" rel="noopener noreferrer"&gt;cache scopes and tokens&lt;/a&gt; has the setup.&lt;br&gt;
More at &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/branch-caches-a-server-enforces/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>When running beats downloading</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Wed, 21 Oct 2026 18:18:38 +0000</pubDate>
      <link>https://dev.to/vzn-vx/when-running-beats-downloading-2n60</link>
      <guid>https://dev.to/vzn-vx/when-running-beats-downloading-2n60</guid>
      <description>&lt;p&gt;If a download would take longer than running the task, vx runs the task.&lt;br&gt;
Here 500 tasks are remote hits, and 20 of them are 8 MB on a 4 MB/s&lt;br&gt;
link:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;$ &lt;/span&gt;vx run build &lt;span class="nt"&gt;--all&lt;/span&gt; &lt;span class="nt"&gt;--dry&lt;/span&gt;
500 task&lt;span class="o"&gt;(&lt;/span&gt;s&lt;span class="o"&gt;)&lt;/span&gt; planned, 500 cache hits &lt;span class="o"&gt;(&lt;/span&gt;500 remote, 153 MB&lt;span class="o"&gt;)&lt;/span&gt;&lt;span class="nb"&gt;.&lt;/span&gt;

&lt;span class="nv"&gt;$ &lt;/span&gt;vx run build &lt;span class="nt"&gt;--all&lt;/span&gt;
  cache     &lt;span class="nb"&gt;local &lt;/span&gt;20↑ · remote 480↓ 129 KB
  &lt;span class="nb"&gt;time      &lt;/span&gt;1.02s
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Those 20 would take 2 s each to download. Their tasks run in&lt;br&gt;
milliseconds, so vx ran them here (&lt;code&gt;local 20↑&lt;/code&gt;) and downloaded the&lt;br&gt;
other 480.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;The remote says&lt;/th&gt;
&lt;th&gt;Full run&lt;/th&gt;
&lt;th&gt;Downloaded&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;size and task time&lt;/td&gt;
&lt;td&gt;1.15 s&lt;/td&gt;
&lt;td&gt;129 KB&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;size only&lt;/td&gt;
&lt;td&gt;3.12 s&lt;/td&gt;
&lt;td&gt;153 MB&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;small&gt;Min of 3 interleaved runs, empty local cache · &lt;code&gt;private/vx-bench/generate.ts&lt;/code&gt;, 500 projects, 20 writing 8 MB · Turborepo-protocol stub 30 ms away at 4 MB/s, &lt;code&gt;turboCache()&lt;/code&gt; · Linux x64, 4 cores · vx 22f6eb7 · 2026-10-23&lt;/small&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Weigh the download against the task
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgRFtkb3dubG9hZCBzdGFydHNdIC0tPiBQeyJldmVyeSAyNSBtczo8YnIvPnRpbWUgbGVmdCA-IDIgw5cgdGFzayB0aW1lPyJ9CiAgUCAtLT58bm98IFAKICBQIC0tPnx5ZXN8IFJbZ2l2ZSB1cCwgcnVuIHRoZSB0YXNrIGhlcmVdCiAgUCAtLT58ZG9uZXwgSFtyZXN0b3JlIHRoZSBoaXRdCg%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgRFtkb3dubG9hZCBzdGFydHNdIC0tPiBQeyJldmVyeSAyNSBtczo8YnIvPnRpbWUgbGVmdCA-IDIgw5cgdGFzayB0aW1lPyJ9CiAgUCAtLT58bm98IFAKICBQIC0tPnx5ZXN8IFJbZ2l2ZSB1cCwgcnVuIHRoZSB0YXNrIGhlcmVdCiAgUCAtLT58ZG9uZXwgSFtyZXN0b3JlIHRoZSBoaXRdCg%3FbgColor%3Dwhite" alt="diagram" width="884" height="312"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;The remote has to tell vx the entry's size and its task's time. Turbo's&lt;br&gt;
cache API sends both (&lt;code&gt;Content-Length&lt;/code&gt;, &lt;code&gt;x-artifact-duration&lt;/code&gt;), and&lt;br&gt;
&lt;code&gt;turboCache()&lt;/code&gt; passes them on.&lt;/p&gt;

&lt;p&gt;Twice the task time, because a run here also saves its outputs. The task&lt;br&gt;
counts as a miss and uploads nothing.&lt;/p&gt;

&lt;p&gt;A remote that doesn't send the time is always waited for, as in the&lt;br&gt;
second row. vx won't guess.&lt;/p&gt;

&lt;h2&gt;
  
  
  Know what a run will pull
&lt;/h2&gt;

&lt;p&gt;The footer shows the bytes each way. &lt;code&gt;--dry&lt;/code&gt; shows what the remote hits&lt;br&gt;
would download, before anything runs.&lt;/p&gt;

&lt;h2&gt;
  
  
  For plugin authors
&lt;/h2&gt;

&lt;p&gt;A remote's &lt;code&gt;has&lt;/code&gt; returns &lt;code&gt;{ size, durationMs }&lt;/code&gt;, either one, &lt;code&gt;{}&lt;/code&gt;, or&lt;br&gt;
&lt;code&gt;null&lt;/code&gt; for a missing key. &lt;code&gt;hasMany&lt;/code&gt; returns a &lt;code&gt;Map&lt;/code&gt; of the same. Send a&lt;br&gt;
size and you get the &lt;code&gt;--dry&lt;/code&gt; figure.&lt;/p&gt;

&lt;p&gt;Send a duration too and you get the slow-download check. &lt;a href="https://vznjs.github.io/vx/docs/writing-plugins/#your-own-cache" rel="noopener noreferrer"&gt;Your own&lt;br&gt;
cache&lt;/a&gt; shows a whole remote.&lt;/p&gt;

&lt;p&gt;Setup: &lt;a href="https://vznjs.github.io/vx/docs/remote-cache/" rel="noopener noreferrer"&gt;Remote cache&lt;/a&gt;. More at&lt;br&gt;
&lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/when-running-beats-downloading/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>Every task has a key</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Wed, 21 Oct 2026 18:18:37 +0000</pubDate>
      <link>https://dev.to/vzn-vx/every-task-has-a-key-now-26c4</link>
      <guid>https://dev.to/vzn-vx/every-task-has-a-key-now-26c4</guid>
      <description>&lt;p&gt;A task you don't cache still has a key. Change a code generator's env,&lt;br&gt;
and the cached build after it runs again.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;defineProject&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;@vzn/vx/config&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="nf"&gt;defineProject&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;tasks&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="na"&gt;codegen&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="na"&gt;exec&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="na"&gt;command&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;mkdir -p gen &amp;amp;&amp;amp; echo "export const api = &lt;/span&gt;&lt;span class="se"&gt;\&lt;/span&gt;&lt;span class="s1"&gt;"$API_URL&lt;/span&gt;&lt;span class="se"&gt;\&lt;/span&gt;&lt;span class="s1"&gt;"" &amp;gt; gen/api.ts&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="na"&gt;env&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;passThrough&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;API_URL&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="na"&gt;inputs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;files&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;schema.json&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;.env.local&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="na"&gt;env&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;API_URL&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="na"&gt;build&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="na"&gt;dependsOn&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;codegen&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
      &lt;span class="na"&gt;exec&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;command&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;mkdir -p dist &amp;amp;&amp;amp; cat gen/api.ts &amp;gt; dist/app.js&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="na"&gt;inputs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;files&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;src/**&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="na"&gt;outputs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;files&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;dist/**&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="na"&gt;cache&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;$ API_URL&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;https://a.example vx run packages/e#build
  cache     &lt;span class="nb"&gt;local &lt;/span&gt;1✓ 1∅

&lt;span class="nv"&gt;$ API_URL&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;https://b.example vx run packages/e#build
  cache     &lt;span class="nb"&gt;local &lt;/span&gt;1∅ 1↑
&lt;span class="nv"&gt;$ &lt;/span&gt;&lt;span class="nb"&gt;cat &lt;/span&gt;packages/e/dist/app.js
&lt;span class="nb"&gt;export &lt;/span&gt;const api &lt;span class="o"&gt;=&lt;/span&gt; https://b.example

&lt;span class="nv"&gt;$ &lt;/span&gt;vx why packages/e#build
  verdict    cache key changed: upstream packages/e#codegen
  what changed &lt;span class="o"&gt;(&lt;/span&gt;1 component, 3 unchanged&lt;span class="o"&gt;)&lt;/span&gt;:
    changed upstream  packages/e#codegen  35dfe1115aedc6d6 → a7a53dc4d9e0bde9
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;codegen&lt;/code&gt; never caches (&lt;code&gt;∅&lt;/code&gt;), but its key goes into &lt;code&gt;build&lt;/code&gt;'s key. A&lt;br&gt;
new &lt;code&gt;API_URL&lt;/code&gt; builds again instead of restoring a &lt;code&gt;dist/&lt;/code&gt; made for the&lt;br&gt;
old one.&lt;/p&gt;

&lt;p&gt;&lt;small&gt;Demo workspace · vx 69617eb · 2026-10-23&lt;/small&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgRVsiQVBJX1VSTCwgc2NoZW1hLmpzb24sIC5lbnYubG9jYWwiXSAtLT4gQ1siY29kZWdlbiBrZXk8YnIvPm5ldmVyIGNhY2hlZCJdCiAgQyAtLT4gQlsiYnVpbGQga2V5Il0KICBTWyJzcmMvKioiXSAtLT4gQgogIEIgLS0-IEh7aW4gY2FjaGU_fQogIEggLS0-fHllc3wgUltyZXN0b3JlIGRpc3QvXQogIEggLS0-fG5vfCBYW3J1biBidWlsZF0K%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgRVsiQVBJX1VSTCwgc2NoZW1hLmpzb24sIC5lbnYubG9jYWwiXSAtLT4gQ1siY29kZWdlbiBrZXk8YnIvPm5ldmVyIGNhY2hlZCJdCiAgQyAtLT4gQlsiYnVpbGQga2V5Il0KICBTWyJzcmMvKioiXSAtLT4gQgogIEIgLS0-IEh7aW4gY2FjaGU_fQogIEggLS0-fHllc3wgUltyZXN0b3JlIGRpc3QvXQogIEggLS0-fG5vfCBYW3J1biBidWlsZF0K%3FbgColor%3Dwhite" alt="diagram" width="1046" height="198"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  Inputs live on the task
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;inputs&lt;/code&gt; sits on the task, next to &lt;code&gt;exec&lt;/code&gt;. It sets the key whether the&lt;br&gt;
task caches or not, as in Turbo and Nx. &lt;code&gt;cache: true&lt;/code&gt; turns caching on,&lt;br&gt;
and &lt;code&gt;outputs&lt;/code&gt; says what it saves.&lt;/p&gt;

&lt;p&gt;A task with a command and no &lt;code&gt;inputs&lt;/code&gt; has no key. vx won't guess one.&lt;br&gt;
Every task after it runs again and saves nothing:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;$ &lt;/span&gt;vx run packages/e#build      &lt;span class="c"&gt;# codegen without inputs&lt;/span&gt;
  cache     &lt;span class="nb"&gt;local &lt;/span&gt;1∅ · 1 not saved
&lt;span class="nv"&gt;$ &lt;/span&gt;vx run packages/e#build
  cache     &lt;span class="nb"&gt;local &lt;/span&gt;1∅ · 1 not saved
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A missing input costs a re-run, never a wrong cache hit. Every rule is&lt;br&gt;
on the &lt;a href="https://vznjs.github.io/vx/docs/caching/" rel="noopener noreferrer"&gt;Caching&lt;/a&gt; page.&lt;/p&gt;
&lt;h2&gt;
  
  
  A gitignored file can still be an input
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;.env.local&lt;/code&gt; is gitignored. Editing it still changes the key:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;$ &lt;/span&gt;&lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"TOKEN=2"&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; packages/e/.env.local
&lt;span class="nv"&gt;$ &lt;/span&gt;vx run packages/e#build
  cache     &lt;span class="nb"&gt;local &lt;/span&gt;1∅ 1↑
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;vx reads tracked files' hashes from git. A path you name outright&lt;br&gt;
(&lt;code&gt;.env.local&lt;/code&gt;), or a glob whose fixed part git ignores (&lt;code&gt;gen/**&lt;/code&gt;), is&lt;br&gt;
read from disk.&lt;/p&gt;

&lt;p&gt;A broad glob like &lt;code&gt;src/**&lt;/code&gt; still skips ignored files, and &lt;code&gt;node_modules&lt;/code&gt;&lt;br&gt;
is never walked.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;--affected&lt;/code&gt; sees only what git sees, as in Nx. An ignored file never&lt;br&gt;
picks a task by itself, but the key still changes when the task runs.&lt;/p&gt;

&lt;p&gt;The full key, part by part: &lt;a href="https://vznjs.github.io/vx/caching/" rel="noopener noreferrer"&gt;Caching&lt;/a&gt;. More at&lt;br&gt;
&lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/every-task-has-a-key/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>What a run does not do</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Tue, 20 Oct 2026 22:32:30 +0000</pubDate>
      <link>https://dev.to/vzn-vx/three-things-a-run-stopped-doing-2lf7</link>
      <guid>https://dev.to/vzn-vx/three-things-a-run-stopped-doing-2lf7</guid>
      <description>&lt;p&gt;A warm run is fast mostly because of work it skips. Here is what a vx&lt;br&gt;
run never does.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgUlt2eCBydW5dIC0tPiBUW3J1biB0YXNrc10gLS0-IEZbcHJpbnQgZm9vdGVyXSAtLT4gRVtleGl0XQogIFIgLS4teCBDW2NsZWFuIG9sZCBjYWNoZV0KICBSIC0uLXggV1t3YWxrIHRoZSBzaGFyZWQgc3RvcmVdCiAgRiAtLi14IFNbInRpbWUgc2F2ZWQiIGd1ZXNzXQo%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2FZmxvd2NoYXJ0IExSCiAgUlt2eCBydW5dIC0tPiBUW3J1biB0YXNrc10gLS0-IEZbcHJpbnQgZm9vdGVyXSAtLT4gRVtleGl0XQogIFIgLS4teCBDW2NsZWFuIG9sZCBjYWNoZV0KICBSIC0uLXggV1t3YWxrIHRoZSBzaGFyZWQgc3RvcmVdCiAgRiAtLi14IFNbInRpbWUgc2F2ZWQiIGd1ZXNzXQo%3FbgColor%3Dwhite" alt="diagram" width="803" height="330"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Cleanup runs when you choose
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;$ &lt;/span&gt;vx cache clean &lt;span class="nt"&gt;--older-than&lt;/span&gt; 30d &lt;span class="nt"&gt;--max-size&lt;/span&gt; 10G
› vx cache clean  nothing to free

&lt;span class="nv"&gt;$ &lt;/span&gt;vx cache clean &lt;span class="nt"&gt;--max-size&lt;/span&gt; 100K
✓ vx cache clean  freed 94 MB

  999 entries
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Cleanup at the end of every run would be seven &lt;code&gt;DELETE&lt;/code&gt;s, four of them&lt;br&gt;
full scans, and it grows with history. Run &lt;code&gt;vx cache clean&lt;/code&gt; from cron or&lt;br&gt;
a scheduled CI job instead.&lt;/p&gt;

&lt;p&gt;There is no &lt;code&gt;cache.retention&lt;/code&gt; setting.&lt;/p&gt;

&lt;h2&gt;
  
  
  The shared store opens by its index
&lt;/h2&gt;

&lt;p&gt;The store under &lt;code&gt;~/.vx&lt;/code&gt; opens by its index file. A run never lists its&lt;br&gt;
entries or checks their folders.&lt;/p&gt;

&lt;h2&gt;
  
  
  The footer shows only what it measured
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;  time      63ms · max 8ms · avg 6ms · min 4ms
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;That is wall time, then the slowest, average and fastest task. Adding&lt;br&gt;
up the stored time of every cache hit would overstate the saving.&lt;br&gt;
Tasks that would have run side by side cost the clock only once.&lt;/p&gt;

&lt;p&gt;What each run does, stage by stage: &lt;a href="https://vznjs.github.io/vx/architecture/" rel="noopener noreferrer"&gt;Architecture&lt;/a&gt;.&lt;br&gt;
More at &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/what-a-run-stopped-doing/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>Brackets in a glob mean brackets</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Tue, 20 Oct 2026 22:31:49 +0000</pubDate>
      <link>https://dev.to/vzn-vx/we-took-back-a-glob-shortcut-2a3e</link>
      <guid>https://dev.to/vzn-vx/we-took-back-a-glob-shortcut-2a3e</guid>
      <description>&lt;p&gt;In a vx glob, &lt;code&gt;[jt]&lt;/code&gt; matches one character, &lt;code&gt;j&lt;/code&gt; or &lt;code&gt;t&lt;/code&gt;. A Next.js route&lt;br&gt;
folder like &lt;code&gt;app/[id]&lt;/code&gt; needs escaping.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Glob&lt;/th&gt;
&lt;th&gt;Matches&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;src/*.[jt]s&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;.js&lt;/code&gt; and &lt;code&gt;.ts&lt;/code&gt; files in &lt;code&gt;src&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;app/[id]/**&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;app/i/**&lt;/code&gt;, &lt;code&gt;app/d/**&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;app/\[id\]/**&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;the &lt;code&gt;app/[id]/&lt;/code&gt; folder&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Turbo, Nx and shells read brackets the same way. A glob you copy from&lt;br&gt;
&lt;code&gt;turbo.json&lt;/code&gt; or an Nx project means the same thing in &lt;code&gt;vx.config.ts&lt;/code&gt;.&lt;/p&gt;
&lt;h2&gt;
  
  
  See it in a run
&lt;/h2&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="nx"&gt;route&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;exec&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;command&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;ls src app/*&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="nx"&gt;inputs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;files&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;src/*.[jt]s&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;app/&lt;/span&gt;&lt;span class="se"&gt;\\&lt;/span&gt;&lt;span class="s1"&gt;[id&lt;/span&gt;&lt;span class="se"&gt;\\&lt;/span&gt;&lt;span class="s1"&gt;]/**&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="nx"&gt;outputs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;files&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[]&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="nx"&gt;cache&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;The double backslash is the escape inside a TypeScript string.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;$ &lt;/span&gt;&lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"// e"&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&amp;gt;&lt;/span&gt; app/i/x.ts          &lt;span class="c"&gt;# not an input&lt;/span&gt;
&lt;span class="nv"&gt;$ &lt;/span&gt;vx run packages/c#route
  cache     &lt;span class="nb"&gt;local &lt;/span&gt;1✓

&lt;span class="nv"&gt;$ &lt;/span&gt;&lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"// e"&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&amp;gt;&lt;/span&gt; &lt;span class="s1"&gt;'app/[id]/page.ts'&lt;/span&gt;  &lt;span class="c"&gt;# the escaped route&lt;/span&gt;
&lt;span class="nv"&gt;$ &lt;/span&gt;vx run packages/c#route
  cache     &lt;span class="nb"&gt;local &lt;/span&gt;1↑

&lt;span class="nv"&gt;$ &lt;/span&gt;&lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"// e"&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&amp;gt;&lt;/span&gt; src/j.js            &lt;span class="c"&gt;# matched by [jt]&lt;/span&gt;
&lt;span class="nv"&gt;$ &lt;/span&gt;vx run packages/c#route
  cache     &lt;span class="nb"&gt;local &lt;/span&gt;1↑
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;small&gt;Linux x64 · vx 69617eb · 2026-10-23&lt;/small&gt;&lt;/p&gt;

&lt;p&gt;An edit to an input runs the task again (&lt;code&gt;1↑&lt;/code&gt;). Any other edit is a&lt;br&gt;
cache hit (&lt;code&gt;1✓&lt;/code&gt;). &lt;code&gt;@vzn/vx-migrate&lt;/code&gt; keeps Turbo's and Nx's brackets as&lt;br&gt;
they are, and escapes brackets in any path it writes.&lt;/p&gt;

&lt;p&gt;Glob rules: &lt;a href="https://vznjs.github.io/vx/caching/" rel="noopener noreferrer"&gt;Caching&lt;/a&gt;. More at&lt;br&gt;
&lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/brackets-mean-brackets/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
    <item>
      <title>Cache transfers wait on the network</title>
      <dc:creator>VX</dc:creator>
      <pubDate>Tue, 20 Oct 2026 22:30:57 +0000</pubDate>
      <link>https://dev.to/vzn-vx/cache-transfers-wait-on-the-network-3i6a</link>
      <guid>https://dev.to/vzn-vx/cache-transfers-wait-on-the-network-3i6a</guid>
      <description>&lt;p&gt;Cache uploads and downloads mostly wait on the network, so vx runs up&lt;br&gt;
to 64 at once even on a 4-core machine. 1,000 uploads to a cache 30 ms&lt;br&gt;
away take 2.5 s. With only 4 at once:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;$ &lt;/span&gt;&lt;span class="nb"&gt;time &lt;/span&gt;vx run build &lt;span class="nt"&gt;--all&lt;/span&gt; &lt;span class="nt"&gt;--cache-concurrency-upload&lt;/span&gt; 4
  cache     remote 1000↑ 269 KB
  &lt;span class="nb"&gt;time      &lt;/span&gt;2.27s
real    0m8.345s

&lt;span class="nv"&gt;$ &lt;/span&gt;&lt;span class="nb"&gt;time &lt;/span&gt;vx run build &lt;span class="nt"&gt;--all&lt;/span&gt;
  cache     remote 1000↑ 269 KB
  &lt;span class="nb"&gt;time      &lt;/span&gt;2.38s
real    0m2.649s
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The run's &lt;code&gt;time&lt;/code&gt; ends with its last task. Uploads finish in the&lt;br&gt;
background, and the process exits when they are done.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Lane limit&lt;/th&gt;
&lt;th&gt;Upload all 1,000&lt;/th&gt;
&lt;th&gt;Restore all 1,000 from the remote&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;31.6 s&lt;/td&gt;
&lt;td&gt;9.0 s&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;8.4 s&lt;/td&gt;
&lt;td&gt;8.4 s&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;16&lt;/td&gt;
&lt;td&gt;2.7 s&lt;/td&gt;
&lt;td&gt;2.6 s&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;default (64)&lt;/td&gt;
&lt;td&gt;2.5 s&lt;/td&gt;
&lt;td&gt;1.6 s&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;small&gt;Min of 3 interleaved runs · &lt;code&gt;private/vx-bench/generate.ts&lt;/code&gt;, 1,000 projects, &lt;code&gt;build --all&lt;/code&gt; · Turborepo-protocol cache that answers after 30 ms, &lt;code&gt;turboCache()&lt;/code&gt; · &lt;code&gt;CI=1&lt;/code&gt; · Linux x64, 4 cores · vx a1786b3 · 2026-10-23&lt;/small&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  Three lanes, three limits
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Lane&lt;/th&gt;
&lt;th&gt;Default&lt;/th&gt;
&lt;th&gt;Why&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;download&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;min(96, max(cores × 3, 64))&lt;/td&gt;
&lt;td&gt;mostly waiting on the network&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;upload&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;min(96, max(cores × 3, 64)), per remote&lt;/td&gt;
&lt;td&gt;the same, and it runs in the background&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;restore&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;twice &lt;code&gt;run.concurrency&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;local disk work, closer to a task&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The network formula is pnpm's: at least 64 at once, at most 96. If your&lt;br&gt;
server wants fewer connections, set fewer:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// .vx/workspace.ts&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;defineWorkspace&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;@vzn/vx/config&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="nf"&gt;defineWorkspace&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;cache&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;concurrency&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;download&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;32&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;upload&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;16&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;vx run build &lt;span class="nt"&gt;--all&lt;/span&gt; &lt;span class="nt"&gt;--cache-concurrency-upload&lt;/span&gt; 16
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  A missing key costs no request
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2Fc2VxdWVuY2VEaWFncmFtCiAgcGFydGljaXBhbnQgUiBhcyB2eCBydW4KICBwYXJ0aWNpcGFudCBDIGFzIHJlbW90ZSBjYWNoZQogIFItPj5DOiB3aGljaCBvZiB0aGVzZSBrZXlzIGV4aXN0PyAob25lIGJhdGNoKQogIEMtLT4-UjogdGhlIG9uZXMgaXQgaG9sZHMKICBSLT4-Qzogb25lIGRvd25sb2FkIHBlciBrZXkgaXQgaG9sZHMKICBOb3RlIG92ZXIgUjogZXZlcnkgb3RoZXIgdGFzayBydW5zLCBubyBtb3JlIHJlcXVlc3RzCg%3FbgColor%3Dwhite" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fmermaid.ink%2Fimg%2Fc2VxdWVuY2VEaWFncmFtCiAgcGFydGljaXBhbnQgUiBhcyB2eCBydW4KICBwYXJ0aWNpcGFudCBDIGFzIHJlbW90ZSBjYWNoZQogIFItPj5DOiB3aGljaCBvZiB0aGVzZSBrZXlzIGV4aXN0PyAob25lIGJhdGNoKQogIEMtLT4-UjogdGhlIG9uZXMgaXQgaG9sZHMKICBSLT4-Qzogb25lIGRvd25sb2FkIHBlciBrZXkgaXQgaG9sZHMKICBOb3RlIG92ZXIgUjogZXZlcnkgb3RoZXIgdGFzayBydW5zLCBubyBtb3JlIHJlcXVlc3RzCg%3FbgColor%3Dwhite" alt="diagram" width="625" height="354"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Before tasks start, vx asks each remote in one batch which keys exist.&lt;br&gt;
A missing key costs nothing more. A key it has costs one download.&lt;/p&gt;

&lt;h2&gt;
  
  
  One request per plugin read
&lt;/h2&gt;

&lt;p&gt;Plugins keep entries in the same cache, like the timings&lt;br&gt;
&lt;code&gt;@vzn/vx-history&lt;/code&gt; learns. &lt;code&gt;ctx.cache.get&lt;/code&gt;, &lt;code&gt;has&lt;/code&gt; and &lt;code&gt;hasMany&lt;/code&gt;&lt;br&gt;
each make one request.&lt;/p&gt;

&lt;p&gt;Settings: &lt;a href="https://vznjs.github.io/vx/schema/" rel="noopener noreferrer"&gt;schema&lt;/a&gt;. Flags: &lt;a href="https://vznjs.github.io/vx/cli/" rel="noopener noreferrer"&gt;CLI reference&lt;/a&gt;.&lt;br&gt;
More at &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on the &lt;a href="https://vznjs.github.io/vx/blog/waiting-on-the-network/" rel="noopener noreferrer"&gt;vx blog&lt;/a&gt;. vx is open-source (MIT) task orchestration with a build cache: &lt;a href="https://vznjs.github.io/vx/" rel="noopener noreferrer"&gt;vznjs.github.io/vx&lt;/a&gt; · &lt;a href="https://github.com/vznjs/vx" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>monorepo</category>
      <category>devtools</category>
      <category>opensource</category>
    </item>
  </channel>
</rss>
