git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [Git Enhancement Proposal] Clarify the Role of 'origin' in 'git remote add' Help

From
Ben Knoble <ben.knoble@gmail.com>
Date
Oct 19, 2026, 14:21 UTC
Message-ID
<7C0EC565-CC0D-4CA0-8073-3C3885D86A74@gmail.com>
In-Reply-To
<CAGnq-NQcWHWdDsipyYa5-dvKME71z6e+REratMQf=jUuPxw5uQ@mail.gmail.com>
Show 16 quoted lines
> Le 17 oct. 2026 à 22:42, ceo <xiote78indo@gmail.com> a écrit :
> 
> Hello Git developers,
> 
> I would like to suggest a small improvement to the help message for
> the git remote add command.
> 
> Current Behavior
> 
> When running "git remote add --help" in my environment, the following
> usage information is displayed:
> 
>    usage: git remote add [<options>] <name> <url>
> 
> However, this brief help message does not explain the meaning of
> <name> or the significance of "origin".
Short help is typically terse and focuses on a simple reminder of usage. 
Show 22 quoted lines
> Reason for the Suggestion
> 
> Git uses "origin" as the default remote name when running git clone.
> However, git remote add requires users to explicitly specify a remote
> name.
> 
> This distinction may confuse new Git users, who might not understand
> whether "origin" is a Git-defined default, a required name, or simply
> a user-defined name.
> 
> Proposed Improvement
> 
> I suggest adding a brief explanation to the help message for git
> remote add, such as:
> 
>    <name>  Name assigned to the remote repository.
>            "origin" is the default name used by git clone,
>            but any valid name can be specified.
> 
> This clarification would help users understand the meaning of "origin"
> and the purpose of the <name> argument without changing the command's
> existing behavior.
This kind of thing could be expanded on in the manual for git-remote(1).
Previous: ceo
Message 2 of 2 in “[Git Enhancement Proposal] Clarify the Role of 'origin' in 'git remote add' Help”
  1. ceoOct 18, 2026
  2. Ben KnobleOct 19, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.