Skip to content

Latest commit

 

History

History
86 lines (57 loc) · 2.58 KB

File metadata and controls

86 lines (57 loc) · 2.58 KB

🕵️‍♂️ private.fish

A lightweight Fish shell extension to indicate private mode sessions in your prompt with a ghost icon 👻. Each terminal session is tracked independently, and the icon can show a per-terminal activity count.

🚀 Features

  • Private mode indicator: Shows a ghost icon 👻 in the prompt for private Fish sessions.
  • Per-terminal session tracking: Counts actions/outputs per terminal, independent of other terminals.
  • Customizable behavior via universal variables: control symbol and count display.
  • Automatic prompt wrapping: Works with any Fish prompt without modifying it manually.

⚙️ Installation

Install using fisher:

fisher install devmor-j/private.fish

Fish will automatically detect private mode and display the ghost icon in your prompt.


📝 Configuration / Defaults

Variable Default Description
private_symbol 👻 The icon used for private sessions.
private_show_count true Show a numeric count next to the ghost icon.

You can override defaults by setting these variables in your Fish config (config.fish) before loading private.fish. Example:

set -U private_symbol "🔒"
set -U private_show_count false
set -U root_symbol "🔥"

If you need more space between emojies, add them on the variable itself.

🔒 Emojis

Here are some emojis you can use for private mode:

  • 👻 Ghost (default)
  • 🔒 Lock
  • 🔑 Key
  • 🐡 Pufferfish
  • 🦈 Shark
  • 🐙 Octopus

And some root related emojies when in root mode:

  • 🔥 Fire (default)
  • ☠️ Skull
  • 🛡️ Shield
  • ⚡️ Lightning
  • 💥 Explosion
  • 👑 Crown

💡 Usage

  1. Open a Fish terminal in private mode:
fish -P
# or fish --private
  1. You’ll see the ghost icon 👻 in your prompt.
  2. If you have multiple commands recorded in the session and private_show_count=true, the icon will show the count, e.g., 👻3.
  3. Each terminal is independent, so counts don’t interfere with each other.

Note: Will show "🔥" icon (fire is default) when root user is active. So you'd be more careful since you have full access.

📝 License

MIT License. Free to use and modify.

This plugin was developed with AI assistance; Expect bugs and compatibility issues until they are fixed.