# tj-actions/changed-files

:octocat: Github action to retrieve all (added, copied, modified, deleted, renamed, type changed, unmerged, unknown) files and directories.

Repository: https://github.com/tj-actions/changed-files
Canonical: https://ross.abutalabs.com/products/changed-files
Language: TypeScript
License: MIT
License Family: permissive
Topics: github, changed-file, modified, actions, modified-files, github-actions, workflows, ci-cd, change-detection, monorepo, submodules, ci, continuous-integration, continuous-delivery, changed-files, change-detetion, conditional-execution, restore-files, yaml-files
Last push: 2026-08-07T01:37:47+00:00

## Health v2 (maintenance only)
Score: 91/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 96, release rhythm 80, longevity 100
- inputs: {"age_days": 2008, "days_push": 27, "days_rel": 137, "gap_med": 0.0, "n_releases_24m": 21}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2717, forks 333 (observed 2026-08-28T04:07:12.152184+00:00)

## What it is
A GitHub Action that detects all added, copied, modified, deleted, renamed, and type-changed files and directories relative to a target branch, commit, or previous commit. It outputs relative paths so workflows can conditionally run jobs in CI pipelines, especially in monorepos.

## Use cases
- run tests only when relevant files changed in a pull request
- detect changed files in a monorepo to trigger per-package builds
- get list of modified files on push events in a GitHub workflow
- conditionally deploy services based on which directories changed
- skip CI steps when only documentation files changed
- track renamed or deleted files between commits in a workflow

## When to choose
- you need change detection inside GitHub Actions workflows
- you maintain a monorepo and want conditional job execution
- you need file change lists across pull_request, push, merge_group, or release events

## When to avoid
- you need to detect uncommitted changes created during the workflow run (use tj-actions/verify-changed-files)
- you are not using GitHub Actions as your CI system
- you need change detection outside of git-based repositories

## Facets
- artifact type: plugin
- maturity: active
- function: ci-cd, developer-tools, file-system
- domain: developer-tools
- platform: windows, cloud
- tags: github-actions, change-detection, monorepo, pull-request, continuous-integration, devops, automation, linux, macos

## Member repositories
- tj-actions/changed-files (main) score 91

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:12.152184+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:15:20.783996+00:00, confidence not recorded.
  - readme: https://github.com/tj-actions/changed-files (fetched 2026-08-28T04:07:12.152184+00:00, sha fe9656ce43a0)
- Data as of 2026-08-30T08:39:29.467469+00:00.