you-should-use

Smart Shell Suggestions

A shell plugin that helps you work smarter by reminding you of aliases, suggesting modern command alternatives, and providing AI-powered rewrites.

Zsh Fish Bash Nushell
~
$ cat README.md
YSU ~> Try bat instead of cat - Syntax highlighting, line numbers
     install: brew install bat
$ git checkout -b feature
YSU ~> You have an alias: gcb
$ ls -la /tmp
YSU ~> Try eza -la instead of ls -la - Modern listing with icons
$

Features

💬

Alias Reminders

Forgot you had an alias? The plugin gently reminds you when you type the full command, helping you build muscle memory.

Modern Alternatives

Still using cat, find, or ls? Get suggestions for modern Rust/Go tools like bat, fd, and eza.

🧠

AI-Powered Suggestions

With Ollama running locally, get intelligent command rewrites. Async and cached — never slows down your workflow.

🔍

Alias Discovery

Scans your shell history for frequently typed commands and suggests creating aliases. Run ysu discover to find opportunities.

🩺

Doctor & Diagnostics

Run ysu doctor to check shell compatibility, hook registration, LLM connection, and more.

📦

Platform-Aware Hints

Auto-detects your package manager (brew, apt, pacman, dnf...) and shows the right install command for missing tools.

Built-in Mappings

Suggestions only appear when the modern alternative is actually installed on your system.

LegacyModernWhy
catbatSyntax highlighting, line numbers, git integration
lseza / lsdIcons, git status, tree view
findfdSimpler syntax, faster, respects .gitignore
greprg / agFaster, respects .gitignore
dudust / ncduVisual disk usage
topbtop / htopBeautiful resource monitor
psprocsModern process viewer with tree display
diffdeltaSyntax highlighting, side-by-side view
sedsdSimpler regex syntax
curlhttpieHuman-friendly HTTP
mantldrCommunity-driven examples
cdzoxideLearns your habits

Installation

Homebrew (macOS)

brew install vangie/formula/you-should-use

Then add the source line shown in the post-install message to your shell config.

Quick Install Script

curl -fsSL https://raw.githubusercontent.com/vangie/you-should-use/main/install.sh | sh

Auto-detects your shell, clones the repo, and configures your rc file.

Plugin Managers

git clone https://github.com/vangie/you-should-use \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/you-should-use

# Then add to plugins in ~/.zshrc:
plugins=(... you-should-use)
zinit light vangie/you-should-use
zplug "vangie/you-should-use"
# Add to .zsh_plugins.txt:
vangie/you-should-use
fisher install vangie/you-should-use
omf install https://github.com/vangie/you-should-use

Commands

ysu status

Show configuration and statistics dashboard

ysu config

Interactive configuration wizard

ysu doctor

Run diagnostics and check for issues

ysu discover

Scan history and suggest new aliases

ysu update

Update to the latest version

ysu uninstall

Remove from your system