aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorTeddy Wing2018-01-31 21:55:15 +0100
committerTeddy Wing2018-01-31 21:55:15 +0100
commit90209cf90fc41cd0962a14f32c8d42bf3ceb6cd0 (patch)
tree765abb3491d689f016d95472d0b0c342809d17a4 /README.md
parent2d0eb0ecde89773907af2db83b25fca19476285f (diff)
downloadharvester-90209cf90fc41cd0962a14f32c8d42bf3ceb6cd0.tar.bz2
Add READMEv0.0.1
Include a description, usage information, prerequisite requirements, and license info.
Diffstat (limited to 'README.md')
-rw-r--r--README.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fdd1e3c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+Harvester
+=========
+
+A wrapper around [hcl][1] that provides a command line interface similar to
+[Timetasker][2].
+
+
+## Usage
+This command will submit a time entry of 4.5 hours for the “example” project:
+
+ $ harvester \
+ > --project example \
+ > --time 4.5 \
+ > --date 2018-01-31 \
+ > --description "Worked on Harvester"
+
+Only the `--project` option is required. Project aliases are defined by `hcl`.
+The `--time` option will default to 7 hours if not specified, and `--date` will
+default to the current day.
+
+
+## Requirements
+
+* [hcl][1]
+* In order to use the `--date` option, [this patch to hcl is required][3].
+
+
+## License
+Copyright © 2018 Teddy Wing. Licensed under the GNU GPLv3+ (see the included
+COPYING file).
+
+
+[1]: https://github.com/zenhob/hcl
+[2]: https://github.com/teddywing/timetasker
+[3]: https://github.com/zenhob/hcl/pull/86