explaingit

nektos/act

Analysis updated 2026-06-20

70,179GoAudience · developerComplexity · 2/5Setup · easy

TLDR

act lets you run your GitHub Actions CI workflows locally on your machine using Docker, so you can test and debug workflow changes in seconds without pushing to GitHub.

Mindmap

mindmap
  root((act))
    What it does
      Run Actions locally
      Fast feedback loop
      Local task runner
    How it works
      Reads workflow YAML
      Pulls Docker images
      Mirrors GitHub environment
    Tech stack
      Go
      Docker
    Use cases
      Debug CI pipelines
      Test before push
      Replace Makefile
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Test a GitHub Actions workflow change locally before committing to avoid the slow push-wait-read-logs cycle.

USE CASE 2

Debug a failing CI pipeline by running it step-by-step on your own machine with full log visibility.

USE CASE 3

Use your existing GitHub Actions YAML files as a local task runner instead of maintaining a separate Makefile.

USE CASE 4

Prototype a new workflow for a project without polluting the repository's remote CI history.

What is it built with?

GoDocker

How does it compare?

nektos/actmoby/mobybase/node
Stars70,17971,52168,582
LanguageGoGoGo
Setup difficultyeasyhardmoderate
Complexity2/55/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Docker to be installed and running on your machine before act will work.

Open-source, check the repository for the specific license terms.

In plain English

act is a command-line tool that lets you run your GitHub Actions workflows directly on your own machine, without having to push code to GitHub and wait for remote runners to execute them. It solves the slow feedback loop that developers face when debugging or tweaking .github/workflows/ files, instead of committing, pushing, waiting, and reading logs on GitHub, you can test your workflows instantly, locally. The way it works is straightforward: when you run act in a repository, it reads your workflow files from the .github/workflows/ directory, figures out which actions need to run and in what order (based on dependencies you've defined), then uses Docker to pull or build the container images each action requires. It then runs each step inside those containers, replicating the environment variables and filesystem layout that GitHub's own hosted runners provide. This means your local test environment closely mirrors what GitHub would actually execute. There are two main reasons to use it. First, for fast feedback during development: rather than treating every small workflow tweak as a full commit-and-push cycle, you can iterate locally in seconds. Second, as a general task runner: since GitHub Actions workflows are just structured YAML scripts, act lets you use them as a replacement for a Makefile or similar build tool, running tasks like tests, builds, or linters directly from the command line. You would reach for act whenever you're authoring or debugging CI workflows, want to test a workflow change before it touches the remote repository, or simply want to reuse your existing action definitions as a local automation layer. There is also a Visual Studio Code extension called GitHub Local Actions that integrates act directly into the editor. The tool is written in Go and depends on Docker being installed and running on your machine.

Copy-paste prompts

Prompt 1
My GitHub Actions workflow is failing on the remote runner. Here's the YAML, help me reproduce and debug it locally using act.
Prompt 2
How do I use act to run only a specific job from my workflow file rather than the entire pipeline?
Prompt 3
How do I pass secrets to act for local testing so my workflow can access API keys without committing them?
Prompt 4
Help me configure act to use a custom Docker image that closely matches GitHub's ubuntu-latest hosted runner.

Frequently asked questions

What is act?

act lets you run your GitHub Actions CI workflows locally on your machine using Docker, so you can test and debug workflow changes in seconds without pushing to GitHub.

What language is act written in?

Mainly Go. The stack also includes Go, Docker.

What license does act use?

Open-source, check the repository for the specific license terms.

How hard is act to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is act for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub nektos on gitmyhub

Verify against the repo before relying on details.