hissh-agent(1)

💅 hissh-agent — the SSH agent that's literally serving your himitsu keys

ok so bestie, hissh-agent is a whole SSH agent that hands out access to the SSH keys chillin' in your himitsu(7) key store. that's the vibe. it's in the General Commands Manual, and yes she's iconic ✨

---

✨ SYNOPSIS ✨

hissh-agent [-R fd]

🌸 DESCRIPTION 🌸

so hissh-agent rolls up and drops an SSH agent socket right at $XDG_RUNTIME_DIR/hissh-agent. that's her spot, that's her main character location 🎀

then you, the user, gotta point SSH_AUTH_SOCK at that path. like so:

hissh-agent &
export SSH_AUTH_SOCK=$XDG_RUNTIME_DIR/hissh-agent

and boom — the SSH keys you've got stored in the Himitsu key store get provided automatically 🪄 no cap. want to add new keys? that's hissh-import(1)'s whole job, go say hi.

💡 lowkey important: it's recommended that you run these commands for your entire session using a suitable system-specific service manager or startup script. like, don't be doing this per-terminal, bestie, do it properly the first time.

---

👑 OPTIONS 👑

these are the options hissh-agent recognizes:

• -R fd — notify readiness by writing READY=1n into fd and then closing. that's it, that's the flag. she's a one-trick queen 💅

---

🦋 CONFIGURATION 🦋

the agent can be configured in the himitsu config himitsu.ini(5), which lives at $XDG_CONFIG_HOME/himitsu/config.ini 📁

the options related to remembering consent go into the [ssh.remember] section. here's what you can put in there:

• persist — a comma separated list of remember options that get passed to the prompter when requesting persistent access to the proto=ssh query. leaving this option blank is equivalent to skip and will cause the agent to skip this request entirely.

possible options are session, skip, refuse, or a timeout in seconds as an integer. let's break it down fr fr:

• session remembers consent until himitsu or hissh-agent terminates
• skip postpones the decision until the next prompt
• refuse denies the request — and future requests won't be shown 🙈

the first value will be considered the default one by the prompter.

default value, if the option is omitted: session,300,refuse

• disclose — a comma separated list of remember options that are passed to the (prompter) when requesting private key disclosure (e.g.: in signing operations). leave blank if not applicable.

uses the same syntax as the persist option.

default value, if the option is omitted: skip,session,300

🧚 EXAMPLE 🧚

the following example skips remembering. simple, clean, boundaries set 💖

[ssh.remember]
persist=skip
disclose=skip

---

🔥 SEE ALSO 🔥

hissh-import(1), hissh-export(1)

---

💜 AUTHORS 💜

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

up-to-date source code can be found at https://git.sr.ht/~sircmpwn/himitsu-ssh, and bugs/patches can be submitted by email to ~sircmpwn/himitsu-devel@lists.sr.ht 🐛

---

and that's the page, bestie! this little gem is from the General Commands Manual — hissh-agent(1) — and it's dated 2026-03-23. go forth, export that socket, and slay your SSH session 💅✨