Skip to Content
ReferenceCLI Referencealigntrue remotes

aligntrue remotes

Manage remote destinations for rule sync. Use this when you want explicit control over pushes (e.g., with auto: false) or to see routing diagnostics.

aligntrue remotes status

Show configured remotes, routing (by scope/pattern), and last push info.

Usage:

aligntrue remotes status

Behavior:

  • Solo mode: all rules route to remotes.personal unless a rule is scope: shared and a shared remote exists.
  • Team/enterprise: scope: personalremotes.personal; scope: sharedremotes.shared; scope: team stays in repo. Custom remotes are additive in all modes.
  • Detects conflicts where a URL is both a source and a remote.

aligntrue remotes push

Push rules to configured remotes. Useful when you set auto: false on a remote or want an explicit push outside aligntrue sync.

Usage:

aligntrue remotes push [options]

Options:

FlagDescriptionDefault
--dry-runPreview without pushingfalse
--forcePush even if no changes are detectedfalse

Notes:

  • By default remotes push during aligntrue sync unless you set auto: false on the remote.
  • Files can go to multiple remotes when remotes.custom patterns match.
  • For routing details, see Rule sharing & privacy.
Last updated on