Bash it is a collection of community bash commands and scripts. (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) on a regular basis 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.
- 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
~/.bash_it/install.sh(it automatically backs up your
~/.bashrc, depending on your OS)
- Edit your modified config (
~/.bashrc) file in order to customize Bash it.
- Check out available aliases, completions and plugins and enable the ones you want to use (see the next section for more details).
INSTALL OPTIONS: The install script can take the following options:
--interactive: Asks the user which aliases, completions and plugins to enable.
When run without the
--interactive switch, Bash it only enables a sane default set of functionality to keep your shell lean and to avoid issues with missing dependencies. Feel free to enable the tools you want to use after the installation.
bash-it show aliases # shows installed and available aliases bash-it show completions # shows installed and available completions bash-it show plugins # shows installed and available plugins bash-it help aliases # shows help for installed aliases bash-it help completions # shows help for installed completions bash-it help plugins # shows help for installed plugins
Your Custom scripts, aliases, and functions
For custom scripts, and aliases, just create the following files (they'll be ignored by the git repo):
Anything in the custom directory will be ignored, with the exception of
There are a few bash it themes. If you've created your own custom prompts, I'd love it if you shared with everyone else! Just submit a Pull Request.
You can see the theme screenshots here
Alternatively, you can preview the themes in your own shell using
To uninstall Bash it, run the
uninstall.sh script found in the
cd $BASH_IT ./uninstall.sh
This will restore your previous Bash profile. After the uninstall script finishes, remove the Bash it directory from your machine (
rm -rf $BASH_IT) and start a new shell.
Bash Profile Aliases
Bash it creates a
reload alias that makes it convenient to reload
your bash profile when you make changes.
Prompt Version Control Check
Bash it provides prompt themes the ability to check and display version control information for the current directory. The information is retrieved for each directory and can slow down the navigation of projects with a large number of files and folders. Turn version control checking off to prevent slow directory navigation within large projects.
Bash it provides a flag (
SCM_CHECK) within the
~/.bash_profile file that turns off/on version control information checking and display within all themes. Version control checking is on by default unless explicitly turned off.
SCM_CHECK to 'false' to turn off version control checks for all themes:
SCM_CHECK to 'true' (the default value) to turn on version control checks for all themes:
It is possible for themes to ignore the
SCM_CHECK flag and query specific version control information directly. For example, themes that use functions like
git_prompt_vars skip the
SCM_CHECK flag to retrieve and display git prompt information. If you turned version control checking off and you still see version control information within your prompt, then functions like
git_prompt_vars are most likely the reason why.
Bash it has some nice features related to Git, continue reading to know more about these features.
Repository info in the prompt
Bash it can show some information about Git repositories in the shell prompt: the current branch, tag or commit you are at, how many commits the local branch is ahead or behind from the remote branch, and if you have changes stashed.
Additionally, you can view the status of your working copy and get the count of staged, unstaged and untracked files. This feature is controlled through the flag
SCM_GIT_SHOW_DETAILS as follows:
SCM_GIT_SHOW_DETAILS to 'true' (the default value) to show the working copy details in your prompt:
SCM_GIT_SHOW_DETAILS to 'false' to don't show it:
Remotes and remote branches
In some git workflows you must work with various remotes, for this reason, Bash it can provide some useful information about your remotes and your remote branches, for example, the remote on you are working, or if your local branch is tracking a remote branch.
You can control this feature with the flag
SCM_GIT_SHOW_REMOTE_INFO as follows:
SCM_GIT_SHOW_REMOTE_INFO to 'auto' (the default value) to activate it only when more than one remote is configured in the current repo:
SCM_GIT_SHOW_REMOTE_INFO to 'true' to always activate the feature:
SCM_GIT_SHOW_REMOTE_INFO to 'false' to disable the feature:
git status command shows information about untracked files, this behavior can be controlled through command line flags or git configuration files, for big repositories, ignoring untracked files can make git faster. Bash it uses
git status to gather the repo information it shows in the prompt, so in some circumstances, can be useful to instruct Bash it to ignore these files. You can control this behavior with the flag
SCM_GIT_IGNORE_UNTRACKED to 'false' (the default value) to get information about untracked files:
SCM_GIT_IGNORE_UNTRACKED to 'true' to ignore untracked files:
also, with this flag to false, Bash it will not show the repository as dirty when the repo have untracked files, and will not display the count of untracked files.
NOTE: If you set in git configuration file the option to ignore untracked files, this flag has no effect, and Bash it will ignore untracked files always.
Ignore repo status
When working in repos with a large code base Bash it can slow down your prompt when checking the repo status, to avoid it, there is an option you can set via Git config to disable checking repo status in Bash it.
To disable checking the status in the current repo:
$ git config --add bash-it.hide-status 1
But if you would like to disable it globally, and stop checking the status for all of your repos:
$ git config --global --add bash-it.hide-status 1
setting this flag globally has the same effect that
SCM_CHECK=true but only for Git repos.
pass function renamed to passgen
The Bash it
pass function has been renamed to
passgen in order to avoid a naming conflict with the pass password manager. In order to minimize the impact on users of the legacy Bash it
pass function, Bash it will create the alias
pass that calls the new
passgen function if the
pass password manager command is not found on the
PATH (default behavior).
This behavior can be overridden with the
BASH_IT_LEGACY_PASS flag as follows:
BASH_IT_LEGACY_PASS to 'true' to force Bash it to always create the
pass alias to
BASH_IT_LEGACY_PASS to have Bash it return to default behavior:
If you are working in a corporate environment where you have to go through a proxy server for internet access, then you know how painful it is to configure the OS proxy variables in the shell, especially if you are switching between environments, e.g. office (with proxy) and home (without proxy).
The Bash shell (and many shell tools) use the following variables to define the proxy to use:
http_proxy): Defines the proxy server for HTTP requests
https_proxy): Defines the proxy server for HTTPS requests
all_proxy): Used by some tools for the same purpose as above
no_proxy): Comma-separated list of hostnames that don't have to go through the proxy
proxy plugin allows to enable and disable these variables with a simple command. To start using the
proxy plugin, run the following:
bash-it enable plugin proxy
Bash it also provides support for enabling/disabling proxy settings for various shell tools. The following backends are currently supported (in addition to the shell's environment variables): Git, SVN, npm, ssh. The
proxy plugin changes the configuration files of these tools to enable or disable the proxy settings.
Bash-it uses the following variables to set the shell's proxy settings when you call
These variables are best defined in a custom script in Bash-it's custom script folder (
BASH_IT_HTTPS_PROXY: Define the proxy URL to be used, e.g. 'http://localhost:1234'
BASH_IT_NO_PROXY: A comma-separated list of proxy exclusions, e.g.
Once you have defined these variables (and have run
reload to load the changes), you can use the following commands to enable or disable the proxy settings in your current shell:
enable-proxy: This sets the shell's proxy environment variables and configures proxy support in your SVN, npm and SSH configuration files.
disable-proxy: This unsets the shell's proxy environment variables and disables proxy support in your SVN, npm and SSH configuration files.
There are many more proxy commands, e.g. for changing the local Git project's proxy settings. Run
glossary proxy to show the available proxy functions with a short description.
We think everyone has their own custom scripts accumulated over time. And so, following in the footsteps of oh-my-zsh, Bash it is a framework for easily customizing your bash shell. Everyone's got a custom toolbox, so let's start making them even better, as a community!
Send us a pull request and we'll merge it as long as it looks good. If you change an existing command, please give an explanation why. That will help a lot when we merge your changes in.
Thanks, and happing bashing!