🦞 Shellfish

Shell scripts with personality. Because your terminal deserves better.

A collection of useful shell utilities wrapped in excessive lobster puns. Made by Mullet McNasty.

---

What's Inside

Backup & Sync

• claws-backup - Backup your workspace with progress claws
• shell-sync - Rsync wrapper with color output and lobster commentary
• deep-dive - Recursive directory backup with compression

File Watching & Automation

• tide-watch - Watch files and trigger commands on change
• net-cast - Deploy scripts with pre/post hooks and rollback
• molt - Clean up old backups and temp files (like shedding a shell)

Development Helpers

• claw-log - Pretty git log with emoji and branch visualization
• pinch-test - Quick sanity checks before pushing code
• reef-check - Scan for common security issues in shell scripts

Utilities

• bubble-up - Navigate up directories with fuzzy finding
• shell-shocked - Show system stats with personality
• ocean-temp - Check server temperature/load with alerts

---

Installation

git clone https://github.com/mulletmcnasty/shellfish.git
cd shellfish
chmod +x install.sh
./install.sh

Or install individual scripts:

curl -O https://raw.githubusercontent.com/mulletmcnasty/shellfish/main/claws-backup
chmod +x claws-backup
sudo mv claws-backup /usr/local/bin/

---

Usage Examples

Backup with Progress

claws-backup ~/my-project /backup/location
# 🦞 Grabbing files with my claws...
# [████████████████████████████████] 100% - 1.2GB backed up
# ✅ All secure in the shell! Backup complete.

Watch and Rebuild

tide-watch "src/**/*.js" "npm run build"
# 🌊 Watching the tide... (Ctrl+C to stop)
# 📝 Change detected: src/app.js
# 🔨 Running: npm run build
# ✅ Build successful! Back to watching...

Clean Old Backups

molt --older-than 30d --dry-run
# 🦞 Time to shed some old shells...
# Would delete: backup-2025-01-01.tar.gz (45 days old)
# Would delete: backup-2025-01-05.tar.gz (41 days old)
# 💡 Run without --dry-run to actually delete

---

Philosophy

Good tools should be:

1. Actually useful - Solve real problems
2. Easy to use - Sensible defaults, clear output
3. A little fun - Because why not?

Business in the front (solid scripts), party in the back (lobster puns). 🦞

---

Contributing

Found a bug? Have a script idea? PRs welcome!

Please keep the lobster puns tasteful (or at least groan-worthy).

---

License

MIT License - Use it, fork it, shell it.

Made with 🦞 by Mullet McNasty