diff --git a/.github/workflows/base-check.yml b/.github/workflows/base-check.yml
index 4967bc5d..c0b82492 100644
--- a/.github/workflows/base-check.yml
+++ b/.github/workflows/base-check.yml
@@ -109,7 +109,7 @@ jobs:
         uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
         with:
           repository: basefoundry/base-cli
-          ref: 9f3ed25fc0991e3aa9de8411878805c122f90a11
+          ref: v0.4.0
           path: .base/base-cli
 
       - name: Set up Python
diff --git a/.github/workflows/copilot-setup-steps.yml b/.github/workflows/copilot-setup-steps.yml
index 54622ea1..5512a763 100644
--- a/.github/workflows/copilot-setup-steps.yml
+++ b/.github/workflows/copilot-setup-steps.yml
@@ -29,7 +29,7 @@ jobs:
         uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
         with:
           repository: basefoundry/base-cli
-          ref: 9f3ed25fc0991e3aa9de8411878805c122f90a11
+          ref: v0.4.0
           path: .dependencies/base-cli
 
       - name: Set up Python
diff --git a/.github/workflows/pylint.yml b/.github/workflows/pylint.yml
index e7cfe7d2..2c8ae711 100644
--- a/.github/workflows/pylint.yml
+++ b/.github/workflows/pylint.yml
@@ -25,7 +25,7 @@ jobs:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
         with:
           repository: basefoundry/base-cli
-          ref: 9f3ed25fc0991e3aa9de8411878805c122f90a11
+          ref: v0.4.0
           path: .dependencies/base-cli
 
       - name: Set up Python ${{ matrix.python-version }}
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 1be989d1..4d7f1696 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -31,7 +31,7 @@ jobs:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
         with:
           repository: basefoundry/base-cli
-          ref: 9f3ed25fc0991e3aa9de8411878805c122f90a11
+          ref: v0.4.0
           path: .dependencies/base-cli
 
       - name: Set up Python
@@ -73,7 +73,7 @@ jobs:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
         with:
           repository: basefoundry/base-cli
-          ref: 9f3ed25fc0991e3aa9de8411878805c122f90a11
+          ref: v0.4.0
           path: .dependencies/base-cli
 
       - name: Expose standalone Python package checkout as sibling
@@ -125,7 +125,7 @@ jobs:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
         with:
           repository: basefoundry/base-cli
-          ref: 9f3ed25fc0991e3aa9de8411878805c122f90a11
+          ref: v0.4.0
           path: .dependencies/base-cli
 
       - name: Expose standalone Python package checkout as sibling
@@ -217,7 +217,7 @@ jobs:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
         with:
           repository: basefoundry/base-cli
-          ref: 9f3ed25fc0991e3aa9de8411878805c122f90a11
+          ref: v0.4.0
           path: .dependencies/base-cli
 
       - name: Expose standalone Python package checkout as sibling
@@ -281,7 +281,7 @@ jobs:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
         with:
           repository: basefoundry/base-cli
-          ref: 9f3ed25fc0991e3aa9de8411878805c122f90a11
+          ref: v0.4.0
           path: .dependencies/base-cli
 
       - name: Expose reusable Bash library checkout as sibling
@@ -343,7 +343,7 @@ jobs:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
         with:
           repository: basefoundry/base-cli
-          ref: 9f3ed25fc0991e3aa9de8411878805c122f90a11
+          ref: v0.4.0
           path: .dependencies/base-cli
 
       - name: Set up Python