MVP - Support shell environments and plugins

Environments allow users to quickly managed dotfiles and other system
configuration files quickly and easily.
Plugins allow users to quickly download shell scripts that are then
automagically available in their shells.

README.md

@@ -1 +1,88 @@
-# shplug - Your Shell Plugin Manager
+![shplug](./img/shplug.png "Logo")
+
+**Your new shell plugin manager** - An easy solution for managing your shell environments.
+
+There are two main use patterns:
+
+## Synced environments
+
+Sync your files across multiple environments (aka machines) using a simple git repository.
+
+### Example
+
+Let's say you have 2 different machines you use for development/administration/etc.
+You wanna sync your dotfiles: `.gitconfig`, `.vimrc`, `.bashrc`, `.tmux.conf`
+and possibly some scripts you always find useful to have on your machine.
+
+Create a git repository, call it however you like and use the following structure:
+- [git-repo-root]
+    - install
+    - home
+        - .gitconfig
+        - .vimrc
+        - .bashrc
+        - .tmux.conf
+        - scripts
+            - my_greatest_script.sh
+            - my_awesome_script.rb
+            - my_amazing_tool.py
+
+Once you have `shplug` installed on your machine, you can get all those goodies using a single command:
+```
+shplug env add <env-name> <git-repo-url>
+```
+
+For example, I clone my dotfiles using:
+```
+shplug env add dotfiles https://github.com/dtrugman/dotfiles
+```
+
+When you run the command, the following will happen:
+
+1. The repository will be cloned locally into some hidden directory under your user's home (The user that executes the `shplug env add` command)
+1. All the files are going to be linked under your actual `$HOME` directory. Existing files are going to be backed-up and only then overriden. **Don't worry, you will be notified of the changes and prompted for approval.**
+1. The `install` script is going to be executed, just in case you want to automatically add the new `scripts` directory into your `$PATH` without any additional manual steps, install `plug.vim` and run `:PlugInstall` or do anything else automatically every time you sync the environment.
+
+Notes:
+1. `home` is a hard-coded keyword for the `$HOME` of the user that will be using the environment. `scripts` is just an arbitrary name you can use. Any other name will work as well
+1. The `install` file is optional
+
+### Plan on changing your scripts? Great!
+
+You can edit any of your scripts and push them to your global git repository easily. After doing any changes, just enter the hidden git repo using: `shplug env cd <env-name>`, and interact directly with your git repository.
+
+## Easy plugins
+
+Quickly and easily manage aliases, functions, gists and more. The plugin manager allows you to download files locally and automatically source them into your active shell.
+
+Let's say a colleague wrote a small script to handle that annoying task that broke the integration tests at work. Just get him to upload it anywhere and run: `shplug plugin add <plugin-name> <plugin-url>`.
+
+The name can be whatever you want. Here's an example: `shplug plugin add git-describe https://gist.github.com/dtrugman/ec4d40e7b05f01251e4c688ae62219fd`
+
+You could argue you can just add this script to your dotfiles repo, but life's dynamic and unexpected. There are different reasons to keep those separated:
+
+- You might decide to keep your dotfiles private while share some scripts with colleagues or fellow redditors
+- You wanna try scripts out before adding them to your repo
+- You want an easy way to add an alias/function/script for a limited time, say, while doing a demo
+
+## Install
+
+`shplug` currently officially supports `bash` and `zsh`:
+
+bash:
+```
+curl -L "https://github.com/dtrugman/shplug/releases/download/v0.1.0/install_bash" | bash && source "$HOME/.bashrc"
+```
+
+zsh:
+```
+curl -L "https://github.com/dtrugman/shplug/releases/download/v0.1.0/install_zsh" | zsh && source "$HOME/.zshrc"
+```
+
+## Feature requests & Contributions
+
+You are more than welcome to ask/do both!
+
+## Licensing
+
+[Apache-2.0 License](https://tldrlegal.com/license/apache-license-2.0-(apache-2.0))

install_bash

@@ -0,0 +1,8 @@
+set -eu
+
+git clone "https://github.com/dtrugman/shplug.git" "$HOME/.shplug/repos/shplug"
+
+rcfile="$HOME/.bashrc"
+if [[ ! -f "$rcfile" ]] || ! grep -q 'source "$HOME/.shplug/repos/shplug/shplug.sh"' "$rcfile"; then
+    printf '\n[[ -s "$HOME/.shplug/repos/shplug/shplug.sh" ]] && source "$HOME/.shplug/repos/shplug/shplug.sh"' >> "$rcfile"
+fi

install_zsh

@@ -0,0 +1,8 @@
+set -eu
+
+git clone "https://github.com/dtrugman/shplug.git" "$HOME/.shplug/repos/shplug"
+
+rcfile="$HOME/.zshrc"
+if [[ ! -f "$rcfile" ]] || ! grep -q 'source "$HOME/.shplug/repos/shplug/shplug.sh"' "$rcfile"; then
+    printf '\n[[ -s "$HOME/.shplug/repos/shplug/shplug.sh" ]] && source "$HOME/.shplug/repos/shplug/shplug.sh"' >> "$rcfile"
+fi