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.

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:

SEE ALSO

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

       Part of the git-lfs(1) suite.

                                                  December 2019                                 GIT-LFS-TRACK(1)