NQTERM(1)

📦 version 1.0, in alpine 3.24, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 nqterm — the job queue wrapper for tmux/screen, bestie

okay so real talk, this one lives in the General Commands Manual section as nqterm(1), and it is tiny but it is iconic. let's get into it 🫶

✨ NAME ✨

nqterm — job queue wrapper for tmux/screen 👑

🦋 SYNOPSIS 🦋

nqterm command line ...

🌸 DESCRIPTION 🌸

okay so nqterm is a tiny wrapper around the nq(1) job queue, and the way it works is genuinely so cute — it automatically spawns a corresponding nqtail(1) watching process in a new tmux(1) or screen(1) window. like it just does that for you. no cap. ✨

you can cancel the nq(1) job by pressing C-c in the job output window. bye felicia 👋

and after the job has finished, the window will close on C-d. that's it, that's the whole vibe. 🎀

💖 ENVIRONMENT 💖

  • NQDIR — the directory where lock files / job output resides, see nq(1). it's giving "where the paperwork lives" 🗂️

⭐ EXIT STATUS ⭐

The nqterm utility exits 0 on success, and >0 if an error occurs. so if you see a zero, we ate. if you see bigger than zero, something went off and we're crying about it 😭

🌈 SEE ALSO 🌈

nq(1), nqtail(1), screen(1), tmux(1)

like the whole friend group fr fr 💜

👑 AUTHORS 👑

Leah Neukirchen <leah@vuxu.org> — the main character who made this 🫶

🧚 LICENSE 🧚

nqterm is in the public domain.

To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.

http://creativecommons.org/publicdomain/zero/1.0/
not me putting something in the public domain and then being an absolute legend about it 💅

and that's the whole page bestie!! this one shipped with Debian on July 3, 2024 — go queue some jobs and slay 💖✨🦋

📦 where this page comes from