About this project

act is a command-line tool that lets you run GitHub Actions workflows on your local machine. It reads the workflow definitions from `.github/workflows/`, determines the actions that need to run, and uses the Docker API to pull or build the required images. It then runs each action in a container, with environment variables and filesystem behavior configured to match what GitHub provides on hosted runners. The project highlights two main uses: getting fast feedback when editing workflow files or embedded actions without needing to commit and push, and acting as a local task runner that can replace a Makefile by reusing GitHub Actions definitions. Additional resources mentioned include an Act User Guide at nektosact.com, a Visual Studio Code extension called GitHub Local Actions, and project discussions for support. Contributions are welcome, with instructions provided for building from source using Go 1.20+ and the standard `make test` / `make install` commands.