From 26303921861565dbf1bb966f9cc1f0ef3fb1b25d Mon Sep 17 00:00:00 2001
From: mpabi <mpabi@mpabi.pl>
Date: Wed, 29 Apr 2026 00:54:52 +0200
Subject: [PATCH] Clarify launcher README intro

---
 README.md | 27 +++++++++++++++++++++------
 1 file changed, 21 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 48df6bf..facf73c 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,32 @@
 # RV Launcher
 
-`rv-launcher` jest narzedziem do pracy z workspace RISC-V. Publiczna komenda
-narzedzia to `rvctl`; obsluguje tokeny, listuje serie i karty, przygotowuje
-repo odpowiedzi i uruchamia kontener.
+Repo `rv-launcher` zawiera narzedzie do pracy z workspace RISC-V. W pierwszej
+kolejnosci sluzy ono do zarzadzania tokenami; pozostale funkcje obejmuja prace
+z kartami pracy i uruchamianie srodowiska kontenerowego.
 
-`rvctl` jest krotkim wrapperem:
+Wlasciwym skryptem CLI jest wykonywalny plik `rvctl.py`. To on implementuje
+zarzadzanie tokenami, listowanie serii i kart, przygotowanie repo odpowiedzi i
+start kontenera.
+
+Publicznym entrypointem dla uzytkownika jest krotki wrapper `rvctl`:
 
 ```bash
 ./rvctl
 ```
 
-Wrapper uruchamia wykonywalny skrypt `rvctl.py`. Sciezki i domyslne ustawienia
-sa trzymane w `workspace.json`.
+Wrapper uruchamia:
+
+```bash
+python3 rvctl.py "$@"
+```
+
+`rvctl.py` mozna tez uruchomic bezposrednio:
+
+```bash
+./rvctl.py
+```
+
+Sciezki i domyslne ustawienia sa trzymane w `workspace.json`.
 
 ## Co robi narzedzie