diff --git a/README.md b/README.md
index b2f63c0..0c03b3b 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,21 @@
 # chrome-protocol-proxy
+
+```chrome-protocol-proxy``` is small proxy designed for ```chrome debugging protocol```. It's purpose is to capture messages written to and received from [Chrome Debugging Protocol](https://chromedevtools.github.io/debugger-protocol-viewer), assemble requests with responses, unpack messages from [Target domain](https://chromedevtools.github.io/debugger-protocol-viewer/tot/Target/) and provide easy to read, styles output. This tool is a fork (and heavily inspired by) of [chromedp-proxy](https://github.com/knq/chromedp/tree/master/cmd/chromedp-proxy).
+
+## usage
+```go get -u github.com/wendigo/chrome-protocol-proxy``` 
+```chrome-protocol-proxy --help```
+
+## configuration options
+```
+  -l string
+    	listen address (default "localhost:9223")
+  -log string
+    	log file mask (default "logs/cdp-%s.log")
+  -n	disable logging to file
+  -r string
+    	remote address (default "localhost:9222")
+  -s	shorten requests and responses
+  ```
+  
+## example