> For the complete CircleCI developer hub index, see [llms.txt](https://circleci.com/developer/llms.txt)

# dnephin/multirepo

Multirepo and monorepo support for CircleCI.

Source: https://github.com/dnephin/multirepo-orb

Use the `multiorb/run-job-for-paths` command in each job that should be
run when the paths change. Only the job itself will be halted, so all
subsequent jobs in the workflow must call the same command.


## Commands

### run-job-for-paths

Continue running the job if any file in paths has been modified since
the last commit shared with the upstream git branch (default: origin/master).

This command must be run after `checkout`.

This command allows you to skip all of the subsequent steps in a job so that any
repository with multiple workflows, or multiple flows within a single
workflow, will only run CI jobs relevant to the files that changed.

If you have a multipurpose git repository with independent directory trees
this command allows you to run the tests for only the services which have been
modified relative to the upstream branch.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `paths` | string |  | A list of file paths used with 'git diff' to check for modification.
 |
| `upstream_branch` | string | origin/master | The upstream branch used with 'git merge-base' to find the most recent
commit shared by HEAD and the upstream branch.
 |
| `working_directory` | string | $PWD | Directory to change to before executing the command.
 |
| `run_on_upstream` | boolean | true | When run_on_upstream is true, and HEAD matches the upstream_branch the
job always run. When false the job will not run when HEAD matches
the upstream_branch.
 |