From e05101d358e20b1c14fb9a638ec13bf65684cf8d Mon Sep 17 00:00:00 2001
From: xylous <xylous.e@gmail.com>
Date: Wed, 19 May 2021 13:32:27 +0300
Subject: [PATCH] Add README.md

---
 README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bc2f548
--- /dev/null
+++ b/README.md
@@ -0,0 +1,63 @@
+# gitstatus.zsh
+
+`gitstatus` is a zsh plugin that you can add to your prompt to help you see what
+you're doing in a git repository more easily.
+
+## Why such a thing?
+
+Frankly, it's because I needed something small and fast that would integrate
+well with my (multi-line) prompt.
+
+Is it useful? For myself at least, yes.
+
+## Getting Started
+
+### Requirements
+
+- zsh
+- git
+- awk
+
+### Installation
+
+Run the following command:
+
+```
+git clone https://github.com/Insert-Creative-Name-Here/gitstatus.zsh.git
+```
+
+You can move the downloaded repository anywhere you want on your computer
+afterwards.
+
+## Usage
+
+Add the following lines to your zshrc:
+
+```zsh
+function precmd()
+{
+    source path/to/installation/gitstatus.plugin.zsh
+}
+```
+
+`precmd()` is a zsh builtin that executes a series of commands right before the
+prompt is drawn.
+
+NOTE: you will have to redefine your prompt to include the variable
+`$GIT_STATUS`, which is exported to the environment by this plugin. Something
+like this:
+
+```zsh
+PS1="%F{blue}%~%F{default} $GIT_STATUS $ "
+```
+
+## Roadmap
+
+- [ ] Find a way to not source the script every time a new prompt is
+drawn
+- [ ] Add bash support
+- [ ] Add screenshots
+
+## Contributing
+
+Pull requests and issues are welcome.