diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..a491e27
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,23 @@
+# Folyo Client
+
+The Folyo client is a small agent that connects to the Folyo server over WebSockets and registers itself as a device. Once connected and authenticated, it waits for command execution requests, runs them locally through `sh -c`, and sends the exit code, stdout, and stderr back to the server.
+
+## Building
+
+Build the binary:
+
+```bash
+cargo build --release
+```
+
+Build the image:
+
+```bash
+docker build -t client .
+```
+
+## Configuration
+
+- `TOKEN` is required and is sent as `Authorization: Bearer <token>`
+- `BASE_URL` is optional and defaults to `ws://127.0.0.1:8000`
+- `DEVICE_ID` is optional and defaults to `device`