@@ 1,6 1,6 @@ 
 hackurist
 =========
-[hackurist](https://bitbucket.com/telesto/hackurist) is made up of a client library and a client command line program to access a running [dfhack](https://github.com/DFHack/dfhack) rpc server. It is written in [Go](http://golang.org/). 
+[hackurist](https://bitbucket.com/telesto/hackurist) is a client library/command line program to access a running [dfhack](https://github.com/DFHack/dfhack) rpc server. It is written in [Go](http://golang.org/). 
 
 News
 ----

          
@@ 13,6 13,10 @@ Installation:
 
 API Documentation: http://godoc.org/bitbucket.org/telesto/hackurist
 
+See
+[bitbucket.org/telesto/hackurist/cmd/hackurist/main.go] (https://bitbucket.org/telesto/hackurist/src/0d46764b30bb877b86d45959dc0be5e1771d164e/cmd/hackurist/main.go?at=default)
+as an example on how to use this library.
+
 
 command line tool
 -----------------

          
@@ 22,13 26,22 @@ Installation:
 
 	go get bitbucket.org/telesto/hackurist/cmd/hackurist
 
-Download:
+or download the binary:
 
+[Linux (x86)](http://laokoon.in-berlin.de/~heiko/hackurist/1.0/linux/hackurist),
+[Mac OS X](http://laokoon.in-berlin.de/~heiko/hackurist/1.0/osx/hackurist)
+[Windows](http://laokoon.in-berlin.de/~heiko/hackurist/1.0/windows/hackurist.exe)
 
 Usage: See
 
 	hackurist -h
+	
+Some examples:
 
-Discussion/Contact
-------------------
-todo
+	hackurist help
+	./hackurist -a :5001 region-pops list
+	hackurist -d lua "print(df.global.world.units.all[0].name.first_name)"
+	
+Feedback/Contact
+----------------
+There is an [anouncement topic](http://www.bay12forums.com/smf/index.php?board=29.0) at the official dwarf fortress forums. you can contact me by sending a pm.