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