Update README.md
diff --git a/README.md b/README.md
index bcee2fd..e282392 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,33 @@
# cli_util
-A micro framework for building commandline apps.
+Utilities to help in building Dart command-line apps.
+
+In particular, ``cli_util`` provides a simple, standardized way to get the current SDK directory. Useful, especially, when building client applications that interact with the Dart SDK (such as the [analyzer](https://pub.dartlang.org/packages/analyzer)).
+
+## Install
+
+```shell
+pub global activate cli_util
+```
+
+## Usage
+
+```dart
+import 'dart:io';
+
+import 'package:cli_util/cli_util.dart';
+import 'package:path/path.dart' as path;
+
+main(args) {
+
+ // Get sdk dir from cli_util
+ Directory sdkDir = getSdkDir(args);
+
+ // Do stuff... For example, print version string
+ File versionFile = new File(path.join(sdkDir.path, 'version'));
+ print(versionFile.readAsStringSync());
+}
+```
## Features and bugs
