# just-fmt

> just-fmt

Check (or apply) `just`'s built-in formatter across every `justfile` and `.just` module in a directory tree. `just --fmt` is still gated behind `--unstable` in current `just`, so `JUST_UNSTABLE` is set for you. Vendored modules (`.just/vendor/`), `node_modules`, and `.venv` are skipped. Run actions/checkout first.

## Inputs

| Input | Required | Default | Description |
|---|---|---|---|
| `working-directory` | no | `.` | Directory to scan for justfiles. |
| `mode` | no | `check` | "check" (fail if any file is unformatted) or "write" (format in place). |

## Usage

```yaml
- uses: actions/checkout@v6
- uses: FSHTech/github-actions/just-fmt@v1
```