README.md

August 3, 2021 Β· View on GitHub

~/.Β πŸ“‚
Cross-platform, cross-shell dotfiles
powered by chezmoi 🏠

Codacy rating CodeFactor rating License Repo analytics Tweet

Universal command set and colourful shell configurations for Bash, Zsh and Powershell, compatible with macOS, Windows and (partially) Linux, all managed easily using chezmoi.

Be sure to ⭐️ or πŸ”± this repo if you find it useful! πŸ˜ƒ

Project goals ⚽

  • Unified set of aliases and commands.
  • Familiar feel and creature comforts across environments.
  • Cross-platform file management toolset.
  • Easy access to common paths.
  • Shortcuts to popular cross-platform apps.
  • System-agnostic update and dotfiles install commands.
  • A pretty interface! πŸ’ƒ

πŸ”

Supported toolset πŸ› οΈ

Use either one or many of these, the config files will be in place and ready to provide a familiar interface.

🐚 Shells

πŸ’» Terminals

πŸ“¦ Package managers

πŸ’Ύ Universal apps 🐧⊞

πŸ”

Cross-shell compatibility matrix 🏁

These are unified CLI commands available amongst different shells on all platforms. While some of their outputs may differ in style between different environments, their usage and behaviours remain universal.

Additional aliases are provided by Bash-It, Oh-My-Zsh and Powershell, and are listed by using the command alias.

System-specific aliases are marked with , ⊞, or 🐧.

🧭 Easier navigation

BashPowerShellZshCommandDescription
βœ…βœ…βœ…~Navigates to user home directory.
βœ…βœ…βœ…cd-Navigates to last used directory.
βœ…βœ…βœ…..
cd..
Navigates up a directory.
βœ…βœ…βœ…...Navigates up two directories.
βœ…βœ…βœ…....Navigates up three directories.
βœ…βœ…βœ….....Navigates up four directories.

πŸ”

πŸ—‚οΈ Directory browsing

BashPowerShellZshCommandDescription
βœ…βœ…βœ…lLists visible files in long format.
βœ…βœ…βœ…llLists all files in long format, excluding . and ...
βœ…βœ…βœ…lsdLists only directories in long format.
βœ…βœ…βœ…lshLists only hidden files in long format.

πŸ”

πŸ—„οΈ File management

BashPowerShellZshCommandDescription
βœ…βœ…βœ…cpvCopies a file securely.
βœ…βœ…βœ…fdFinds directories.
βœ…βœ…βœ…ffFinds files.
βŒβœ…βŒmirrorMirrors directories.
βœ…βœ…βœ…rgSearches recursively with ripgrep.

πŸ”

πŸ’‘ General aliases

BashPowerShellZshCommandDescription
βœ…βœ…βœ…aliasLists aliases.
βœ…βœ…βœ…cClears the console screen.
βœ…βŒβœ…extract
x
Extracts common file formats.
Usage: extract solarized.zip
βœ…βœ…βœ…hDisplays/Searches global history.
Usage: h
Usage: h cd
βœ…βœ…βš οΈhsDisplays/Searches session history.
Usage: hs
Usage: hs cd
βœ…βœ…βœ…mkcd
take
Creates directory and change to it.
Usage: mkcd foldername
βœ…βŒβœ…reloadReloads the shell.
βœ…βœ…βœ…repeat
r
Repeats a command x times.
Usage: repeat 5 echo hello.
βœ…βŒβœ…resourceReloads configuration.

πŸ”

πŸ•™ Time

BashPowerShellZshCommandDescription
βœ…βœ…βœ…now
unow
Gets local/UTC date and time in ISO 8601 format YYYY-MM-DDThh:mm:ss.
βœ…βœ…βœ…nowdate
unowdate
Gets local/UTC date in YYYY-MM-DD format.
βœ…βœ…βœ…nowtime
unowtime
Gets local/UTC time in hh:mm:ss format.
βœ…βœ…βœ…timestampGets Unix time stamp.
βœ…βœ…βœ…weekGets week number in ISO 8601 format YYYY-Www.
βœ…βœ…βœ…weekdayGets weekday number.

πŸ”

🌐 Networking

BashPowerShellZshCommandDescription
βœ…βœ…βœ…fastpingPings hostname(s) 30 times in quick succession.
βœ…βœ…βœ…flushdnsFlushes the DNS cache.
βœ…βœ…βœ…ipsGets all IP addresses.
βœ…βœ…βœ…localipGets local IP address.
βœ…βœ…βœ…publicipGets external IP address.
βœ…βœ…βœ…GET
HEAD
POST
PUT
DELETE
TRACE
OPTIONS
Sends HTTP requests.
_Usage: GET https://example.com

πŸ”

⚑ Power management

BashPowerShellZshCommandDescription
βœ…βœ…βœ…hibernateHibernates the system.
βœ…βœ…βœ…lockLocks the session.
βœ…βœ…βœ…poweroffShuts down the system.
βœ…βœ…βœ…rebootRestarts the system.

πŸ”

πŸ€“ Sysadmin

BashPowerShellZshCommandDescription
βœ…βœ…βœ…mntLists drive mounts.
βœ…βœ…βœ…pathPrints each $PATH entry on a separate line.
βœ…βœ…βœ…sysinfoDisplays information about the system.
Uses either Winfetch, Neofetch, or Screenfetch.
βœ…βœ…βœ…topMonitors processes and system resources.
Uses either atop, htop, ntop ⊞, or native.
βœ…βœ…βœ…updateKeeps all apps and packages up to date.

πŸ”

πŸ–₯️ Applications

BashPowerShellZshCommandDescription
βœ…βœ…βœ…browseOpens file/URL in default browser.
Usage: browse https://example.com
βœ…βœ…βœ…chromeOpens file/URL in Chrome.
βœ…βœ…βœ…edgeOpens file/URL in Microsoft Edge.
βœ…βœ…βœ…firefoxOpens file/URL in Firefox.
β”βœ…β”iexploreOpens file/URL in Internet Explorer. ⊞
βœ…βœ…βœ…operaOpens file/URL in Opera.
βœ…βœ…βœ…safariOpens file/URL in Safari. ο£Ώ
βœ…βœ…βœ…ssEnters the Starship πŸš€ cross-shell prompt.
βœ…βœ…βœ…subl
st
Opens in Sublime Text.

πŸ”

πŸ‘©β€πŸ’» Development

BashPowerShellZshCommandDescription
βœ…βœ…βœ…dk🐳 Alias for docker.
βœ…βœ…βœ…dco🐳 Alias for docker-compose.
βœ…βœ…βœ…g:octocat: Alias for git.
βœ…βœ…βœ…va🐍 Activates Python virtual environment venv.
βœ…βœ…βœ…ve🐍 Creates Python virtual environment venv.

πŸ”

ο£Ώ macOS

BashPowerShellZshCommandDescription
βœ…βœ…βœ…hidedesktop
showdesktop
Toggles display of desktop icons.
βœ…βœ…βœ…hidefiles
showfiles
Toggles hidden files display in Finder.
βœ…βœ…βœ…spotoff
spoton
Toggles Spotlight.

πŸ”

⊞ Windows

BashPowerShellZshCommandDescription
β”βœ…β”hidefiles
showfiles
Toggles hidden files display in File Explorer.

πŸ”

πŸ“ Common paths

BashPowerShellZshCommandDescription
βœ…βœ…βœ…dlsNavigates to ~/Downloads.
βœ…βœ…βœ…docsNavigates to ~/Documents.
βœ…βœ…βœ…dtNavigates to ~/Desktop.

πŸ”

πŸ“ Configuration paths

BashPowerShellZshCommandDescription
βœ…βœ…βœ…chezmoiconfNavigates to Chezmoi's local configuration repo.
βœ…βœ…βœ…powershellconfNavigates to Powershell's profile location.
βœ…βœ…βœ…sublimeconfNavigates to Sublime Text's local configuration repo.

πŸ”

πŸ“ Custom paths

BashPowerShellZshCommandDescription
βœ…βœ…βœ…archivesNavigates to ~/Archives.
βœ…βœ…βœ…reposNavigates to ~/Code.

πŸ”

🌱 Varia

BashPowerShellZshCommandDescription
βœ…βœ…βœ…cbπŸ“‹ Copies contents to the clipboard.
βœ…βœ…βœ…cbpasteπŸ“‹ Pastes the contents of the clipboard.
βœ…βœ…βœ…md5sum#️⃣ Calculates MD5 hashes.
βœ…βœ…βœ…sha1sum#️⃣ Calculates SHA1 hashes.
βœ…βœ…βœ…sha256sum#️⃣ Calculates SHA256 hashes.
βœ…βœ…βœ…forecast🌀️ Displays detailed weather and forecast.
βœ…βœ…βœ…weather🌀️ Displays current weather.

πŸ”

Inspirations πŸ’‘

πŸ”

Don't forget to ⭐️ or πŸ”± this repo! πŸ˜ƒ
Assembled with ❀️ in Montréal.