README.md in spaarti-0.0.6 vs README.md in spaarti-0.1.0
- old
+ new
@@ -10,9 +10,30 @@
Tool to maintain local clones of repos you have access to on GitHub
## Usage
+To clone all your repos to the current directory: `spaarti`
+
+Adding `-p` will remove orphaned repos (repos on disk that don't exist on GitHub, or that you no longer have access to).
+
+Adding `-q` will silence output except errors.
+
+You can override the defaults by defining a config file in YAML:
+
+```
+base_path: Defaults to './', this is the root that repos will be cloned to
+auth_file: Passed to OctoAuth for storing your GitHub token, the default will use ~/.octoauth.yml
+exclude: Hash where keys are attributes of a repo (https://developer.github.com/v3/repos/#get) and values are array of regex pattern strings, with any repo whose attribute matches any pattern not being pulled
+format: Format string used to determine path. Defaults to "%{full_name}", so "akerl/blog" is cloned at "akerl/blog". Available keys: https://developer.github.com/v3/repos/#get
+git_config: Hash of key/value pairs, will be set in .git/config for cloned repos. Useful for setting things like user.name/email
+quiet: Boolean, controls verbosity of status output
+purge: Boolean, true will remove repos that are on-disk but not accessible by you on GitHub
+url_type: Used to determine how to clone, one of: html, clone, git, ssh, svn. Defaults to 'ssh'
+```
+
+The default config path is `~/.spaarti.yml`, but you can provide an alternate path with `./spaarti -c /path/to/config`
+
## Installation
gem install spaarti
## License