Skip to content

A lightweight Fish shell extension to indicate private mode sessions in your prompt with a ghost icon πŸ‘»

License

Notifications You must be signed in to change notification settings

devmor-j/private.fish

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ•΅οΈβ€β™‚οΈ 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

πŸ”’ Privacy Emojis

Here are some emojis you can use for privacy indicators:

  • πŸ‘» Ghost (default)
  • πŸ”’ Lock
  • πŸ”‘ Key
  • πŸ—οΈ Old Key
  • πŸ” Closed Lock With Key
  • πŸ›‘οΈ Shield
  • πŸ•΅οΈβ€β™‚οΈ Detective
  • πŸ•ΆοΈ Sunglasses / Incognito
  • 🏠 House / Private Space
  • πŸ“ Hidden Note
  • πŸ™ˆ See-No-Evil Monkey
  • 🐟 Fish
  • 🐠 Tropical Fish
  • 🐑 Pufferfish
  • 🐬 Dolphin
  • 🦈 Shark
  • πŸ™ Octopus

πŸ’‘ 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.

πŸ“ License

MIT License. Free to use and modify.

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

About

A lightweight Fish shell extension to indicate private mode sessions in your prompt with a ghost icon πŸ‘»

Topics

Resources

License

Stars

Watchers

Forks

Languages