Documentation
¶
Overview ¶
Command git-remote-entire is the git remote helper for entire:// URLs.
Git resolves `git clone entire://host/project/repo` by exec'ing a binary named git-remote-entire on PATH, handing it the remote-helper protocol on stdin and reading responses from stdout. This is a small, dedicated binary (no cobra command tree) that shares the protocol, transport, and auth packages with the main entire CLI.
IMPORTANT: nothing here may write to stdout except the helper protocol itself — git parses stdout as a strict pkt-line stream, so a stray banner or log line corrupts the transfer. Diagnostics go to stderr (and the ENTIRE_DEBUG-gated debuglog).
Authentication resolves the login context for the target cluster from the shared contexts.json: the cluster's cores come from the cluster_cores.json cache (or a live /.well-known fetch on miss), then the account is selected from local contexts. It then mints repo-scoped tokens by exchanging that context's login JWT. A pre-contexts.json login is migrated at read-time so existing users don't have to re-authenticate.
Source Files