Git Remotes

🚀Git Remotes

Active + Optional Key

Name one fallback remote and separate authoritative destinations from mirrors or archives.

Command[tool.custy.git]

📦Category

Git Configuration

🚀Quick Command

[tool.custy.git]

---

originprimarybackup

---

📋

Generated Remote Keys

2

📝

Optional Remote Key

1

🌿

Primary Default

origin

🛡️

Backup Default

Empty

Properties

📋Properties

Property	Type	Description	Default	Required
default_remote	Remote name string	Fallback when a main-group push has no main_remotes and no explicit --remote. Use a name reported by git remote, not a URL.	origin	No
main_remotes	Remote name array	Authoritative destinations for group-aware push flows.	["origin"]	No
backup_remotes	Remote name array	Optional mirror or archive destinations for group-aware push flows. Supported but commented out in the generated file.	[]	No

Multi-host setup

toml

[tool.custy.git]
default_remote = "origin"
main_remotes = ["origin", "gitlab"]
backup_remotes = ["mirror"]

ℹ️These values are Git remote names

origin, gitlab, and mirror are local aliases configured by Git. They are different from tool.custy.changelog.links.repository, which must be a full HTTP(S) browser URL and is used only inside the generated changelog.

🛡️Verify names and URLs before pushing

Run git remote -v, confirm authentication and branch protection, and ensure each configured name is actually present in the repository.

Continue

🚀Related Commands

Commands commonly used together with this command.

Push Strategy

Select main, backup, or all.

CLI Push

Configure all_remote and tag behavior.

Push Remotes

Review command-level remote selection.