Aquí hi ha 2 versions d’actionlint, des de 2 de setembre del 2026 fins a l’actual, 1.17.0. Cadascuna enllaça amb els instal·ladors del mateix desenvolupador.
| Versió | Data | Mida | Fitxers |
|---|---|---|---|
| 1.17.0Darrera versió | 13 de setembre del 2026 | — | 64 bits ZIPARM64 ZIP32 bits ZIP Notes de la versióMore of GitHub Actions understood. More mistakes caught before a workflow runs. actionlint 1.17.0 is a substantial release for this fork: explicit cache access controls, cache safety policies enabled by default, and a broad audit of workflow syntax, expressions, and local action manifests against GitHub's own schemas and runner code.
The schema work deserves equal billing. Valid expression-built matrices can now pass without spurious errors, newer workflow fields are understood, and malformed schedules and action metadata receive checks they previously escaped. Below are concrete examples of what changes when you upgrade, along with new installation options through the aqua registry and mise.
Upgrade note: the new policies can make previously clean workflows exit with status 1, including repositories without a configuration file. Existing opt-in policies retain their defaults.
Make cache access explicit
GitHub's cache-mode controls cache access independently of token permissions:
Mode | Restore | Save
read | Yes | No
write | Yes | Yes
write-only | No | Yes
none | No | No
Set it on the workflow or an individual job. Job settings override workflow settings; omission retains GitHub's trigger-dependent defaults. For example, give a reusable workflow a read-only ceiling:
on: pull_request_target
cache-mode: read
jobs:
report:
uses: $/.github/workflows/report.yml
actionlint follows nested local reusable calls and checks their explicit declarations against the caller's limit. Diagnostics preserve the original ./ or $/ reference. Missing or malformed callees are reported consistently regardless of file analysis order. (#163, #164)
Catch unsafe grants and ineffective cache steps
Three policies now run automatically:
- cache-write-untrusted reports explicit write grants on low-trust triggers with access to default-branch caches, including pull_request_target, issue_comment, and workflow_run.
- cache-call-unrestricted requires an explicit cache ceiling for reusable calls on those triggers.
- cache-operation reports official actions/cache, actions/cache/save, and actions/cache/restore steps whose operations an explicit mode disables. Caller-imposed limits are followed through nested local workflows, including parallel child steps.
GitHub skips forbidden cache operations without failing the job. The operation check makes ineffective steps visible. The combined actions/cache action remains useful under read or write-only, where one operation is still available. Remote workflow bodies, wrappers, and package-manager caching options are not inspected. (#165)
For example, this job explicitly disables the operation its cache step requests:
jobs:
build:
runs-on: ubuntu-latest
cache-mode: read
steps:
- uses: actions/cache/save@v6
with:
path: .cache
key: build-${{ github.sha }}
It now receives a cache-operation diagnostic. If the job should only restore a cache, use actions/cache/restore. If it really must save, review the trigger and grant the appropriate write access. The same mismatch is detected when the save lives inside a local reusable workflow and the caller supplies the read ceiling.
Configure policies and reviewed exceptions
Disable individual checks in .github/actionlint.yaml:
policy:
cache-write-untrusted: false
cache-call-unrestricted: false
cache-operation: false
Omitted or null policy values retain the enabled defaults. For a reviewed exception, place an exact rule ID and a reason on the reported line:
cache-mode: write # actionlint:ignore cache-write-untrusted -- jobs execute reviewed default-branch code only
Alternatively, put # actionlint:ignore-next-line cache-write-untrusted -- reviewed reason immediately above it. These directives affect a physical line and support only the three cache policies.
Repositories can prohibit inline exceptions:
policy:
disallow-suppressions: true
This reports the prohibited comment and retains the original violation. A mapping can select rules and choose report: all, suppress |
| 1.14.0 | 2 de setembre del 2026 | — | 64 bits ZIPARM64 ZIP32 bits ZIP |