Without --mirror, this command will create new refs under remotes/REMOTE/ directory for each pulled branch unless they are already created. Such refs can be then referenced by REMOTE:BRANCH in ostree subcommands (e.g. ostree log origin:exampleos/x86_64/standard).
This command can retrieve just a specific commit, or go all the way to performing a full mirror of the remote repository. If no BRANCH is specified, all configured branches are retrieved.
A special syntax in the @ character allows specifying a specific commit to retrieve from a branch. The use cases for this are somewhat similar to pulling a specific git tag; one could e.g. script a system upgrade to a known-good version, rather than the latest from the content provider.
$ ostree --repo=repo pull --depth=-1 --mirror remote_name
Perform a complete mirror of the remote. (This is likely most useful if your repository is also archive mode)
$ ostree --repo=repo pull remote_name exampleos/x86_64/standard
Fetch the most recent commit to exampleos/x86_64/standard.
$ ostree --repo=repo pull remote_name exampleos/x86_64/standard@98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4
Download the specific commit starting with 98ea6e as if it was the latest commit for exampleos/x86_64/standard.