From 3e0a2ae3488500905a9fc33a19b6c4d55be9097d Mon Sep 17 00:00:00 2001
From: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
Date: Mon, 29 Sep 2025 10:57:34 +0200
Subject: [PATCH 1/8] use mise file tasks

---
 .github/workflows/reusable-link-check.yml | 34 ++++-------------------
 .mise/tasks/lint/links                    |  8 ++++++
 .mise/tasks/lint/links-if-config-changed  | 20 +++++++++++++
 .mise/tasks/lint/links-in-modified-files  | 25 +++++++++++++++++
 .mise/tasks/lint/local-links              |  8 ++++++
 mise.toml                                 |  6 ----
 6 files changed, 66 insertions(+), 35 deletions(-)
 create mode 100755 .mise/tasks/lint/links
 create mode 100755 .mise/tasks/lint/links-if-config-changed
 create mode 100755 .mise/tasks/lint/links-in-modified-files
 create mode 100755 .mise/tasks/lint/local-links

diff --git a/.github/workflows/reusable-link-check.yml b/.github/workflows/reusable-link-check.yml
index e891e6d06..76bd73f4b 100644
--- a/.github/workflows/reusable-link-check.yml
+++ b/.github/workflows/reusable-link-check.yml
@@ -20,40 +20,16 @@ jobs:
         if: github.event_name == 'pull_request'
         env:
           GITHUB_TOKEN: ${{ github.token }}
-        run: mise run lint-local-links
-
-      - name: Get modified files
-        if: github.event_name == 'pull_request'
-        id: modified-files
-        run: |
-          merge_base=$(git merge-base origin/${{ github.base_ref }} HEAD)
-          # Using lychee's default extension filter here to match when it runs against all files
-          # Note: --diff-filter=d filters out deleted files
-          modified_files=$(git diff --name-only --diff-filter=d $merge_base...${{ github.event.pull_request.head.sha }} \
-                            | grep -E '\.(md|mkd|mdx|mdown|mdwn|mkdn|mkdown|markdown|html|htm|txt)$' \
-                            | tr '\n' ' ' || true)
-          echo "files=$modified_files" >> $GITHUB_OUTPUT
-          echo "Modified files: $modified_files"
-
-      - name: Check if lychee config was modified
-        if: github.event_name == 'pull_request'
-        id: config-check
-        run: |
-          merge_base=$(git merge-base origin/${{ github.base_ref }} HEAD)
-          config_modified=$(git diff --name-only $merge_base...${{ github.event.pull_request.head.sha }} \
-                            | grep -E '^(\.github/config/lychee\.toml|mise\.toml)$' || true)
-          if [ -n "$config_modified" ]; then
-            echo "modified=true" >> $GITHUB_OUTPUT
-          fi
+        run: mise run lint:local-links
 
       - name: Link check (modified files only)
-        if: github.event_name == 'pull_request' && steps.modified-files.outputs.files != '' && steps.config-check.outputs.modified != 'true'
+        if: github.event_name == 'pull_request'
         env:
           GITHUB_TOKEN: ${{ github.token }}
-        run: mise run lint-links ${{ steps.modified-files.outputs.files }}
+        run: mise run lint:links-in-modified-file --base origin/${{ github.base_ref }} --head ${{ github.event.pull_request.head.sha }}
 
       - name: Link check (all files)
-        if: github.event_name != 'pull_request' || steps.config-check.outputs.modified == 'true'
+        if: github.event_name != 'pull_request'
         env:
           GITHUB_TOKEN: ${{ github.token }}
-        run: mise run lint-links
+        run: mise run lint:links-if-config-changed
diff --git a/.mise/tasks/lint/links b/.mise/tasks/lint/links
new file mode 100755
index 000000000..3a1147f0a
--- /dev/null
+++ b/.mise/tasks/lint/links
@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+#MISE description="Lint links in all files"
+
+set -e
+
+#USAGE arg "<file>" var=#true help="files to check" default="."
+
+lychee --verbose --config .github/config/lychee.toml $usage_file
diff --git a/.mise/tasks/lint/links-if-config-changed b/.mise/tasks/lint/links-if-config-changed
new file mode 100755
index 000000000..c576c5e76
--- /dev/null
+++ b/.mise/tasks/lint/links-if-config-changed
@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+#MISE description="Lint links if lychee config changed"
+
+set -e
+
+#USAGE flag "--base <base>" help="base branch to compare against" default="origin/main"
+#USAGE flag "--head <head>" help="head branch to compare against" default="HEAD"
+
+merge_base=$(git merge-base "$usage_base" HEAD)
+
+# Check if lychee config was modified
+config_modified=$(git diff --name-only "$merge_base"..."$usage_head" \
+                  | grep -E '^(\.github/config/lychee\.toml|mise\.toml)$' || true)
+
+if [ -z "$config_modified" ] ; then
+  echo "No config changes, skipping link linting."
+  exit 0
+fi
+
+mise run lint:links
diff --git a/.mise/tasks/lint/links-in-modified-files b/.mise/tasks/lint/links-in-modified-files
new file mode 100755
index 000000000..67cf14e71
--- /dev/null
+++ b/.mise/tasks/lint/links-in-modified-files
@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+#MISE description="Lint links in modified files"
+
+set -e
+
+#USAGE flag "--base <base>" help="base branch to compare against" default="origin/main"
+#USAGE flag "--head <head>" help="head branch to compare against" default="HEAD"
+
+merge_base=$(git merge-base "$usage_base" HEAD)
+# Using lychee's default extension filter here to match when it runs against all files
+# Note: --diff-filter=d filters out deleted files
+modified_files=$(git diff --name-only --diff-filter=d "$merge_base"..."$usage_head" \
+                  | grep -E '\.(md|mkd|mdx|mdown|mdwn|mkdn|mkdown|markdown|html|htm|txt)$' \
+                  | tr '\n' ' ' || true)
+
+# Check if lychee config was modified
+config_modified=$(git diff --name-only "$merge_base"..."$usage_head" \
+                  | grep -E '^(\.github/config/lychee\.toml|mise\.toml)$' || true)
+
+if [ -z "$modified_files" ] && [ -z "$config_modified" ] ; then
+  echo "No modified files and no config changes, skipping link linting."
+  exit 0
+fi
+
+mise run lint-links "$modified_files"
diff --git a/.mise/tasks/lint/local-links b/.mise/tasks/lint/local-links
new file mode 100755
index 000000000..6571ac21f
--- /dev/null
+++ b/.mise/tasks/lint/local-links
@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+#MISE description="Lint links in all files"
+
+set -e
+
+#USAGE arg "<file>" var=#true help="files to check" default="."
+
+lychee --verbose --scheme file --include-fragments $usage_file
diff --git a/mise.toml b/mise.toml
index bc7b9444a..82eb0e4cb 100644
--- a/mise.toml
+++ b/mise.toml
@@ -1,12 +1,6 @@
 [tools]
 lychee = "0.20.1"
 
-[tasks.lint-local-links]
-run = 'lychee --verbose --scheme file --include-fragments {{arg(name="files", default=".")}}'
-
-[tasks.lint-links]
-run = 'lychee --verbose --config .github/config/lychee.toml {{arg(name="files", var=true, default=".")}}'
-
 [settings]
 # Only install tools explicitly defined in the [tools] section above
 idiomatic_version_file_enable_tools = []

From 3ce4c4eecccf95dbfe0b17e0f8650e44a9f3fa78 Mon Sep 17 00:00:00 2001
From: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
Date: Tue, 30 Sep 2025 15:02:44 +0200
Subject: [PATCH 2/8] use mise file tasks

---
 .github/workflows/reusable-link-check.yml |  4 ++++
 .mise/tasks/lint/links-if-config-changed  | 10 +++++++---
 .mise/tasks/lint/links-in-modified-files  | 15 +++++++++------
 3 files changed, 20 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/reusable-link-check.yml b/.github/workflows/reusable-link-check.yml
index 76bd73f4b..9cbaf79e0 100644
--- a/.github/workflows/reusable-link-check.yml
+++ b/.github/workflows/reusable-link-check.yml
@@ -24,11 +24,15 @@ jobs:
 
       - name: Link check (modified files only)
         if: github.event_name == 'pull_request'
+        # todo only if config did not change
         env:
           GITHUB_TOKEN: ${{ github.token }}
         run: mise run lint:links-in-modified-file --base origin/${{ github.base_ref }} --head ${{ github.event.pull_request.head.sha }}
 
+# todo one stop commend for linting that also works locally: lint:modified-links
+
       - name: Link check (all files)
+        # todo also if not PR but config changed
         if: github.event_name != 'pull_request'
         env:
           GITHUB_TOKEN: ${{ github.token }}
diff --git a/.mise/tasks/lint/links-if-config-changed b/.mise/tasks/lint/links-if-config-changed
index c576c5e76..a1d1ec821 100755
--- a/.mise/tasks/lint/links-if-config-changed
+++ b/.mise/tasks/lint/links-if-config-changed
@@ -4,12 +4,16 @@
 set -e
 
 #USAGE flag "--base <base>" help="base branch to compare against" default="origin/main"
-#USAGE flag "--head <head>" help="head branch to compare against" default="HEAD"
+#USAGE flag "--head <head>" help="head branch to compare against" default=""
 
-merge_base=$(git merge-base "$usage_base" HEAD)
+if [ "$usage_head" == "''" ]; then
+  usage_head=""
+fi
+
+# todo use .mise/tasks/lint/* for config change detection
 
 # Check if lychee config was modified
-config_modified=$(git diff --name-only "$merge_base"..."$usage_head" \
+config_modified=$(git diff --name-only --merge_base "$usage_base" $usage_head \
                   | grep -E '^(\.github/config/lychee\.toml|mise\.toml)$' || true)
 
 if [ -z "$config_modified" ] ; then
diff --git a/.mise/tasks/lint/links-in-modified-files b/.mise/tasks/lint/links-in-modified-files
index 67cf14e71..9126bfb8a 100755
--- a/.mise/tasks/lint/links-in-modified-files
+++ b/.mise/tasks/lint/links-in-modified-files
@@ -1,20 +1,23 @@
 #!/usr/bin/env bash
 #MISE description="Lint links in modified files"
 
-set -e
+set -ex
 
 #USAGE flag "--base <base>" help="base branch to compare against" default="origin/main"
-#USAGE flag "--head <head>" help="head branch to compare against" default="HEAD"
+#USAGE flag "--head <head>" help="head branch to compare against" default=""
+
+if [ "$usage_head" == "''" ]; then
+  usage_head=""
+fi
 
-merge_base=$(git merge-base "$usage_base" HEAD)
 # Using lychee's default extension filter here to match when it runs against all files
 # Note: --diff-filter=d filters out deleted files
-modified_files=$(git diff --name-only --diff-filter=d "$merge_base"..."$usage_head" \
+modified_files=$(git diff --name-only --diff-filter=d "$usage_base" $usage_head \
                   | grep -E '\.(md|mkd|mdx|mdown|mdwn|mkdn|mkdown|markdown|html|htm|txt)$' \
                   | tr '\n' ' ' || true)
 
 # Check if lychee config was modified
-config_modified=$(git diff --name-only "$merge_base"..."$usage_head" \
+config_modified=$(git diff --name-only --merge-base "$usage_base" $usage_head \
                   | grep -E '^(\.github/config/lychee\.toml|mise\.toml)$' || true)
 
 if [ -z "$modified_files" ] && [ -z "$config_modified" ] ; then
@@ -22,4 +25,4 @@ if [ -z "$modified_files" ] && [ -z "$config_modified" ] ; then
   exit 0
 fi
 
-mise run lint-links "$modified_files"
+mise run lint:links $modified_files

From 004c4d528b092a4b4be47aec938ff6143a69e120 Mon Sep 17 00:00:00 2001
From: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
Date: Tue, 30 Sep 2025 15:13:27 +0200
Subject: [PATCH 3/8] use mise file tasks

---
 .github/workflows/reusable-link-check.yml | 13 +--------
 .mise/tasks/lint/links-if-config-changed  | 24 -----------------
 .mise/tasks/lint/links-in-modified-files  | 32 +++++++++++++++--------
 3 files changed, 22 insertions(+), 47 deletions(-)
 delete mode 100755 .mise/tasks/lint/links-if-config-changed

diff --git a/.github/workflows/reusable-link-check.yml b/.github/workflows/reusable-link-check.yml
index 9cbaf79e0..d270789c2 100644
--- a/.github/workflows/reusable-link-check.yml
+++ b/.github/workflows/reusable-link-check.yml
@@ -23,17 +23,6 @@ jobs:
         run: mise run lint:local-links
 
       - name: Link check (modified files only)
-        if: github.event_name == 'pull_request'
-        # todo only if config did not change
-        env:
-          GITHUB_TOKEN: ${{ github.token }}
-        run: mise run lint:links-in-modified-file --base origin/${{ github.base_ref }} --head ${{ github.event.pull_request.head.sha }}
-
-# todo one stop commend for linting that also works locally: lint:modified-links
-
-      - name: Link check (all files)
-        # todo also if not PR but config changed
-        if: github.event_name != 'pull_request'
         env:
           GITHUB_TOKEN: ${{ github.token }}
-        run: mise run lint:links-if-config-changed
+        run: mise run lint:links-in-modified-file --base origin/${{ github.base_ref }} --head ${{ github.event.pull_request.head.sha }} --event ${{ github.event_name }}
diff --git a/.mise/tasks/lint/links-if-config-changed b/.mise/tasks/lint/links-if-config-changed
deleted file mode 100755
index a1d1ec821..000000000
--- a/.mise/tasks/lint/links-if-config-changed
+++ /dev/null
@@ -1,24 +0,0 @@
-#!/usr/bin/env bash
-#MISE description="Lint links if lychee config changed"
-
-set -e
-
-#USAGE flag "--base <base>" help="base branch to compare against" default="origin/main"
-#USAGE flag "--head <head>" help="head branch to compare against" default=""
-
-if [ "$usage_head" == "''" ]; then
-  usage_head=""
-fi
-
-# todo use .mise/tasks/lint/* for config change detection
-
-# Check if lychee config was modified
-config_modified=$(git diff --name-only --merge_base "$usage_base" $usage_head \
-                  | grep -E '^(\.github/config/lychee\.toml|mise\.toml)$' || true)
-
-if [ -z "$config_modified" ] ; then
-  echo "No config changes, skipping link linting."
-  exit 0
-fi
-
-mise run lint:links
diff --git a/.mise/tasks/lint/links-in-modified-files b/.mise/tasks/lint/links-in-modified-files
index 9126bfb8a..ff9aeae6a 100755
--- a/.mise/tasks/lint/links-in-modified-files
+++ b/.mise/tasks/lint/links-in-modified-files
@@ -1,28 +1,38 @@
 #!/usr/bin/env bash
 #MISE description="Lint links in modified files"
 
-set -ex
+set -e
 
 #USAGE flag "--base <base>" help="base branch to compare against" default="origin/main"
 #USAGE flag "--head <head>" help="head branch to compare against" default=""
+#USAGE flag "--event <event>" help="PR name" default="pull_request"
 
 if [ "$usage_head" == "''" ]; then
   usage_head=""
 fi
 
-# Using lychee's default extension filter here to match when it runs against all files
-# Note: --diff-filter=d filters out deleted files
-modified_files=$(git diff --name-only --diff-filter=d "$usage_base" $usage_head \
-                  | grep -E '\.(md|mkd|mdx|mdown|mdwn|mkdn|mkdown|markdown|html|htm|txt)$' \
-                  | tr '\n' ' ' || true)
-
 # Check if lychee config was modified
 config_modified=$(git diff --name-only --merge-base "$usage_base" $usage_head \
-                  | grep -E '^(\.github/config/lychee\.toml|mise\.toml)$' || true)
+                  | grep -E '^(\.github/config/lychee\.toml|.mise/tasks/lint|mise\.toml)$' || true)
 
-if [ -z "$modified_files" ] && [ -z "$config_modified" ] ; then
-  echo "No modified files and no config changes, skipping link linting."
+if [ -n "$config_modified" ] ; then
+  echo "config changes, checking all files."
+  mise run lint:links
+elif [ "$usage_event" != "pull_request" ] ; then
+  echo "Not a PR - skipping link linting."
   exit 0
+else
+  # Using lychee's default extension filter here to match when it runs against all files
+  # Note: --diff-filter=d filters out deleted files
+  modified_files=$(git diff --name-only --diff-filter=d "$usage_base" $usage_head \
+                    | grep -E '\.(md|mkd|mdx|mdown|mdwn|mkdn|mkdown|markdown|html|htm|txt)$' \
+                    | tr '\n' ' ' || true)
+
+  if [ -z "$modified_files" ]; then
+    echo "No modified files, skipping link linting."
+    exit 0
+  fi
+
+  mise run lint:links $modified_files
 fi
 
-mise run lint:links $modified_files

From 074e0b029c10532bf2e0df8451a9b2e24010a4bf Mon Sep 17 00:00:00 2001
From: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
Date: Tue, 30 Sep 2025 16:33:43 +0200
Subject: [PATCH 4/8] use mise file tasks

---
 .github/workflows/reusable-link-check.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-link-check.yml b/.github/workflows/reusable-link-check.yml
index d270789c2..87711b6ce 100644
--- a/.github/workflows/reusable-link-check.yml
+++ b/.github/workflows/reusable-link-check.yml
@@ -25,4 +25,4 @@ jobs:
       - name: Link check (modified files only)
         env:
           GITHUB_TOKEN: ${{ github.token }}
-        run: mise run lint:links-in-modified-file --base origin/${{ github.base_ref }} --head ${{ github.event.pull_request.head.sha }} --event ${{ github.event_name }}
+        run: mise run lint:links-in-modified-files --base origin/${{ github.base_ref }} --head ${{ github.event.pull_request.head.sha }} --event ${{ github.event_name }}

From cc35e2794ec84d3c7d656cc324d6f5f62bf6181f Mon Sep 17 00:00:00 2001
From: Trask Stalnaker <trask.stalnaker@gmail.com>
Date: Tue, 30 Sep 2025 09:34:42 -0700
Subject: [PATCH 5/8] Fix on Windows

---
 .../{links-in-modified-files => links-in-modified-files.sh} | 0
 .mise/tasks/lint/{links => links.sh}                        | 0
 .mise/tasks/lint/{local-links => local-links.sh}            | 0
 mise.toml                                                   | 6 ++++++
 4 files changed, 6 insertions(+)
 rename .mise/tasks/lint/{links-in-modified-files => links-in-modified-files.sh} (100%)
 mode change 100755 => 100644
 rename .mise/tasks/lint/{links => links.sh} (100%)
 mode change 100755 => 100644
 rename .mise/tasks/lint/{local-links => local-links.sh} (100%)
 mode change 100755 => 100644

diff --git a/.mise/tasks/lint/links-in-modified-files b/.mise/tasks/lint/links-in-modified-files.sh
old mode 100755
new mode 100644
similarity index 100%
rename from .mise/tasks/lint/links-in-modified-files
rename to .mise/tasks/lint/links-in-modified-files.sh
diff --git a/.mise/tasks/lint/links b/.mise/tasks/lint/links.sh
old mode 100755
new mode 100644
similarity index 100%
rename from .mise/tasks/lint/links
rename to .mise/tasks/lint/links.sh
diff --git a/.mise/tasks/lint/local-links b/.mise/tasks/lint/local-links.sh
old mode 100755
new mode 100644
similarity index 100%
rename from .mise/tasks/lint/local-links
rename to .mise/tasks/lint/local-links.sh
diff --git a/mise.toml b/mise.toml
index 82eb0e4cb..0e27c5494 100644
--- a/mise.toml
+++ b/mise.toml
@@ -4,3 +4,9 @@ lychee = "0.20.1"
 [settings]
 # Only install tools explicitly defined in the [tools] section above
 idiomatic_version_file_enable_tools = []
+
+# Windows configuration for file-based tasks
+# Based on: https://github.com/jdx/mise/discussions/4461
+windows_executable_extensions = ["sh"]
+windows_default_file_shell_args = "bash"
+use_file_shell_for_executable_tasks = true

From 390f4fab876beecc18481477d5582a0bb5880fc7 Mon Sep 17 00:00:00 2001
From: Trask Stalnaker <trask.stalnaker@gmail.com>
Date: Tue, 30 Sep 2025 09:42:31 -0700
Subject: [PATCH 6/8] Executable

---
 .mise/tasks/lint/links-in-modified-files.sh | 0
 .mise/tasks/lint/links.sh                   | 0
 .mise/tasks/lint/local-links.sh             | 0
 3 files changed, 0 insertions(+), 0 deletions(-)
 mode change 100644 => 100755 .mise/tasks/lint/links-in-modified-files.sh
 mode change 100644 => 100755 .mise/tasks/lint/links.sh
 mode change 100644 => 100755 .mise/tasks/lint/local-links.sh

diff --git a/.mise/tasks/lint/links-in-modified-files.sh b/.mise/tasks/lint/links-in-modified-files.sh
old mode 100644
new mode 100755
diff --git a/.mise/tasks/lint/links.sh b/.mise/tasks/lint/links.sh
old mode 100644
new mode 100755
diff --git a/.mise/tasks/lint/local-links.sh b/.mise/tasks/lint/local-links.sh
old mode 100644
new mode 100755

From f06912e7415c97f22fc237931860fb702dffb1e3 Mon Sep 17 00:00:00 2001
From: Trask Stalnaker <trask.stalnaker@gmail.com>
Date: Tue, 30 Sep 2025 09:49:15 -0700
Subject: [PATCH 7/8] shellcheck

---
 .mise/tasks/lint/links-in-modified-files.sh | 6 ++++--
 .mise/tasks/lint/links.sh                   | 3 ++-
 .mise/tasks/lint/local-links.sh             | 3 ++-
 3 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/.mise/tasks/lint/links-in-modified-files.sh b/.mise/tasks/lint/links-in-modified-files.sh
index ff9aeae6a..081552930 100755
--- a/.mise/tasks/lint/links-in-modified-files.sh
+++ b/.mise/tasks/lint/links-in-modified-files.sh
@@ -7,12 +7,13 @@ set -e
 #USAGE flag "--head <head>" help="head branch to compare against" default=""
 #USAGE flag "--event <event>" help="PR name" default="pull_request"
 
+# shellcheck disable=SC2154
 if [ "$usage_head" == "''" ]; then
   usage_head=""
 fi
 
 # Check if lychee config was modified
-config_modified=$(git diff --name-only --merge-base "$usage_base" $usage_head \
+config_modified=$(git diff --name-only --merge-base "$usage_base" "$usage_head" \
                   | grep -E '^(\.github/config/lychee\.toml|.mise/tasks/lint|mise\.toml)$' || true)
 
 if [ -n "$config_modified" ] ; then
@@ -24,7 +25,7 @@ elif [ "$usage_event" != "pull_request" ] ; then
 else
   # Using lychee's default extension filter here to match when it runs against all files
   # Note: --diff-filter=d filters out deleted files
-  modified_files=$(git diff --name-only --diff-filter=d "$usage_base" $usage_head \
+  modified_files=$(git diff --name-only --diff-filter=d "$usage_base" "$usage_head" \
                     | grep -E '\.(md|mkd|mdx|mdown|mdwn|mkdn|mkdown|markdown|html|htm|txt)$' \
                     | tr '\n' ' ' || true)
 
@@ -33,6 +34,7 @@ else
     exit 0
   fi
 
+  # shellcheck disable=SC2086
   mise run lint:links $modified_files
 fi
 
diff --git a/.mise/tasks/lint/links.sh b/.mise/tasks/lint/links.sh
index 3a1147f0a..6a0d745d3 100755
--- a/.mise/tasks/lint/links.sh
+++ b/.mise/tasks/lint/links.sh
@@ -5,4 +5,5 @@ set -e
 
 #USAGE arg "<file>" var=#true help="files to check" default="."
 
-lychee --verbose --config .github/config/lychee.toml $usage_file
+# shellcheck disable=SC2154
+lychee --verbose --config .github/config/lychee.toml "$usage_file"
diff --git a/.mise/tasks/lint/local-links.sh b/.mise/tasks/lint/local-links.sh
index 6571ac21f..87de8a39d 100755
--- a/.mise/tasks/lint/local-links.sh
+++ b/.mise/tasks/lint/local-links.sh
@@ -5,4 +5,5 @@ set -e
 
 #USAGE arg "<file>" var=#true help="files to check" default="."
 
-lychee --verbose --scheme file --include-fragments $usage_file
+# shellcheck disable=SC2154
+lychee --verbose --scheme file --include-fragments "$usage_file"

From 63f31f19d611b827ed093d72d59ef1ffd610d6e6 Mon Sep 17 00:00:00 2001
From: Trask Stalnaker <trask.stalnaker@gmail.com>
Date: Tue, 30 Sep 2025 13:42:46 -0700
Subject: [PATCH 8/8] shellcheck

---
 .mise/tasks/lint/.shellcheckrc              | 3 +++
 .mise/tasks/lint/links-in-modified-files.sh | 1 -
 .mise/tasks/lint/links.sh                   | 1 -
 .mise/tasks/lint/local-links.sh             | 1 -
 4 files changed, 3 insertions(+), 3 deletions(-)
 create mode 100644 .mise/tasks/lint/.shellcheckrc

diff --git a/.mise/tasks/lint/.shellcheckrc b/.mise/tasks/lint/.shellcheckrc
new file mode 100644
index 000000000..c186fb835
--- /dev/null
+++ b/.mise/tasks/lint/.shellcheckrc
@@ -0,0 +1,3 @@
+# shellcheck configuration for mise tasks
+# SC2154: usage_* variables are set by mise framework
+disable=SC2154
diff --git a/.mise/tasks/lint/links-in-modified-files.sh b/.mise/tasks/lint/links-in-modified-files.sh
index 081552930..893723a44 100755
--- a/.mise/tasks/lint/links-in-modified-files.sh
+++ b/.mise/tasks/lint/links-in-modified-files.sh
@@ -7,7 +7,6 @@ set -e
 #USAGE flag "--head <head>" help="head branch to compare against" default=""
 #USAGE flag "--event <event>" help="PR name" default="pull_request"
 
-# shellcheck disable=SC2154
 if [ "$usage_head" == "''" ]; then
   usage_head=""
 fi
diff --git a/.mise/tasks/lint/links.sh b/.mise/tasks/lint/links.sh
index 6a0d745d3..479549f74 100755
--- a/.mise/tasks/lint/links.sh
+++ b/.mise/tasks/lint/links.sh
@@ -5,5 +5,4 @@ set -e
 
 #USAGE arg "<file>" var=#true help="files to check" default="."
 
-# shellcheck disable=SC2154
 lychee --verbose --config .github/config/lychee.toml "$usage_file"
diff --git a/.mise/tasks/lint/local-links.sh b/.mise/tasks/lint/local-links.sh
index 87de8a39d..e79694d95 100755
--- a/.mise/tasks/lint/local-links.sh
+++ b/.mise/tasks/lint/local-links.sh
@@ -5,5 +5,4 @@ set -e
 
 #USAGE arg "<file>" var=#true help="files to check" default="."
 
-# shellcheck disable=SC2154
 lychee --verbose --scheme file --include-fragments "$usage_file"