diff --git a/README.md b/README.md
index ce79d75..12d42e8 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,82 @@
-# skywipe
+# Skywipe
 
-Clean your bluesky account with style
\ No newline at end of file
+Skywipe is a work-in-progress Python 3.13+ CLI that helps you wipe data from your Bluesky account using the AT Protocol (`atproto` library).
+
+## Warning
+
+This tool performs destructive operations. Only use it if you intend to erase data from your Bluesky account.
+
+## Requirements
+
+- Python 3.13+
+- [`atproto`](https://atproto.blue/en/latest/)
+- [`uv`](https://github.com/astral-sh/uv) for dependency and virtual environment management
+
+## Setup
+
+```bash
+git clone https://git.kharec.info/Kharec/skywipe.git
+cd skywipe
+uv sync  # creates a local virtualenv and installs dependencies
+```
+
+## How to run
+
+When installation will be worked out, you'll be able to :
+
+```bash
+skywipe all            # target everything
+skywipe configure      # create configuration
+skywipe posts          # only posts
+skywipe medias         # only posts with medias
+skywipe likes          # only likes
+skywipe reposts        # only reposts
+skywipe follows        # only follows
+```
+
+While it's being developed, you can use the tool using `uv` :
+
+```bash
+uv run main.py all            # target everything
+uv run main.py configure      # create configuration
+uv run main.py posts          # only posts
+uv run main.py medias         # only posts with medias
+uv run main.py likes          # only likes
+uv run main.py reposts        # only reposts
+uv run main.py follows        # only follows
+```
+
+### Configuration
+
+If you run the tool for the first time, it will prompt you to use `skywipe configure` to create the configuration file, which is located in `~/.config/skywipe/`.
+
+It looks like this :
+
+```yaml
+handle: your_handle
+password: your_password
+batch_size: 10
+delay: 1
+verbose: true
+```
+
+BE SURE TO USE A [BLUESKY APP PASSWORD](https://blueskyfeeds.com/faq-app-password) FOR OBVIOUS SECURITY REASONS.
+
+## Roadmap
+
+- [ ] build cli parameter management
+- [ ] handle configuration logic
+- [ ] sign in to at protocol
+- [ ] delete posts in groups
+- [ ] only delete posts with media
+- [ ] remove likes
+- [ ] remove reposts
+- [ ] unfollow accounts
+- [ ] make `all` run the other commands
+- [ ] add simple progress and logging
+- [ ] add safeguards like confirmations and clear dry-run info
+- [ ] installation and run process
+
+## License
+
+This project is licensed under the GPLv3+ License. See the [LICENSE](LICENSE) file for details.