CODEWITHSUNDEEP
gitmacos
Agent Friday
Agent Friday

Reputation: 167

Why is there no documentation anywhere for git credential-osxkeychain?

This is really frustrating. Typing git credential-osxkeychain tells me:

usage: git credential-osxkeychain <get|store|erase>

so I know it's installed. But git help credential-osxkeychain says there's no help, and I can find nothing on the web that explains what get, store, and erase actually do.

What I ultimately want to do is get my git passwords stored in the keychain, but that's a different story. I just can't believe there is no documentation for the command.

(Yes, I know this is a "why" question, but obviously I'm asking for where I can find documentation)

Upvotes: 5

Views: 1053

Answers (1)

VonC
VonC

Reputation: 1324935

This feature comes from commit 34961d3, introduced by Jeff King in Dec. 2011 for Git 1.7.9.

And... it did not come with any formal documentation.
You can see more Git Pro Book "Git Tools - Credential Storage", which is the only form of documentation mentioning osxkeychain.

Does this mean it doesn't apply to ssh access? That's what my repo uses

Exactly: any credential helper (osxkeychain or otherwise) would apply only for HTTPS URLs, not SSH.
And SSH needs a cache only if the private key is passphrase-protected (in which case an ssh agent is needed).

Upvotes: 5

Related Questions