From af96388f6aa2c5cded1729cb52e15fcbd30cd766 Mon Sep 17 00:00:00 2001
From: mpabi <mpabi@mpabi.pl>
Date: Wed, 29 Apr 2026 02:13:48 +0200
Subject: [PATCH] Clarify tokens json bootstrap flow

---
 README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/README.md b/README.md
index abecc46..f63fcb8 100644
--- a/README.md
+++ b/README.md
@@ -217,6 +217,10 @@ Etap 4: sprawdź store i wpisz credentials ze store do remota `r1`:
 ./rvctl tokens sync store r1
 ```
 
+`tokens list store` sprawdza, czy skopiowany `tokens.json` zawiera wpis dla
+remota `r1`. `tokens sync store r1` bierze token ze store i wpisuje credentials
+do git remota `r1`, tak aby kolejne operacje Git mogły używać tego tokena.
+
 `list store` powinien pokazać token ze store:
 
 ```text
@@ -245,6 +249,10 @@ Etap 5: odśwież metadane tokena i porównaj store z remote:
 ./rvctl tokens compare
 ```
 
+`tokens update r1` odpytuje Gitea API dla tokena ze store i odświeża jego
+metadane: ważność, zakresy oraz uprawnienia w organizacji i repo. `tokens
+compare` sprawdza potem, czy store i git remote wskazują ten sam token.
+
 `compare` powinien pokazać `*` przy `r1`, jeżeli remote i `tokens.json` są
 zgodne: