Run your GitHub Actions locally with the power of the GitHub Local Actions VS Code extension! Say goodbye to the hassle of committing and pushing changes every time you need to test a workflow. This extension lets you quickly and efficiently run your workflows locally, leveraging the nektos/act CLI tool. Enjoy a seamless experience with an interface designed to feel as familiar as the official GitHub Actions extension.
- 🚀 Run Workflows/Jobs: Run entire workflows or specific jobs locally without leaving your editor.
- ⚡ Trigger Events: Trigger standard GitHub events to run multiple workflows.
- 📖 View Workflow Run History: Track and investigate past workflow logs.
- ⚙️ Manage Workflow Settings: Define secrets, variables, inputs, and runners to be used when executing workflows.
The Components
view is where you can manage the following components which must be installed and started up before running any GitHub Actions:
-
nektos/act: Act is a CLI tool responsible for executing your workflows locally. It can be installed via several software package managers or using a pre-built artifact.
-
Docker Engine: Docker Engine is required for act to function as it uses Docker to handle workflow execution. The process includes:
- Pulling or building the images specified in your workflow files
- Determining the execution path based on your workflow's dependencies
- Running containers for each action using the prepared images
The containers are configured to mirror GitHub's environment, including matching environment variables and filesystems, ensuring a consistent and reliable local execution.
The Workflows
view is where you can manage and run workflows locally. You have several options to execute a workflow:
- Run All Workflows: Run all workflows in the workspace.
- Run Workflow: Run an entire workflow.
- Run Job: Run a specific job in a workflow.
- Run Event: Run multiple workflows by triggering a GitHub event.
The History
view is where you can manage workflows currently being executed as well as review logs from previous workflow runs.
The Settings
view is where you can set secrets, variables, inputs, and runners to be used when executing workflows.
🚨 Checkout the nektos/act documentation for more details on how these various settings are handled. In particular, refer to how secrets can be provided to workflows interactively, as environment variables, or from a file.
Feel free to share any bugs or feature requests in the project's GitHub Issues page.
🚨 For any bugs or feature requests related to nektos/act specifically, refer to its dedicated GitHub Issues page.
Contributions are always welcome! Please see our contributing guide for more details.