Skip to content

auto-pull

Usage
auto-pull [list]
auto-pull add [PATH]
auto-pull remove <NAME|PATH>
auto-pull status

Manages the auto-pull registry: the list of repositories that are background fast-forwarded when you enter them (see conf.d/auto-pull.fish and _auto_pull_sync). The fish-config repo is always covered as a baseline and does not need to be added. The registry is a plain text file, one absolute git-toplevel path per line, stored machine-locally at $__fish_user_dots_path/auto-pull.list (defaults to ~/.config/.user-dots/fish/auto-pull.list) and never committed.

Registry management works regardless of the C2 auto-execution guard; only the background sync itself is gated by __fish_config_op_autoexec.

Arguments:
list Show registered repos (default when no subcommand given)
add [PATH] Register PATH's git root; defaults to the current repo
remove <NAME|PATH> Unregister by basename or exact path
status Show enabled/disabled state, repo count, and registry path
-h, --help Show this help message

Returns:

0 Subcommand succeeded
1 Bad usage, target is not a git repo, or target not registered
Examples
cd ~/src/qmk_firmware; and auto-pull add
auto-pull add ~/work/api
auto-pull list
auto-pull remove qmk_firmware