otty / apps
All apps/act

act

act

Run your GitHub Actions locally!

Runs as act|macOS, Linux, Windows|github.com
Open form in Otty otty.toml

Command form

ai-draft · 3 tasks · 18 fields

Run workflows from .github/workflows in containers, or list and graph them. Event-name positional, runner image tuning and Docker socket options are left out.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui act
Run GitHub Actions locallyExample values, fixed in this page — nothing here reaches a terminal
Basic
Workflow file or directory
any
Run only this job
string
Event JSON file
file
Dry run
--dryrun
Secrets
string
Secret file
file
Environment variables
string
Environment file
file
TasksEach one presets the form for one job
Run a workflow
workflowsjobeventpathsecretsecret_fileenvenv_filedryrun
List workflows
listworkflows
Show workflow graph
graphworkflows
ParametersOnly these flags are editable in the form
Workflow file or directory
path
--workflows-W
Run only this job
string
--job-j
Event JSON file
path
--eventpath-e
List workflows
boolean
--list-l
Draw workflow graph
boolean
--graph-g
Dry run
boolean
--dryrun-n
Secrets
KEY=value, or KEY alone to be prompted. Values typed here end up in shell history; prefer a secret file.
string · repeatable
--secret-s
Secret file
path
--secret-file
Environment variables
KEY=value, or KEY alone.
string · repeatable
--env
Environment file
path
--env-file
Platform image mappings
Example: ubuntu-latest=catthehacker/ubuntu:act-latest
string · repeatable
--platform-P
Container architecture
string
--container-architecturelinux/amd64linux/arm64
Bind working directory
Bind the working directory into the container instead of copying it.
boolean
--bind-b
Keep containers
boolean
--reuse-r
Pull images
boolean
--pull-p
Watch for changes
boolean
--watch-w
Verbose
boolean
--verbose-v
Quiet
boolean
--quiet-q
SourcesEvery flag above is checked against these
fig
completion

github.com

Before it fills your prompt, Otty checks the installed act against its version. A form that does not match your version is not offered.