Addong docs for xossh
Change-Id: Ice53c653cdaa15ecd9bac6d9948077bd5aaf4884
diff --git a/docs/dev/xossh.md b/docs/dev/xossh.md
new file mode 100644
index 0000000..dfe37c0
--- /dev/null
+++ b/docs/dev/xossh.md
@@ -0,0 +1,27 @@
+# XOSSH
+
+XOSSH is a cli tool that lets you perfom operations on the data model.
+To set it up, connect to your `headnode` and execute:
+
+```bash
+bash /opt/cord/orchestration/xos/xos/tools/xossh
+```
+
+It will connect to the `grpc` APIs exposed by `xos-core` and start a `python` shell.
+Once started you should see this on your console:
+
+```bash
+__ __ ____ _____ _____ _ _
+\ \ / / / __ \ / ____| / ____| | | | |
+ \ V / | | | | | (___ | (___ | |__| |
+ > < | | | | \___ \ \___ \ | __ |
+ / . \ | |__| | ____) | ____) | | | | |
+/_/ \_\ \____/ |_____/ |_____/ |_| |_|
+
+XOS Core server at xos-core.cord.lab:50051
+Type "listObjects()" for a list of all objects
+Type "listUtility()" for a list of utility functions
+Type "login("username", "password")" to switch to a secure shell
+Type "examples()" for some examples
+xossh >>>
+```
\ No newline at end of file