diff --git a/README.md b/README.md
index ed4322d0454..9a6907a9963 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@ Please put all issues regarding go IPFS _implementation_ in [this repo](https://
 
 ```
 git clone https://github.com/jbenet/go-ipfs
-cd go-ipfs
+cd go-ipfs/cmd/ipfs
 go install
 ```
 
diff --git a/cmd/ipfs/README.md b/cmd/ipfs/README.md
new file mode 100644
index 00000000000..0051f68e939
--- /dev/null
+++ b/cmd/ipfs/README.md
@@ -0,0 +1,29 @@
+# go-ipfs/cmd/ipfs
+
+This is the ipfs commandline tool. For now, it's the main entry point to using IPFS. Use it.
+
+```
+> go build
+> go install
+> ipfs
+ipfs - global versioned p2p merkledag file system
+
+Basic commands:
+
+    add <path>    Add an object to ipfs.
+    cat <ref>     Show ipfs object data.
+    ls <ref>      List links from an object.
+    refs <ref>    List link hashes from an object.
+
+Tool commands:
+
+    config        Manage configuration.
+    version       Show ipfs version information.
+    commands      List all available commands.
+
+Advanced Commands:
+
+    mount         Mount an ipfs read-only mountpoint.
+
+Use "ipfs help <command>" for more information about a command.
+```