# ACT Setup

Run GitHub Actions workflows locally using ACT.



Run GitHub Actions workflows locally using [ACT](https://github.com/nektos/act).

## Installation [#installation]

### macOS [#macos]

```bash
brew install act
```

### Linux [#linux]

```bash
curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash
```

## Usage [#usage]

### List Available Workflows [#list-available-workflows]

```bash
act --list
```

### Run Specific Workflows [#run-specific-workflows]

```bash
# Run CI pipeline
act -W .github/workflows/ci.yml

# Run specific jobs
act -W .github/workflows/ci.yml -j lint-and-format
act -W .github/workflows/ci.yml -j test
act -W .github/workflows/ci.yml -j build
```

## Troubleshooting [#troubleshooting]

### bun Not Found [#bun-not-found]

Use full Ubuntu image with bun pre-installed.

### Network Issues [#network-issues]

```bash
act --network host
```

### Verbose Debugging [#verbose-debugging]

```bash
act --verbose
act --debug
```