himitsud(1)

📦
version 0.10 · 3 versions
, in alpine 3.24

💖 himitsud(1) — the himitsu key ring daemon, but make it make sense 💖

okay bestie, so this is the manual page for himitsud — that's the himitsu(7) key ring daemon, in case you were wondering. yes, the daemon. the little background gremlin that holds all your secrets. iconic behavior honestly 🌸

✨ SYNOPSIS ✨

himitsud [-DR]

that's it. that's the whole vibe check. short, sweet, slays 💅

🦋 DESCRIPTION 🦋

so the himitsud command runs the Himitsu key ring daemon. it sets up a socket at $XDG_RUNTIME_DIR/himitsu, and that socket accepts commands using the himitsu-ipc(5) protocol. think of it as the daemon's little mailbox where all the other programs drop off their requests 📬✨

okay and like, real talk: most users are not gonna talk to it directly. you'll generally use hiq(1) or other clients to interact with it. the daemon is the backstage main character, the clients are the ones doing the talking 💁‍♀️

⚠️ important, do not skip this one: the user must have initialized a key store with himitsu-store(1) before running the daemon. no key store = nothing for the daemon to do. it's giving "showing up to the party before the venue is even rented" 😭

and if you want the general intro to Himitsu as a whole, go read himitsu(7) — that's the big-picture lore, iykyk 🧚

💅 OPTIONS 💅

here's every single flag himitsud recognizes, no cap, not skipping a single one:

  • -C <path> — path to the configuration file to use (peep himitsu.ini(5) for what goes in there). basically "hey bestie, read your settings from here" 🎀
  • -D — daemonize (fork) the himitsud process after startup. it goes off into the background and does its thing, very "i'll be in my room" energy 🚪✨
  • -R fd — notify readiness by writing READY=1n into fd and then closing. so it taps fd on the shoulder, says it's ready, and dips 👋

🌈 SEE ALSO 🌈

go read these too, they're all part of the family:

himitsu(7), himitsu-store(1), hiq(1), himitsu.ini(5), himitsu-ipc(5), himitsu-prompter(5)

👑 AUTHORS 👑

maintained by Drew DeVault <sir@cmpwn.com>, who is assisted by other contributors — shoutout to the whole crew 🫶

up-to-date source code lives at https://git.sr.ht/~sircmpwn/himitsu, and bugs/patches can be submitted by email to ~sircmpwn/himitsu-devel@lists.sr.ht. send the patches, they love that 💜

and that's the whole page, bestie!! 🎉 this version is dated 2026-02-20 — so if you're reading it from the future, hiii, hope himitsud is still slaying on your machine, mwah 💋🌸

📦 where this page comes from