bash-it

Update Bash-it to the latest stable/development version

$ bash-it update [stable|dev]

$ bash-it reload

$ bash-it restart

$ bash-it doctor

$ bash-it doctor [errors|warnings|all]

$ bash-it search [alias|plugin|completion]

$ bash-it search --[enable|disable] [alias|plugin|completion]

Bash-it is not a single executable command in the traditional sense, but rather a framework managed by a main script.
After installation, you typically interact with it via the bash-it helper script found in your `~/.bash_it` directory (or linked to your PATH).

Installation (first time):
`git clone --depth=1 https://github.com/Bash-it/bash-it.git ~/.bash_it`
`~/.bash_it/install.sh --auto` (or `--no-modify-config` for manual configuration)

General Usage:
`bash-it` <command> [<arguments>]

enable <type> <name>
    Enables a specific component (e.g., `plugin`, `alias`, `completion`) by its `name`.

disable <type> <name>
    Disables an enabled component.

list <type>
    Lists available and currently enabled components of a given `type`.

reload
    Reloads your shell's Bash-it configuration without restarting the terminal.

update
    Updates Bash-it to the latest version by pulling changes from its Git repository.

themes
    Lists all available themes that can be set in your `~/.bashrc` (e.g., `export BASH_IT_THEME="powerline"`).

clean
    Removes disabled plugins, aliases, and completions from the loaded environment.

help
    Displays detailed help information for Bash-it commands.

Bash-it is a powerful, community-driven framework designed to enhance and customize your Bash shell experience.
It provides a structured and easy-to-manage collection of Bash scripts, including themes, aliases, custom functions, and completion scripts.
The primary goal of Bash-it is to make the Bash terminal more user-friendly, productive, and aesthetically pleasing for developers, system administrators, and power users.
Instead of manually managing numerous shell configurations, Bash-it offers a modular system that allows users to enable or disable components with simple commands.
Key features include a variety of colorful themes for visual customization, time-saving aliases for frequently used commands, intelligent tab-completion scripts for various tools (like Git, Docker, Kubernetes), and a repository of useful functions that extend Bash's capabilities.
Its straightforward installation and update process, primarily through Git, make it a popular choice for those looking to significantly upgrade their command-line environment without deep manual configuration.

• Dependency on Bash: Bash-it is specifically designed for the Bash shell and will not work with other shells like Zsh or Fish.
• Configuration Conflicts: Existing custom configurations in your `~/.bashrc` or `~/.profile` might conflict with Bash-it's settings, especially for aliases or functions. It's recommended to review your configuration after installation.
• Shell Startup Time: Enabling a large number of plugins, aliases, or completions can slightly increase the shell's startup time due to the additional scripts being sourced.
• Manual Sourcing Required: For Bash-it to function, the main `bash_it.sh` script must be sourced in your Bash configuration file (e.g., `~/.bashrc`). The installer usually handles this, but manual intervention might be needed.

Users can easily extend Bash-it by creating their own custom plugins, aliases, or completions.
These can be placed in the `custom` directory within the `~/.bash_it` installation, ensuring they are loaded and persist across Bash-it updates.

Bash-it thrives on community contributions.
This collaborative model means a wide variety of tools and preferences are supported through its plugin ecosystem, and development is responsive to user needs and new technologies.

Bash-it originated as an open-source project by its initial creator, Matt Gruskin, around 2011.
It was inspired by the success of Oh My Zsh and aimed to bring similar modularity and ease of customization to the Bash shell, which lacked such a comprehensive framework at the time.
Over the years, it has grown into a vibrant, community-driven project with contributions from numerous developers worldwide.
Its development is focused on providing a stable, extensible platform for Bash users, continuously adding new themes, plugins, aliases, and completions to keep pace with modern command-line tool usage and user demands.

bash(1), git(1), source(1), zsh(1), oh-my-zsh