Chat add support for CLI

chat/README.md

@@ -2,4 +2,39 @@
 
 The chat service is an example Micro service which leverages bidirectional streaming, the store and events to build a chat backend. There is both a server and client which can be run together to demonstrate the application (see client/main.go for more instructions on running the service).
 
-The service is documented inline and is designed to act as a reference for the events package.
+The service is documented inline and is designed to act as a reference for the events package.
+
+### Calling the service
+
+You can call the service via the CLI:
+
+Create a chat:
+```bash
+> micro chat new --user_ids=JohnBarry
+{
+	"chat_id": "3c9ea66c-d516-45d4-abe8-082089e18b27"
+}
+```
+
+Send a message to the chat:
+```bash
+> micro chat send --chat_id=bed4f0f0-da12-46d2-90d2-17ae1714a214 --user_id=John --subject=Hello --text='Hey Barry'
+{}
+```
+
+View the chat history
+```bash
+> micro chat history --chat_id=bed4f0f0-da12-46d2-90d2-17ae1714a214
+{
+	"messages": [
+		{
+			"id": "a61284a8-f471-4734-9192-640d89762e98",
+			"client_id": "6ba0d2a6-96fa-47d8-8f6f-7f75b4cc8b3e",
+			"chat_id": "bed4f0f0-da12-46d2-90d2-17ae1714a214",
+			"user_id": "John",
+			"subject": "Hello",
+			"text": "Hey Barry"
+		}
+	]
+}
+```