SHADOWENV(1)

πŸ“¦ version 3.5.2, in nixos 26.05, nixpkgs unstable

🌸 NAME 🌸

shadowenv(1) β€” from the General Commands Manual, bestie β€” is literally here to manipulate environment variables as you change directories. πŸ’…


✨ SYNOPSIS ✨

shadowenv [-h|-V] subcommand

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so shadowenv provides a way to perform a set of manipulations to the process environment upon entering a directory in a shell. These manipulations are reversed when leaving the directory, and there is some limited ability to make the manipulations dynamic. periodt. πŸ’–


πŸ‘‘ SUBCOMMANDS πŸ‘‘

diff [-hnv]

Display a diff of changed environment variables.

  • -n, --no-color β€” Do not use color to highlight the diff.
  • -v, --verbose β€” Show all environment variables as context to the diff.

exec [--dir <dir>] <child-argv0|-- child-argv...>

Execute a command after loading the environment from the current directory.

  • --dir <dir> β€” Instead of searching from the current directory for a .shadowenv.d, search from this one.
  • child-argv0 β€” If the command doesn't need arguments, it can be passed directly as the last argument.
  • child-argv... β€” If the command requires arguments, the command and all arguments must be passed after a --.

hook [FLAGS] [OPTIONS]

Runs the shell hook. You shouldn't need to run this manually; instead, source the output of shadowenv init to create the shell hooks that will use this command. 🫢

  • --fish β€” Format variable assignments for fish shell.
  • --porcelain β€” Format variable assignments for machine parsing.
  • --silent β€” Suppress error printing.
  • --shellpid pid β€” Rather than looking up the PPID, use this as the shell's pid.

init shell

Prints a script which can be eval'd to set up shadowenv in various shells.

  • bash β€” Prints a script which can be eval'd by bash to set up shadowenv.
  • fish β€” Prints a script which can be eval'd by fish to set up shadowenv.
  • zsh β€” Prints a script which can be eval'd by zsh to set up shadowenv.

trust

Mark this directory as 'trusted', allowing shadowenv programs to be run. πŸ‘‘

prompt-widget

Print a little glyph you can include in a shell prompt to indicate that shadowenv is active. ✨


πŸ’… FLAGS πŸ’…

  • -h, --help β€” Prints help information β€” can also be used for more specific help with any of the subcommands.
  • -V, --version β€” Prints the current shadowenv version.

okay that's the whole SHADOWENV(1) page from the General Commands Manual, bestie β€” the source footer here only gives us that manual-name line, with no version/date line to report, so this is your cute sparkly sign-off instead: stay iconic, stay trusted, and may your env vars always slay πŸ’–βœ¨πŸ¦‹πŸ’…

πŸ“¦ where this page comes from