OIDC-KEYCHAIN(1)

πŸ’– OIDC-KEYCHAIN πŸ’–

okay so bestie, welcome to oidc-keychain (section 1, User Commands, we're fancy like that) β€” the little script whose whole entire job is letting you re-use oidc-agent across logins. no cap. she's the friend who holds your stuff while you're gone and hands it back exactly how you left it. 🫢


✨ SYNOPSIS ✨

oidc-keychain [-?|--help|--usage|-V|--version] [-k|--kill]
oidc-keychain [oidc-agent options] [--accounts ACCOUNT ...]

🌸 DESCRIPTION 🌸

oidc-keychain β€” Re-use oidc-agent between logins</p>. that's the whole vibe. iconic behaviour, honestly.

anything you pass that's an oidc-agent option gets handed straight over to oidc-agent when she starts up. so you're basically the messenger, and the message is options. πŸ’…

🫢 General

  • -k, --kill β€” kills oidc-agent if she's currently running. like closing the group chat. bye bestie πŸ’€
  • --accounts ACCOUNT ... β€” loads the *ACCOUNT*s, but only if they're not already loaded. she's not doing extra work for no reason.

πŸŽ€ Help

  • -?, --help β€” gives you this help list. the whole thing. every crumb. πŸ“
  • --usage β€” gives you a short usage message. the tl;dr version, for when you're in a rush.
  • -V, --version β€” prints the program version. show some respect for her age. πŸ‘‘

πŸ¦‹ FILES πŸ¦‹

  • ~/.config/oidc-agent/.keychain or ~/.oidc-agent/.keychain β€” this is where oidc-keychain stores the configuration of a running oidc-agent. one of these two files, whichever she's feeling. it's giving ✨*where did I put my keys*✨ energy, except she actually knows where they are.

🌈 EXAMPLES 🌈

lowkey the best part. here's how you actually use her:

  • oidc-keychain

starts oidc-agent if she's not already started, and then prints out the commands you need for setting the required environment variables. note: it prints them β€” you still gotta do something with them, bestie.

  • eval `oidc-keychain --accounts myaccount`

starts oidc-agent if she's not already started, loads the myaccount account if it's not already loaded, and sets the required environment variables β€” only for this shell. just this one. don't get any ideas. 🐚

  • eval `oidc-keychain -k`

kills a running oidc-agent and unsets the environment variables from this shell. the reverse uno card. ✨


πŸ’œ SEE ALSO πŸ’œ

Low-traffic mailing list with updates such as critical security incidents and new releases:

https://www.lists.kit.edu/sympa/subscribe/oidc-agent-user

Full documentation can be found at:

https://indigo-dc.github.io/oidc-agent/usage/oidc-keychain/
fr fr go subscribe to the mailing list, it's low-traffic and it tells you about critical security stuff. that's not a vibe, that's a necessity. πŸ”₯

okay that's the whole page bestie, you ate that πŸ’… this was OIDC-KEYCHAIN(1) from September 2026 β€” and yes, the original footer also had this little gremlin artifact just vibing in it, so I'm preserving the evidence verbatim: oidc-keychain: line 53: oidc-... 😭 truly the main character of typos. stay hydrated, set your env vars, and unset them when you're done. mwah πŸ«ΆπŸ’–βœ¨

πŸ“¦ where this page comes from