Arguments. [<dir>...] [--root <dir>] [--repo <dir>] [--skip <name>] [--config <file>] [--apply] [--yes]. Full form: [...] [--root ] [--repo ] [--named ] [--repos-from <file|->] [--skip ] [--extend-skip ] [--skip-from ] [--config ] [--dry-run] [--apply] [--yes]
Purpose
/repo-fleet-hygiene:audit is read-only. /repo-fleet-hygiene:apply deletes merged branches.
This skill is the sync verb: each canonical checkout switches to the remote's current default
branch (git ls-remote --symref origin HEAD) and pull --ff-onlys it. Dirty work on a
non-default branch, and a dirty default branch, is parked in a linked worktree by the
worktree-create.sh helper you name with --worktree-create.
Scope ladder
First hit wins:
- Explicit
--repo,--root, a bare path, or--repos-from <file|->(one checkout path per line,-reads stdin, blank lines ignored).--root,--repo, and--namedrepeat. - Fleet config (
--config, else the project file, else~/.claude/repo-fleet-hygiene.conf). --namedpaths from the conversation.ghq root --all(every root), whenghqis installed.- The nearest of the 4 parents above the working directory's checkout (above the working directory itself outside a checkout) that directly holds 2 or more Git repositories. A run inside one checkout therefore covers its sibling fleet.
- The checkout holding the working directory, when no such parent exists.
- Exit 3. The message names the rungs. The project directory is not an implicit repo.
/repo-fleet-hygiene:audit uses the same fallback when it has no explicit or config scope.
Claim: ghq root --all prints every configured root. Basis: the
ghq README (ghq root [--all]; "Without '--all' option,
the primary one is shown") and ghq help root on ghq 1.10.1 ("--all Show all roots"). As of:
2026-11-10. Recheck: the README's root entry drops or renames --all.
Every plan line and every skipped line ends with rung=<rung>, the rung that produced that
repository: repo, repos-from, root (a bare path counts as --root), config, named, ghq,
cwd, or ancestor. A repository found by walking a root carries that root's rung. Read the rung
before applying: ghq, cwd, and ancestor mean no scope was given.
Skip flags
--skip, --extend-skip, and --skip-from <file> (one name per line, blank lines ignored, CRLF
stripped, a missing file exits 2) and the config keys fleet.skip and fleet.skipAppend prune
directories during discovery with the same semantics as
/repo-fleet-hygiene:audit: an explicit --skip set replaces the default,
--extend-skip adds to whichever set is in effect, and names are bare directory names.
The skip set does not filter --repo or --repos-from paths. To leave out one repository found under
a root, pass --extend-skip <its directory name>; --skip also drops the default names.
Discovery under a root is the walker /repo-fleet-hygiene:audit runs
(fleet-discovery.sh, shared by both verbs): it stops at the first checkout on each path, does not follow
symlinked directories, and goes 5 levels deep unless the config's fleet.maxDepth (1 through 12)
says otherwise.
Confirmation
| Flags | Behavior |
|---|---|
(default), or --dry-run |
Dry-run plan. Nothing changes. --dry-run with --apply exits 2. |
--apply on a terminal |
One prompt for the whole plan. Decline changes nothing. |
--apply without a terminal |
Exit 3. Nothing changes. |
--apply --yes |
Apply. |
--yes skips the script's prompt, not the user. Pass it only after you have shown the user the
dry-run plan (its repos: count and each repo's action row) and the user has
explicitly said to go ahead. This holds in non-terminal runs too: no terminal is never consent.
Non-fast-forward, dubious ownership, and a partial stash apply are skipped and reported. The script does not reset a branch.
Parking flags, not in argument-hint:
--worktree-create <path>: the helper, which this skill never looks for. Give the path of the source-control plugin'sworktree-create.sh. The file must exist and be namedworktree-create.sh, or the run exits 2. The helper is called with--existing-branch, which checks out the branch that already holds the work.--worktree-root <dir>: optional. Without it the helper resolves the root from each repository'sworktreeroot.path(includeIfapplies). A repository with none makes the helper exit 3; that repo is put back as it was, skipped, and the remedy quotes the helper's first message line.
Without --worktree-create, a dirty repo is planned skip ... worktree-create-missing and nothing is
stashed. Park it by hand with /source-control:worktree create --existing-branch, or commit or
stash the work.
Run:
${CLAUDE_SKILL_DIR}/scripts/sync-fleet.sh --project-dir "${CLAUDE_PROJECT_DIR}" [--worktree-create <path>] [--worktree-root <dir>] <quoted-arguments>
Next
/repo-fleet-hygiene:audit after canonical checkouts are on their default branches.
Gotchas
- A clean non-default branch is checked out away from, not deleted. The branch remains.
pull --ff-onlyrefuses a history that diverged. That repo is skipped.- Do not point this at
repo-hygiene:clean tree-batch. That verb is destructive and is not this skill.