README.md in briar-0.1.3.rc1 vs README.md in briar-0.1.3

@@ -34,9 +34,52 @@
 ```
 
 To integrate briar and your calabash-ios console see: https://github.com/jmoody/briar/wiki/Integrating-Briar-Into-Your-Calabash-Console
 
 
+## briar binary
+
+The briar binary provides useful commands to improve your calabash workflow.
+
+There is detailed help about how to use the .xamarin convention and dotenv to setup your environment.
+
+```
+# help
+$ briar help
+$ briar help console
+$ briar help .xamarin
+
+# open a console against simulators
+$ briar console sim6            <== against the current simulator
+$ briar console sim7 ipad_r_64  <== changes the default simulator
+
+# open a console against named devices
+$ briar console venus
+$ briar console neptune
+
+# install the calabash server from a local repo and remove all stale simulator targets in one command
+$ briar install calabash-server
+
+# do a clean install of your .ipa on named device
+$ briar install pluto
+$ briar install earp
+
+# open a cucumber html report in your default browser
+$ briar report       <== last run against the simulator
+$ briar report venus <== last run against venus
+
+# remove all *-cal targets from the simulator (without resetting the device)
+$ briar rm sim-targets
+
+# resolve APP_BUNDLE_PATH auto-detection problems by removing spurious DerivedData directories
+$ briar rm dups 
+$ briar rm dups briar-ios-example 
+
+# change the simulator version
+$ briar sim ipad_r
+$ briar sim iphone_4in
+```
+
 ## Xamarin Test Cloud
 
 There is currently an issue with using briar predefined steps on the XTC:
 
 ```