Uninstall
Uninstall
Complete instructions for removing pass-cli from your system.
Uninstallation
Homebrew
# Uninstall Pass-CLI
brew uninstall pass-cli
# Remove tap (optional)
brew untap arimxyer/homebrew-tap
# Remove vault (if desired)
rm -rf ~/.pass-cliScoop
# Uninstall Pass-CLI
scoop uninstall pass-cli
# Remove bucket (optional)
scoop bucket rm pass-cli
# Remove vault (if desired)
Remove-Item -Recurse -Force ~/.pass-cliManual Installation
# Remove binary
sudo rm /usr/local/bin/pass-cli
# Or user installation
rm ~/.local/bin/pass-cli
# Remove vault (if desired)
rm -rf ~/.pass-cliWindows Manual Installation
# Remove binary
Remove-Item "C:\Program Files\pass-cli\pass-cli.exe"
# Remove from PATH (if manually added)
# System Properties → Environment Variables → Edit Path
# Remove vault (if desired)
Remove-Item -Recurse -Force "$env:USERPROFILE\.pass-cli"Complete Removal
To completely remove all traces of Pass-CLI:
# 1. Uninstall binary (using method above)
# 2. Remove vault
rm -rf ~/.pass-cli
# 3. Remove master password from keychain
# macOS: Open Keychain Access → Search "pass-cli" → Delete
# Linux: Use your keyring manager (Seahorse, etc.)
# Windows: Credential Manager → Remove pass-cli entries
# 4. Remove config (if exists)
rm ~/.pass-cli.yaml
# 5. Clear shell history (optional)
history -cPlatform-Specific Notes
macOS
- Apple Silicon: Use ARM64 version for native performance
- Intel: Use amd64 version
- Keychain: Integration is automatic
- Homebrew: Recommended installation method
Linux
- Package Managers: Homebrew works on Linux too
- Keychain: Requires Secret Service (GNOME Keyring or KWallet)
- AppArmor/SELinux: May need profile adjustments for keychain access
- Distribution Packages: May become available for specific distros
Windows
- Scoop: Recommended installation method
- Credential Manager: Integration is automatic
- Antivirus: May need to whitelist pass-cli.exe
- PATH: Requires manual setup for manual installation
Getting Help
If you encounter issues not covered here:
- Check the Troubleshooting Guide
- Review GitHub Issues
- Ask in GitHub Discussions
- File a new issue
Next Steps
After uninstalling, you might want to:
- Review the Security Architecture
- Check pass-cli Documentation for other topics