|
|
||
|---|---|---|
| .github | ||
| aliases/available | ||
| completion/available | ||
| custom | ||
| docs | ||
| hooks | ||
| lib | ||
| plugins/available | ||
| profiles | ||
| scripts | ||
| template | ||
| test | ||
| test_lib | ||
| themes | ||
| vendor | ||
| .ackrc | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| .pre-commit-config.yaml | ||
| .readthedocs.yml | ||
| LICENSE | ||
| bash_it.sh | ||
| clean_files.txt | ||
| install.sh | ||
| lint_clean_files.sh | ||
| uninstall.sh | ||
docs/README.md
Bash-it is a collection of community Bash commands and scripts for Bash 3.2+. (And a shameless ripoff of oh-my-zsh 😃)
Includes autocompletion, themes, aliases, custom functions, a few stolen pieces from Steve Losh, and more.
Bash-it provides a solid framework for using, developing and maintaining shell scripts and custom commands for your daily work.
If you're using the Bourne Again Shell (Bash) regularly and have been looking for an easy way on how to keep all of these nice little scripts and aliases under control, then Bash-it is for you!
Stop polluting your ~/bin directory and your .bashrc file, fork/clone Bash-it and start hacking away.
- Main Page
- Contributing
- Installation
- Help
- Search
- Custom scripts, aliases, themes, and functions
- Themes
- Uninstalling
- Misc
- Help Out
- Contributors
Installation
- Check out a clone of this repo to a location of your choice, such as
git clone --depth=1 https://github.com/Bash-it/bash-it.git ~/.bash_it - Run
~/.bash_it/install.sh
Bash Dependency
Bash-it requires Bash 4.?? or later to run correctly. Any reasonably current Linux distribution should have shipped with a compatible version of Bash. However, macOS users must upgrade from the included, obsolete Bash version 3. While some functionality might work with Bash 3, there is no guarantee that everything will work perfectly. Thus, we recommend using Homebrew to ensure Bash is up to date:
x86 Mac
$ brew install bash
$ sudo sh -c 'echo /usr/local/bin/bash >> /etc/shells'
$ chsh -s /usr/local/bin/bash
M1 Mac
Homebrew's default installation location on M1 is /opt/homebrew/bin/:
$ brew install bash
$ sudo sh -c 'echo /opt/homebrew/bin/bash >> /etc/shells'
$ chsh -s /opt/homebrew/bin/bash
That's it! 😃
You can check out more components of Bash-it, and customize it to your desire.
For more information, see detailed instructions here.
Contributing
Please take a look at the Contribution Guidelines before reporting a bug or providing a new feature.
The Development Guidelines have more information on some of the internal workings of Bash-it, please feel free to read through this page if you're interested in how Bash-it loads its components.
Contributors
License
Bash-it is licensed under the MIT License.
