---
name: "git-annex-assist"
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-assist"
---

# git-annex-assist(1)

add files and sync changes with remotes

## NAME

git-annex-assist - add files and sync changes with remotes

## SYNOPSIS

git annex assist **\[remote ...\]**

## DESCRIPTION

This command assists you in checking files into the repository and syncing with remotes. It's the simplest possible way to use git-annex at the command line, since only this one command needs to be run on a regular basis.

This command first adds any new files to the repository, and commits those as well as any modified files. Then it does the equivilant of running \[\[git-annex-pull\](1) followed by [git-annex-push(1)](/git-annex-push/1.md).

This command operates on all files in the whole working tree, even when ran in a subdirectory. To limit it to operating on files in a subdirectory, use the **--content-of** option.

To block some files from being added to the repository, use **.gitignore** files.

By default, all files that are added are added to the annex, the same as when you run **git annex add**. If you configure annex.largefiles, files that it does not match will instead be added with **git add**.

## OPTIONS

- **--message=msg** **-m msg**

  -

  Use this option to specify a commit message.

-

  If multiple -m options are given, their values are concatenated as separate paragraphs.

-

  - **--content-of=path** **-C path**

  Only add, pull, and push files in the given path.

-

  This option can be repeated multiple times with different paths.

-

  - Also all options supported by [git-annex-pull(1)](/git-annex-pull/1.md) and

  [git-annex-push(1)](/git-annex-push/1.md) can be used.

-

  - 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-add(1)](/git-annex-add/1.md)

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

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

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

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

## AUTHOR

Joey Hess \<id@joeyh.name\>