🐮 cowsay.zsh

January 31, 2026 · View on GitHub

Zsh plugin that displays a joke with cowsay every time you open a terminal.

📥 Installation

Using Zinit🌻

zinit depth"1" lucid nocd light-mode atload"joke" for phucisstupid/cowsay.zsh

Manual Installation

  1. Clone the repository: 
    git clone https://github.com/phucisstupid/cowsay.zsh.git ~/cowsay.zsh
  2. Source the plugin in your .zshrc: 
    source ~/cowsay.zsh/cowsay.plugin.zsh
  3. Restart your terminal: 
    source ~/.zshrc

🛠 Usage

Just open your terminal! The plugin will automatically display a joke every session If you don't want automatic display:

zinit depth"1" lucid nocd light-mode for phucisstupid/cowsay.zsh

You can also manually trigger it:

joke
# for cowsay

or:

dadjoke
# for cowthink

🔄 Automatic Joke Updates

This repository includes a GitHub Actions workflow to update jokes.txt daily. To update jokes, use git pull for git install Zinit update:

zinit update phucisstupid/cowsay.zsh

Workflow Details:

  • Fetches 100 new jokes from icanhazdadjoke.com
  • Commits and pushes updates to jokes.txt
  • Runs every day at midnight (UTC)

🚀 Customization

You can customize the joke behavior by modifying joke.plugin.zsh. Here’s what you can do:

  • Change joke source: Modify the jokes_file path.
  • Use a specific cowsay character: Replace ls with a fixed filename, e.g., cowsay -f dragon.

🐧 Dependencies

Ensure you have these installed:

  • cowsay
  • lolcat (optional)
  • ripgrep (rg)
  • jq

Install them via Homebrew:

brew install cowsay lolcat ripgrep jq

📜 License

MIT License - Feel free to use and modify!

Made with 🐮💬 by phucisstupid