diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1a77acb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# Snekbot CLI Client
+
+Simple asynchronous CLI client for Snekbot, connecting via WebSocket for channel messaging.
+
+## Features
+- Login with username/password
+- List/join channels
+- Send/receive messages with Markdown-to-ANSI formatting
+- Commands: `/join <channel>`, `/channels`, `/quit`
+
+## Requirements
+- Python 3.12+
+- Libraries: `asyncio`, `aiohttp`, `getpass`, `logging`, `re`, `sys`, `traceback`, `typing`
+
+## Installation
+Clone repo and run script:
+```
+git clone <repo-url>
+cd <repo-dir>
+python snek_cli.py
+```
+
+## Usage
+Run script, enter username/password:
+```
+Username: your_username
+Password: your_password
+```
+Connects to `wss://snek.molodetz.nl/rpc.ws`.
+
+In CLI:
+- `/channels` to list
+- `/join <name>` to switch
+- Type message to send
+- `/quit` to exit
+
+## Code
+Single file: `snek_cli.py`
diff --git a/main.py b/snek_cli.py
similarity index 100%
rename from main.py
rename to snek_cli.py