diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b8c461d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# Treehouse-Bridge
+This application runs various services that listens from the 
+Misskey websocket, Mattermost Websocket, and a Discord Bot to
+move messages and notes between the systems.
+
+It works as the mattermost as the central hub that syncs between discord channels and its own channels
+
+Misskey will post new notes to a mattermost channel (which can also be synced to discord to a specific channel).
+
+The system does its besst to migrate avatars and usernames between apps.
\ No newline at end of file