@@ -15,7 +15,7 @@
 If you have Nix with flakes enabled:
 
 ```bash
-nix run git+https:git.alin.ovh/erl -- -exec your-command arg1 arg2
+nix run git+https:git.alin.ovh/erl -- --exec your-command arg1 arg2
 ```
 
 Or install it:
@@ -29,23 +29,41 @@
 Basic usage:
 
 ```bash
-erl -exec go run main.go
+erl --exec go run main.go
 ```
 
 ### Command Line Options
 
-- `-exec string` - Command to execute on file change (required)
+- `--exec string` - Command to execute on file change (optional, defaults to "go run")
+- `--quiet` - Suppress erl's own output
+- `--verbose` - Enable verbose output (print file events)
 
 ### Examples
 
-**Go development:**
+**Go development (explicit):**
 ```bash
-erl -exec go run .
+erl --exec go run .
 ```
 
+**Go development (implicit):**
+```bash
+erl .
+```
+When no `--exec` flag is provided, erl defaults to running `go run` with the provided arguments.
+
 **Build and test:**
 ```bash
-erl -exec make test
+erl --exec make test
+```
+
+**Quiet mode:**
+```bash
+erl --quiet --exec npm start
+```
+
+**Verbose mode:**
+```bash
+erl --verbose --exec python app.py
 ```
 
 ## Development