# git apply Command: Apply Patches in CI

> git apply applies a patch to the working tree or index. Reference for --check, --3way, and --index used to apply diffs safely in automated pipelines.

Source: https://latchkey.dev/learn/command-reference/git-apply-command-reference  
Updated: 2026-06-26

git apply takes a unified diff and applies it to files, without creating a commit.

When CI patches a file (for example to inject a generated change or apply a vendor fix), git apply applies a diff cleanly and can verify it first. Unlike am, it does not make commits.

## Common flags

- `--check` - verify the patch applies cleanly without changing anything
- `--index` - apply to both the working tree and the index (so it is staged)
- `--3way` - fall back to a three-way merge when context does not match
- `-p<n>` - strip n leading path components from filenames in the patch
- `--reverse` / `-R` - undo a previously applied patch
- `--reject` - apply what it can and write .rej files for the rest

## Example

```shell
# Verify, then apply and stage a patch in CI
git apply --check fix.patch
git apply --index fix.patch
```

## In CI

Run git apply --check first so the job fails fast with a clear message if a patch is stale, rather than half-applying. Use --3way for resilience when the base has drifted, and --index when the change should be staged for an automated commit.

## Using this in CI

CI checkouts are shallow and detached by default, which changes the answer this command gives you. Commands that read history, branch names, or tags need the checkout configured for it.

```.github/workflows/ci.yml
- uses: actions/checkout@v4
  with:
    fetch-depth: 0   # history, tags, and git describe all need this

- run: |
    git rev-parse --is-shallow-repository   # expect false
    git rev-parse --abbrev-ref HEAD          # prints HEAD when detached
```

> `git rev-parse --abbrev-ref HEAD` returns the literal string `HEAD` on a detached checkout rather than a branch name. On GitHub Actions read `github.ref_name` instead; the git command cannot know what it was checked out for.

## FAQ

### git apply Command: Apply Patches in CI?

When CI patches a file (for example to inject a generated change or apply a vendor fix), git apply applies a diff cleanly and can verify it first. Unlike am, it does not make commits.

### In CI?

Run git apply --check first so the job fails fast with a clear message if a patch is stale, rather than half-applying. Use --3way for resilience when the base has drifted, and --index when the change should be staged for an automated commit.

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt