---
name: "git-annex-find"
section: "1"
platform: "linux"
package: "git-annex"
version: "10.20261026-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/git-annex-find"
---

# git-annex-find(1)

lists available files

## NAME

git-annex-find - lists available files

## SYNOPSIS

git annex find **\[path ...\]**

## DESCRIPTION

Outputs a list of annexed files in the specified path. With no path, finds files in the current directory and its subdirectories.

## OPTIONS

- matching options

  -

  The [git-annex-matching-options(1)](/git-annex-matching-options/1.md) can be used to specify files to list.

-

  By default, the find command only lists annexed files whose content is currently present. Specifying any of the matching options will override this default behavior.

-

  To list all annexed files, present or not, specify **--anything**.

-

  To list annexed files whose content is not present, specify **--not --in=here**

-

  - **--branch=ref**

  List files in the specified branch or treeish.

-

  - **--print0**

  Output filenames terminated with nulls, for use with **xargs -0**

-

  - **--format=value**

  Use custom output formatting.

-

  The value is a format string, in which '${var}' is expanded to the value of a variable. To right-justify a variable with whitespace, use '${var;width}' ; to left-justify a variable, use '${var;-width}'; to escape unusual characters (including control characters) in a variable, use '${escaped\_var}'

-

  These variables are available for use in formats: file, key, backend, bytesize, humansize, keyname, hashdirlower, hashdirmixed, mtime (for the mtime field of a WORM key).

-

  Also, '\\n' is a newline, '\\000' is a NULL, etc.

-

  The default output format is the same as **--format='${file}\\n'**, except when outputting to a terminal, control characters will be escaped.

-

  - **--json**

  Output the list of files in JSON format.

-

  This is intended to be parsed by programs that use git-annex. Each line of output is a JSON object.

-

  - **--json-error-messages**

  Messages that would normally be output to standard error are included in the JSON instead.

-

  - **--batch**

  Enables batch mode, in which a file is read in a line from stdin, its information displayed, and repeat.

-

  Note that if the file is not an annexed file, or is not present, or otherwise doesn't meet the matching options, an empty line will be output instead.

-

  - **-z**

  Makes the **--batch** input be delimited by nulls instead of the usual newlines.

-

  - Also the [git-annex-common-options(1)](/git-annex-common-options/1.md) can be used.

  ## SEE ALSO

[git-annex(1)](/git-annex/1.md)

[git-annex-whereis(1)](/git-annex-whereis/1.md)

[git-annex-findkeys(1)](/git-annex-findkeys/1.md)

## AUTHOR

Joey Hess \<id@joeyh.name\>