PRWD(1)

📦 version 1.9.1, in epel 10, epel 9, fedora 43, fedora 44

🎀 NAME 🎀

prwd — universal shell prompt 💅

✨ SYNOPSIS ✨

prwd [-aVh]

🦋 DESCRIPTION 🦋

okay bestie, listen. prwd is literally a replacement for your shell's PS1. it hands you a whole simple templating language, with commands, so you can customize your prompt however you want. obsessed. 🫶

the whole point? your prompt stays consistent between shells, and it gives you fast template commands to show off contextual info — think hostname, path, the current git/hg branch — without an inordinate amount of slow, sluggish shell scripting dragging your whole terminal down. no cap, it's giving efficiency. ✨

The command-line options are as follows:

  • -V — show current version. that's it, that's the tweet. 🎀
  • -h — show usage. your lil help menu, bestie.
  • -t template — use the template you hand it instead of the one defined in the configuration file, or the one defined in the environment variable PRWD. this is especially useful for testing out a new template before you commit to it. 💅
pro tip from me to you: wrap your template in single quotes (') so your shell doesn't go and expand the $ variable on you. she will do it. she always does. 😭
  • -a — outputs all the aliases starting with $ as shell variable exports. the output from this command is meant to be used with eval in your .profile file. want the full tea? go read the ALIAS VARIABLES section in the prwdrc(5) manual, it's all laid out there in detail. 🔥

🌸 ENVIRONMENT 🌸

prwd can read its template from a configuration file, from command-line parameters, or from this environment variable right here:

  • PRWD — the template used to render your prompt. this value will override the default internal template, and can be overridden by the configuration file. so it's like, the middle child of the priority order. 🙈

💖 FILES 💖

  • ~/.prwdrc — defines all the configuration, and overrides both PRWD and the internal defaults. for the configuration syntax and parameters, go see prwdrc(5). 🎀

🌈 SETUP 🌈

bestie you're gonna need to place this line in your ~/.profile (your mileage may vary, as always 🫶):

export PS1='`prwd`'

⭐ SEE ALSO ⭐

prwdrc(5), pwd(1), csh(1), ksh(1), sh(1), getcwd(3)

👑 AUTHORS 👑

prwd was written by Bertrand Janin <b@janin.com> and is distributed under an ISC license (BSD compatible, OSI compatible). iconic behavior honestly. 💜

and that's the whole page, bestie — this Debian build of the manual is dated May 9, 2013, so go forth and make your prompt the main character. slay. 💅✨🎀

📦 where this page comes from