🚀 Enhanced Z-Shell Configuration

A lightning‑fast, user-friendly Zsh setup for Linux Mint and other Debian based systems.

✨ Features

• ⚡ Super Fast: Startup time under 50ms with optimized plugins
• 🎨 Beautiful: Powerlevel10k prompt with instant prompt support
• 🛠️ Modern CLI Tools: Automatic setup of bat/batcat, eza, fzf, ripgrep and more
• 🤖 AI Integration: Built‑in helper using the Perplexity API
• 🔧 Smart Fallbacks: Works even if optional tools aren't installed
• 📦 Zero Errors: Thoroughly tested on Linux Mint with proper error handling

🚀 Quick Install

bash -c "$(curl -fsSL https://raw.githubusercontent.com/yourusername/zshrc/main/install.sh)"

📋 Manual Installation

1. Install required packages:

sudo apt update && sudo apt install -y \
  zsh git curl jq fzf ripgrep bat fd-find \
  trash-cli xclip neovim p7zip-full

2. Download the configuration:

curl -fsSL https://raw.githubusercontent.com/yourusername/zshrc/main/.zshrc -o ~/.zshrc

3. Set Zsh as default shell:

chsh -s $(which zsh)

4. Log out and log back in

🎯 Most Useful Commands

Command	Description
ff	Find files with preview and edit
pj	Jump to project directories
extract <file>	Extract any archive format
backup <file>	Create timestamped backup
px "question"	Ask Perplexity AI
explain <cmd>	Get AI explanation of command
suggest "task"	Get command suggestion from AI
mkcd <dir>	Create directory and cd into it
j <partial-name>	Smart jump to directory (zoxide)

🎨 Prompt Customization

Run p10k configure to customize your prompt appearance.

🤖 AI Setup

1. Get your API key from Perplexity
2. Add to ~/.secrets.zsh:

export PERPLEXITY_API_KEY='your-api-key-here'

🐛 Troubleshooting

bat command not found

On Linux Mint/Ubuntu, bat is installed as batcat. This config automatically handles this.

Slow startup

Run zsh-time to measure startup time. Should be under 50ms.

Missing icons in ls

Install a Nerd Font from nerdfonts.com

🔧 Customization

• Personal settings: Create ~/.zshrc.local
• API keys and secrets: Create ~/.secrets.zsh
• Machine-specific configs won't be overwritten by updates

📊 Performance

Typical startup times:

• With all plugins: ~50ms
• Minimal (no optional tools): ~20ms

🤝 Contributing

Contributions are welcome! Please:

1. Keep it lightweight
2. Test on Linux Mint/Ubuntu
3. Maintain backwards compatibility

📜 License

MIT License - feel free to use and modify!

🙏 Credits

• Zinit - Plugin manager
• Powerlevel10k - Prompt theme
• bat - Better cat
• eza - Better ls
• All the amazing open source tools that make this possible

---

Made with ❤️ for the Linux Mint community