# `mix tinfoil.homebrew`
[🔗](https://github.com/joshrotenberg/tinfoil/blob/v0.2.22/lib/mix/tasks/tinfoil.homebrew.ex#L1)

Render the Homebrew formula from the release artifacts in the input
directory and push the result to the configured tap repo.

Runs on a separate CI job after `mix tinfoil.publish` has created
the GitHub Release. The heavy lifting lives in `Tinfoil.Homebrew`;
this task is just a thin Mix wrapper.

## Required environment

  * `GITHUB_REF_NAME`     — release tag (`v1.2.3`)
  * `HOMEBREW_TAP_TOKEN`  — only when `homebrew.auth` is `:token`

When `homebrew.auth` is `:deploy_key`, set up an `ssh-agent` with
the tap's deploy key before invoking the task (see README).

## Flags

  * `--input-dir DIR`  — directory containing release tarballs and
    `.sha256` sidecars (default `"artifacts"`)
  * `--tag VALUE`      — override `GITHUB_REF_NAME`
  * `--dry-run`        — render the formula and print what would be
    pushed (tap, clone URL with tokens redacted, commit message,
    full formula contents) without touching the tap repo

---

*Consult [api-reference.md](api-reference.md) for complete listing*