From ff639015c216944d119f7b417007e9edf9ae64af Mon Sep 17 00:00:00 2001
From: DIvan2000 <divan@divan2000.su>
Date: Fri, 24 Apr 2026 19:51:28 +0400
Subject: [PATCH] docs(cli): update README and help text for runtime config

---
 README.md           | 34 +++++++++++++++++++++-------------
 src/osc.nim         |  2 +-
 src/osc_braille.nim |  2 +-
 3 files changed, 23 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index 7dfbacb..cd0478e 100644
--- a/README.md
+++ b/README.md
@@ -57,22 +57,30 @@ sudo ln -s $(pwd)/osc /usr/local/bin/osc
 
 ## Configuration
 
-Edit the constants at the top of `src/osc.nim` or `src/osc_braille.nim`:
+Runtime options can be passed via CLI flags:
 
-```nim
-const
-  # Phosphor physics
-  Decay = 0.85           # persistence per frame (0.0–1.0)
-  Beam = 0.4             # intensity at beam impact
-  Bloom = 0.08           # horizontal glow spread
+```bash
+./osc --palette:amber --decay:0.92 --beam:0.6 --bloom:0.12
+./osc_braille --palette:green --hot:0.8 --warm:0.45 --cool:0.12
+```
 
-  # Phosphor glow thresholds
-  HotGlow = 0.7          # white-hot beam core
-  WarmGlow = 0.4         # bright phosphor
-  CoolGlow = 0.15        # dim persistence trail
+Available options:
 
-  # Palette: green, amber, cyan, blue, white, red
-  Palette = "green"
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-p`, `--palette:NAME` | Palette name | `green` |
+| `-d`, `--decay:FLOAT` | Phosphor persistence per frame | `0.85` |
+| `--beam:FLOAT` | Beam impact intensity | `0.4` |
+| `--bloom:FLOAT` | Horizontal glow spread | `0.08` |
+| `--hot:FLOAT` | White-hot beam core threshold | `0.7` |
+| `--warm:FLOAT` | Bright phosphor threshold | `0.4` |
+| `--cool:FLOAT` | Dim persistence trail threshold | `0.15` |
+
+Show help:
+
+```bash
+./osc --help
+./osc_braille --help
 ```
 
 ### Palettes
diff --git a/src/osc.nim b/src/osc.nim
index df8bccb..4ec0a1d 100644
--- a/src/osc.nim
+++ b/src/osc.nim
@@ -47,7 +47,7 @@ Palettes:
   green, amber, cyan, blue, white, red
 
 Example:
-  ./oscilloscope --palette:amber --decay:0.92 --beam:0.6 --bloom:0.12
+  ./osc --palette:amber --decay:0.92 --beam:0.6 --bloom:0.12
 """
 
 proc parseConfig(): Config =
diff --git a/src/osc_braille.nim b/src/osc_braille.nim
index b89422f..5f437f9 100644
--- a/src/osc_braille.nim
+++ b/src/osc_braille.nim
@@ -43,7 +43,7 @@ Options:
   -h, --help           Show this help
 
 Example:
-  ./oscilloscope --palette:amber --decay:0.92 --beam:0.6 --bloom:0.12
+  ./osc_braille --palette:amber --decay:0.92 --beam:0.6 --bloom:0.12
 """
 
 proc parseConfig(): Config =