OIDC-AGENT-SERVICE(1)

💅 OIDC-AGENT-SERVICE(1) 💅

okay bestie, welcome to the oidc-agent-service manual page, aka the little cutie that lets you easily restart oidc-agent throughout a whole session. yes. throughout. the whole. session. 🌈

---

✨ NAME ✨

oidc-agent-service — easily restart oidc-agent throughout a session 🦋

---

🌸 SYNOPSIS 🌸

oidc-agent-service use | start | restart | restart-s | stop | kill

---

💖 DESCRIPTION 💖

oidc-agent-service — Easily restart oidc-agent.

like, that's the whole assignment. she's here so you don't have to manually babysit your agent all session long. iconic behaviour, no notes. 👑

Commands:

• use — Starts the agent, and if the agent is already running, she just reuses that agent. lowkey the most chill option. 🫶
• start — Starts the agent, but if the agent is already running it fails. no sharing, no negotiating. 💀
• restart — Restarts the agent. simple. clean. slay. ✨
• restart-s — Restarts the agent, but does not print any output. the silent treatment, but make it functional. 🤫
• stop — Stops the agent. bye bestie 👋
• kill — Stops the agent. yes it's also a stop. she has two names and both of them eat. 💅

---

🎀 FILES 🎀

• /tmp/oidc-agent-service/$UID/oidc-agent.pid — oidc-agent-service creates a symlink from this file to the active agent's socket. The symlink gets updated whenever the agent is restarted. so it always knows where her girl is at. 🔥
• /etc/oidc-agent/oidc-agent-service.options — This file holds the options that configure the behaviour of oidc-agent-service, e.g. you can use it to configure the command line options with which the agent should be started. It is also used to disable Xsession integration. very main character config file energy. 👑
• $OIDCAGENTDIR/oidc-agent-service.options — The user-space version of /etc/oidc-agent/oidc-agent-service.options. Any value specified in this file overwrites the value defined in the global version. user space said "my turn". 💅

---

🌟 EXAMPLES 🌟

Starts the agent:

eval `oidc-agent-service use`

Stops the agent:

eval `oidc-agent-service stop`

Restarts the agent:

eval `oidc-agent-service restart`

Restarts the agent without printing any information (silent mode):

oidc-agent-service restart-s

---

💜 SEE ALSO 💜

• oidc-agent(1)
• 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-agent-service/

---

and that's the whole page, bestie!! this one was written by echo back in September 2026, and it's page OIDC-AGENT-SERVICE(1) of the manual — go forth and restart your agent with confidence. periodt. 💖✨🎀🦋