The .NET equivalent of the official GitHub actions/toolkit repository, and is currently a work in progress. While there isn't currently 100% feature complete compatibility between these two repositories, that is the eventual goal.
Important
This repository is in the middle of a rename and feature-parity initiative (#5).
NuGet package IDs are moving from GitHub.Actions.* to ActionsToolkit.*, and all ten
upstream @actions/toolkit packages will ship together as v1.0.0 of ActionsToolkit.*
once each row in PACKAGES.md is fully ✅. Native AOT correctness is verified per
package via dedicated tests/<pkg>.Aot.Tests projects.
🔗 Hello from the GitHub Actions: Core .NET SDK
The GitHub Actions .NET ToolKit provides a set of packages to make creating actions easier.
Provides functions for inputs, outputs, results, logging, secrets and variables. Read more here
dotnet add package ActionsToolkit.Core
For more information, see 📦 ActionsToolkit.Core.
Provides functions to search for files matching glob patterns. Read more here
dotnet add package ActionsToolkit.Glob
For more information, see 📦 ActionsToolkit.Glob.
Provides disk i/o functions like cp, mv, rmRF, which etc. Read more here
dotnet add package ActionsToolkit.IOFor more information, see 📦 ActionsToolkit.IO.
Provides functions to exec command-line tools and process their output. Read more here
dotnet add package ActionsToolkit.ExecFor more information, see 📦 ActionsToolkit.Exec.
Provides an Octokit client hydrated with the context that the current action is being run in. Read more here
dotnet add package ActionsToolkit.OctokitFor more information, see 📦 ActionsToolkit.Octokit.
Provides functions for downloading, extracting, and caching tools (such as language runtimes) on the runner — the .NET equivalent of @actions/tool-cache. Read more here.
dotnet add package ActionsToolkit.ToolCacheFor more information, see 📦 ActionsToolkit.ToolCache.
Provides functions for generating signed artifact attestations — Sigstore keyless signing of in-toto statements (including SLSA-style provenance) and persistence to GitHub's attestations REST endpoint. Read more here.
dotnet add package ActionsToolkit.AttestFor more information, see 📦 ActionsToolkit.Attest.
Provides functions for saving and restoring caches against the GitHub Actions cache service — the .NET equivalent of @actions/cache. Tar+zstd archive pipeline (managed via System.Formats.Tar + ZstdSharp.Port), Twirp+signed-URL transport for the V2 cache backend, and AOT-clean source-gen JSON. Read more here.
dotnet add package ActionsToolkit.CacheFor more information, see 📦 ActionsToolkit.Cache.
Thanks goes to these wonderful people (emoji key):
 Chet Husk 💻 |
 js6pak 💻 |
 David Gardiner 💻 |
 Fredrik Høisæther Rasch 💻 🤔 |
This project follows the all-contributors specification. Contributions of any kind welcome!