NAME

       git-lfs-track - View or add Git LFS paths to Git attributes

SYNOPSIS

       git lfs track [options] [pattern...]

DESCRIPTION

       Start  tracking  the given patterns(s) through Git LFS. The pattern argument is written to
       .gitattributes. If no paths are provided, simply list the currently-tracked paths.

       The  gitattributes  documentation   https://git-scm.com/docs/gitattributes   states   that
       patterns  use  the  gitignore  pattern  rules  https://git-scm.com/docs/gitignore to match
       paths. This means that patterns which contain asterisk (*), question  mark  (?),  and  the
       bracket  characters  ([  and  ]) are treated specially; to disable this behavior and treat
       them literally instead, use --filename or escape the character with a backslash.

OPTIONS

       ○   --verbose -v: If enabled, have git lfs track log files which it will  touch.  Disabled
           by default.

       ○   --dry-run  -d:  If  enabled, have git lfs track log all actions it would normally take
           (adding entries to .gitattributes, touching files on disk, etc) without performing any
           mutative operations to the disk.

           git  lfs  track  --dry-run  [files]  also implicitly mocks the behavior of passing the
           --verbose, and will log in greater detail what it is doing.

           Disabled by default.

       ○   --filename Treat the arguments as literal filenames, not as patterns. Any special glob
           characters in the filename will be escaped when writing the .gitattributes file.

       ○   --lockable  -l  Make the paths 'lockable', meaning they should be locked to edit them,
           and will be made read-only in the working copy when not locked.

       ○   --not-lockable Remove the lockable flag from the paths so they are no longer read-only
           unless locked.

       ○   --no-excluded Do not list patterns that are excluded in the output; only list patterns
           that are tracked.

       ○   --no-modify-attrs Makes matched entries stat-dirty so that Git can re-index files  you
           wish to convert to LFS. Does not modify any .gitattributes file(s).

EXAMPLES

       List the patterns that Git LFS is currently tracking:

       Configure Git LFS to track GIF files:

       Configure Git LFS to track PSD files and make them read-only unless locked:

       Configure Git LFS to track the file named project [1].psd:

SEE ALSO

       git-lfs-untrack(1), git-lfs-install(1), gitattributes(5), gitignore(5).

       Part of the git-lfs(1) suite.

                                             May 2023                            GIT-LFS-TRACK(1)