WAYPROMPT-SSH-ASKPASS(1)

🦋 WAYPROMPT-SSH-ASKPASS(1) — like, the manual page, but make it make sense 💅

okay so bestie, gather round, because this is the manual page for wayprompt-ssh-askpass, and it lives in the General Commands Manual section (section 1, iykyk — commands you actually type).

---

✨ NAME ✨

wayprompt-ssh-askpass — a Wayland-native ssh-askpass implementation. yes. that's the whole vibe. it's giving "askpass but make it Wayland" 🎀

---

✨ SYNOPSIS ✨

wayprompt-ssh-askpass

literally that's it. no flags, no args, no drama. she just runs. 🫶

---

✨ DESCRIPTION ✨

so the wayprompt-ssh-askpass executable that this very manual page is describing is, like, the ssh-askpass implementation built on top of wayprompt. iconic behaviour honestly.

if you want the general tea on wayprompt itself — what it is, how it works, all that — go read wayprompt(1). she's the main character, this page is the spin-off. 👑

---

✨ USE WITH SSH ✨

okay so here's where it gets real. to use wayprompt-ssh-askpass as the askpass program for ssh(1) — and for the programs that wrap it, like git(1) or rsync(1) — you gotta set and export the SSH_ASKPASS env var, and point it at the path to the wayprompt-ssh-askpass executable. no cap, both steps, "set" and "export", don't skip the export. 😤

but wait, there's a catch (there's always a catch bestie): by default, ssh will only use the askpass program you configured if it is not attached to a terminal. so if you're in a terminal she's like "no thanks, I'll just prompt you myself".

to force ssh to always use the askpass program, set and export:

SSH_ASKPASS_REQUIRE=force

and then she has no choice. slay. 💅

---

✨ RETURN VALUE ✨

wayprompt-ssh-askpass will exit with one of these values, and you will respect them:

• 0 — the user triggered "ok". and how? either by pressing Enter or by clicking the button. both valid, both blessed. ✅
• 1 — the user triggered "cancel". either by pressing Escape or by clicking the button. or — plot twist — an error occured. 😭 yeah, cancel and error share a home, that's just how it is.

fr fr, if you get a 1 you can't tell from the exit code alone whether your bestie hit Escape or whether something genuinely broke. that's canon, not me being dramatic. 💀

---

✨ AUTHOR ✨

Leon Henrik Plickat 🌸 — the genius behind all of this, we stan.

---

✨ SEE ALSO ✨

wayprompt(1), wayprompt(5), ssh(1) — go read them, they're the supporting cast and they ate. 📚

---

aaand that's the whole page, bestie! 🧚 source/version: git.sr.ht/~leon_plickat/wayprompt, dated 2024-03-19, and it's a WAYPROMPT-SSH-ASKPASS(1) situation through and through. mwah 💖