newsline-cli 0.1.6 → 1.0.0

package/README.md

@@ -29,7 +29,7 @@ npm i -g newsline-cli && newsline init
 /plugin install newsline@itdar
 ```
 
-The news line appears on your **next message** — no restart. Setup asks for a language & topic
+The news line appears on your **next message** — no restart. Setup asks for a language, topic & headline color
 and keeps your existing status line.
 
 ## What it does
@@ -70,6 +70,30 @@ Re-run `newsline init`, or edit `~/.config/newsline/config.json`:
 | `count` | `15` | headlines in rotation |
 | `maxlen` | `120` | max characters (`max` = no cut) |
 | `icon` | `📰` | leading glyph (`none` to hide) |
+| `color` | `cyan` | headline color: `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+
+Set one directly with `newsline color <name>` (e.g. `newsline color gray`), or run
+`newsline color` with no name to step to the next color (default → gray → white → cyan →
+yellow → green → blue → magenta → red). `newsline colorlist` lists them all with a live
+preview. Changes show on the next status-line tick.
+
+## Update
+
+Update the same way you installed — your language/topic/color settings are kept:
+
+```sh
+# curl — re-run the installer (skips setup, just refreshes the CLI)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Claude Code plugin: run `/plugin marketplace update itdar`, then `/reload-plugins`
+(or restart). You can also enable background auto-update under `/plugin` → **Marketplaces**.
 
 ## Uninstall
 

package/newsline

@@ -4,6 +4,8 @@
 #   newsline init        interactive setup: language, topic, status-line wiring.
 #                        COMPOSES with an existing status line (e.g. your HUD),
 #                        so rate-limit / context info stays visible.
+#   newsline color [c]   set the headline color (or cycle to the next when no name).
+#   newsline colorlist   list the available headline colors with a live preview.
 #   newsline render      what settings.json runs each refresh (base HUD + news).
 #   newsline refresh     force a cache refresh now.
 #   newsline once        fetch + print headlines once (debug).
@@ -77,8 +79,8 @@ load_config() {
 import json,sys,shlex
 env={"lang":"NEWSLINE_LANG","topic":"NEWSLINE_TOPIC","rotate":"NEWSLINE_ROTATE",
      "count":"NEWSLINE_COUNT","maxlen":"NEWSLINE_MAXLEN","icon":"NEWSLINE_ICON",
-     "linkhint":"NEWSLINE_LINKHINT","api":"NEWSLINE_API","endpoint":"NEWSLINE_ENDPOINT",
-     "base_statusline":"NEWSLINE_BASE"}
+     "color":"NEWSLINE_COLOR","linkhint":"NEWSLINE_LINKHINT","api":"NEWSLINE_API",
+     "endpoint":"NEWSLINE_ENDPOINT","base_statusline":"NEWSLINE_BASE"}
 try: d=json.load(open(sys.argv[1]))
 except Exception: d={}
 for k,name in env.items():
@@ -152,7 +154,7 @@ cmd_once() {
 }
 
 cmd_init() {
-  local lang="" topic="" api="" endpoint="" rotate="6" count="15" compose="auto" yes="0" base_override="" a
+  local lang="" topic="" color="" api="" endpoint="" rotate="6" count="15" compose="auto" yes="0" base_override="" a
   while [ $# -gt 0 ]; do
     case "$1" in
       --lang) lang="$2"; shift 2;;      --topic) topic="$2"; shift 2;;
@@ -189,8 +191,16 @@ cmd_init() {
         sports "Sports" science "Science" health "Health" entertainment "Entertainment"
       topic="$CHOICE"
     fi
+    local cur_color; cur_color=$(cfg_get color)
+    echo "Select headline color (change anytime: newsline color):" >&2
+    choose "${cur_color:-cyan}" \
+      default "Terminal default" cyan "Cyan" gray "Gray" white "White" \
+      yellow "Yellow" green "Green" blue "Blue" magenta "Magenta" red "Red"
+    color="$CHOICE"
   else
+    # --yes: keep a color previously set via init/`newsline color`; cyan on first run
     lang="${lang:-$detected}"; topic="${topic:-general}"
+    color=$(cfg_get color); [ -n "$color" ] || color="cyan"
   fi
 
   # Always KEEP an existing status line and show newsline below it (no prompt).
@@ -210,13 +220,14 @@ cmd_init() {
   fi
 
   mkdir -p "$CONFIG_DIR"
-  python3 - "$CONFIG" "$lang" "$topic" "$rotate" "$count" "$api" "$endpoint" "$base" "$base_obj" <<'PY' || { echo "✗ could not write $CONFIG" >&2; return 1; }
+  python3 - "$CONFIG" "$lang" "$topic" "$rotate" "$count" "$api" "$endpoint" "$base" "$base_obj" "$color" <<'PY' || { echo "✗ could not write $CONFIG" >&2; return 1; }
 import json,os,sys
-_,path,lang,topic,rotate,count,api,endpoint,base,base_obj=sys.argv
+_,path,lang,topic,rotate,count,api,endpoint,base,base_obj,color=sys.argv
 try:
     d={"lang":lang,"topic":topic,"rotate":int(rotate),"count":int(count)}
 except ValueError:
     sys.stderr.write("newsline: --rotate/--count must be integers\n"); sys.exit(3)
+if color and color not in ("default","none","off"): d["color"]=color
 if api: d["api"]=api
 if endpoint: d["endpoint"]=endpoint
 if base: d["base_statusline"]=base
@@ -257,6 +268,79 @@ PY
   echo "  It appears on your next message to Claude — no restart needed."
 }
 
+# canonical headline palette — single source of truth for cycling, listing, and
+# validation. "default" means the terminal's own color (no SGR); the rest map to
+# the SGR codes in statusline.sh (nl_sgr below mirrors that mapping).
+NL_PALETTE="default gray white cyan yellow green blue magenta red"
+
+nl_sgr() { # color name -> SGR params (empty = terminal default). Mirrors statusline.sh.
+  case "$1" in
+    dim)        echo "2"  ;;
+    gray|grey)  echo "90" ;;
+    red)        echo "31" ;;  green)   echo "32" ;;  yellow) echo "33" ;;
+    blue)       echo "34" ;;  magenta) echo "35" ;;  cyan)   echo "36" ;;
+    white)      echo "37" ;;  orange)  echo "38;5;208" ;;
+    *)          echo ""   ;;
+  esac
+}
+
+nl_write_color() { # nl_write_color <name> — persist the chosen color to config
+  mkdir -p "$CONFIG_DIR"
+  python3 - "$CONFIG" "$1" <<'PY' || { echo "✗ could not write $CONFIG" >&2; return 1; }
+import json,os,sys
+path,color=sys.argv[1],sys.argv[2]
+try: d=json.load(open(path))
+except Exception: d={}
+if color in ("default","none","off"): d.pop("color",None)
+else: d["color"]=color
+tmp=path+".tmp"
+with open(tmp,"w") as f: json.dump(d,f,indent=2,ensure_ascii=False)
+os.replace(tmp,path)
+PY
+}
+
+cmd_colorlist() { # newsline colorlist — list the palette, each shown in its own color
+  local cur c sgr mark; cur=$(cfg_get color); [ -n "$cur" ] || cur=default
+  echo "Headline colors (set with: newsline color <name>):"
+  for c in $NL_PALETTE; do
+    [ "$c" = "$cur" ] && mark="  ← current" || mark=""
+    sgr=$(nl_sgr "$c")
+    if [ -n "$sgr" ]; then
+      printf '  \033[%sm%-8s 📰 sample headline\033[0m%s\n' "$sgr" "$c" "$mark"
+    else
+      printf '  %-8s 📰 sample headline%s\n' "$c" "$mark"
+    fi
+  done
+}
+
+cmd_color() { # newsline color [name] — set a color; with no name, step to the next one
+  local cur new arg; arg="${1:-}"
+  case "$arg" in list|ls|--list) cmd_colorlist; return $? ;; esac
+  if [ -n "$arg" ]; then
+    new="$(printf '%s' "$arg" | tr '[:upper:]' '[:lower:]')"
+    case "$new" in grey) new=gray ;; none|off) new=default ;; esac
+    case " $NL_PALETTE " in
+      *" $new "*) ;;
+      *) echo "✗ unknown color: $arg" >&2
+         echo "  choose from: $NL_PALETTE   (see: newsline colorlist)" >&2
+         return 1 ;;
+    esac
+  else                                   # no name: cycle to the next color, wrapping
+    cur=$(cfg_get color)
+    new=$(NL_PALETTE="$NL_PALETTE" python3 - "${cur:-default}" <<'PY'
+import os,sys
+p=os.environ["NL_PALETTE"].split()
+c=sys.argv[1]
+print(p[(p.index(c)+1)%len(p)] if c in p else p[0])
+PY
+)
+  fi
+  nl_write_color "$new" || return 1
+  echo "✔ headline color: $new — preview:"
+  load_config
+  "$HERE/statusline.sh"; echo
+}
+
 cmd_uninstall() {
   local base base_obj
   base=$(cfg_get base_statusline)
@@ -299,7 +383,13 @@ PY
 usage() {
   cat <<'EOF'
 newsline — local news status-line utility
-  newsline init [--lang ko] [--topic tech]   set up & wire the status line
+  newsline init [--lang ko] [--topic tech]    set up & wire the status line
+                                              (asks language / topic / color)
+  newsline color [name]                       set headline color (e.g. cyan, gray); with
+                                              no name, step to the next: default → gray →
+                                              white → cyan → yellow → green → blue →
+                                              magenta → red → back to default
+  newsline colorlist                          list the available colors with a preview
   newsline uninstall                          remove & restore previous status line
 EOF
   if [ "${1:-}" = "--all" ]; then
@@ -318,6 +408,8 @@ case "${1:-help}" in
   refresh) shift; cmd_refresh "$@";;
   once) shift; cmd_once "$@";;
   init) shift; cmd_init "$@";;
+  color) shift; cmd_color "$@";;
+  colorlist|colors) shift; cmd_colorlist;;
   uninstall) shift; cmd_uninstall "$@";;
   help|-h|--help) shift; usage "$@";;
   *) usage; exit 1;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newsline-cli",
-  "version": "0.1.6",
+  "version": "1.0.0",
   "description": "Locale-aware one-line news in your Claude Code status line — local, composes with your existing status line.",
   "bin": {
     "newsline": "newsline"

package/readme/de.md

@@ -31,7 +31,7 @@ npm i -g newsline-cli && newsline init
 ```
 
 Die News-Zeile erscheint bei deiner **nächsten Nachricht** – kein Neustart nötig. Die Einrichtung fragt
-nach Sprache und Thema und behält deine bestehende Statusleiste bei.
+nach Sprache, Thema und Schlagzeilenfarbe und behält deine bestehende Statusleiste bei.
 
 ## Was es macht
 
@@ -73,6 +73,30 @@ Führe `newsline init` erneut aus oder bearbeite `~/.config/newsline/config.json
 | `count` | `15` | Schlagzeilen im Wechsel |
 | `maxlen` | `120` | maximale Zeichen (`max` = kein Abschneiden) |
 | `icon` | `📰` | vorangestelltes Symbol (`none` zum Ausblenden) |
+| `color` | `cyan` | Farbe der Schlagzeile: `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+
+Eine direkt setzen mit `newsline color <name>` (z. B. `newsline color gray`), oder
+`newsline color` ohne Namen ausführen, um zur nächsten Farbe zu wechseln (default → gray →
+white → cyan → yellow → green → blue → magenta → red). `newsline colorlist` listet alle mit
+Vorschau auf; Änderungen erscheinen beim nächsten Statuszeilen-Refresh.
+
+## Aktualisieren
+
+Aktualisiere so, wie du installiert hast — deine Sprache/Thema/Farbe bleiben erhalten:
+
+```sh
+# curl — Installer erneut ausführen (überspringt die Einrichtung, aktualisiert nur die CLI)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Claude-Code-Plugin: `/plugin marketplace update itdar`, dann `/reload-plugins`
+(oder neu starten). Aktiviere die automatische Aktualisierung unter `/plugin` → **Marketplaces**.
 
 ## Deinstallieren
 

package/readme/es.md

@@ -30,7 +30,7 @@ npm i -g newsline-cli && newsline init
 ```
 
 La línea de noticias aparece en tu **próximo mensaje**, sin reiniciar. La configuración te pregunta el
-idioma y el tema, y conserva tu barra de estado actual.
+idioma, el tema y el color del titular, y conserva tu barra de estado actual.
 
 ## Qué hace
 
@@ -72,6 +72,30 @@ Vuelve a ejecutar `newsline init` o edita `~/.config/newsline/config.json`:
 | `count` | `15` | titulares en rotación |
 | `maxlen` | `120` | caracteres máximos (`max` = sin recorte) |
 | `icon` | `📰` | icono inicial (`none` para ocultarlo) |
+| `color` | `cyan` | color del titular: `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+
+Fija uno directamente con `newsline color <nombre>` (p. ej. `newsline color gray`), o usa
+`newsline color` sin nombre para pasar al siguiente color (default → gray → white → cyan →
+yellow → green → blue → magenta → red). `newsline colorlist` los muestra todos con una
+vista previa; los cambios se ven en el próximo refresco de la línea de estado.
+
+## Actualizar
+
+Actualiza igual que instalaste — se conservan tus ajustes de idioma/tema/color:
+
+```sh
+# curl — vuelve a ejecutar el instalador (omite la configuración, solo actualiza la CLI)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Plugin de Claude Code: ejecuta `/plugin marketplace update itdar` y luego `/reload-plugins`
+(o reinicia). También puedes activar la actualización automática en `/plugin` → **Marketplaces**.
 
 ## Desinstalar
 

package/readme/fr.md

@@ -30,7 +30,7 @@ npm i -g newsline-cli && newsline init
 ```
 
 La ligne d'actualité apparaît dès votre **prochain message** — sans redémarrage. La configuration vous
-demande une langue et un thème, et conserve votre barre d'état existante.
+demande une langue, un thème et une couleur de titre, et conserve votre barre d'état existante.
 
 ## Ce que ça fait
 
@@ -73,6 +73,30 @@ Relancez `newsline init`, ou modifiez `~/.config/newsline/config.json` :
 | `count` | `15` | titres en rotation |
 | `maxlen` | `120` | caractères maximum (`max` = sans coupure) |
 | `icon` | `📰` | icône de tête (`none` pour masquer) |
+| `color` | `cyan` | couleur du titre : `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+
+Définissez-en une directement avec `newsline color <nom>` (p. ex. `newsline color gray`), ou
+utilisez `newsline color` sans nom pour passer à la couleur suivante (default → gray → white →
+cyan → yellow → green → blue → magenta → red). `newsline colorlist` les liste toutes avec un
+aperçu ; les changements sont visibles au prochain rafraîchissement de la ligne d'état.
+
+## Mettre à jour
+
+Mettez à jour comme vous avez installé — vos réglages de langue/thème/couleur sont conservés :
+
+```sh
+# curl — relancez l'installateur (ignore la configuration, met juste à jour la CLI)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Plugin Claude Code : `/plugin marketplace update itdar`, puis `/reload-plugins`
+(ou redémarrez). Activez la mise à jour automatique dans `/plugin` → **Marketplaces**.
 
 ## Désinstaller
 

package/readme/ja.md

@@ -29,7 +29,7 @@ npm i -g newsline-cli && newsline init
 /plugin install newsline@itdar
 ```
 
-ニュース行は **次のメッセージ** で表示されます — 再起動は不要です。セットアップで言語とトピックを
+ニュース行は **次のメッセージ** で表示されます — 再起動は不要です。セットアップで言語・トピック・文字色を
 尋ね、既存のステータスラインはそのまま保持します。
 
 ## 何をするか
@@ -71,6 +71,30 @@ npm i -g newsline-cli && newsline init
 | `count` | `15` | 切り替えるヘッドライン数 |
 | `maxlen` | `120` | 最大文字数（`max` = 無制限） |
 | `icon` | `📰` | 先頭アイコン（`none` で非表示） |
+| `color` | `cyan` | 見出しの文字色：`default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+
+`newsline color <名前>` で色を直接指定でき（例：`newsline color gray`）、名前なしで
+`newsline color` を実行すると次の色へ進みます（default → gray → white → cyan → yellow →
+green → blue → magenta → red）。`newsline colorlist` で全色をプレビュー付きで一覧でき、
+変更は次のステータスライン更新で反映されます。
+
+## アップデート
+
+インストールした方法と同じ手順で更新できます — 言語・トピック・色の設定は保持されます:
+
+```sh
+# curl — インストーラを再実行（セットアップはスキップし、CLI のみ更新）
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Claude Code プラグイン: `/plugin marketplace update itdar` を実行後、`/reload-plugins`
+（または再起動）。`/plugin` → **Marketplaces** でバックグラウンド自動更新も有効にできます。
 
 ## アンインストール
 

package/readme/ko.md

@@ -29,7 +29,7 @@ npm i -g newsline-cli && newsline init
 /plugin install newsline@itdar
 ```
 
-뉴스 줄은 **다음 메시지 때** 나타납니다 — 재시작 불필요. 셋업은 언어·분야를 물어보고, 기존
+뉴스 줄은 **다음 메시지 때** 나타납니다 — 재시작 불필요. 셋업은 언어·분야·글자 색을 물어보고, 기존
 상태줄은 유지합니다.
 
 ## 무엇을 하나
@@ -67,6 +67,30 @@ npm i -g newsline-cli && newsline init
 | `count` | `15` | 회전 헤드라인 수 |
 | `maxlen` | `120` | 최대 글자수 (`max`=무제한) |
 | `icon` | `📰` | 앞 아이콘 (`none`이면 제거) |
+| `color` | `cyan` | 뉴스 글자 색: `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+
+`newsline color <이름>`으로 색을 바로 지정하거나(예: `newsline color gray`), 이름 없이
+`newsline color`를 실행하면 다음 색으로 넘어갑니다 (default → gray → white → cyan →
+yellow → green → blue → magenta → red). `newsline colorlist`로 전체 색 목록을 미리보기와
+함께 확인할 수 있고, 변경은 다음 상태줄 갱신 때 반영됩니다.
+
+## 업데이트
+
+설치했던 방식 그대로 업데이트하면 됩니다 — 언어·분야·색 설정은 유지됩니다:
+
+```sh
+# curl — 설치 스크립트 재실행 (셋업은 건너뛰고 CLI만 갱신)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Claude Code 플러그인: `/plugin marketplace update itdar` 실행 후 `/reload-plugins`
+(또는 재시작). `/plugin` → **Marketplaces**에서 백그라운드 자동 업데이트도 켤 수 있습니다.
 
 ## 제거
 

package/readme/pt.md

@@ -30,7 +30,7 @@ npm i -g newsline-cli && newsline init
 ```
 
 A linha de notícias aparece na sua **próxima mensagem** — sem reiniciar. A configuração pergunta o
-idioma e o tema, e mantém a sua barra de status atual.
+idioma, o tema e a cor da manchete, e mantém a sua barra de status atual.
 
 ## O que faz
 
@@ -71,6 +71,30 @@ Execute `newsline init` novamente ou edite `~/.config/newsline/config.json`:
 | `count` | `15` | manchetes na rotação |
 | `maxlen` | `120` | máximo de caracteres (`max` = sem corte) |
 | `icon` | `📰` | ícone inicial (`none` para ocultar) |
+| `color` | `cyan` | cor da manchete: `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+
+Defina uma diretamente com `newsline color <nome>` (ex.: `newsline color gray`), ou use
+`newsline color` sem nome para avançar para a próxima cor (default → gray → white → cyan →
+yellow → green → blue → magenta → red). `newsline colorlist` mostra todas com uma prévia;
+as mudanças aparecem no próximo refresh da linha de status.
+
+## Atualizar
+
+Atualize da mesma forma que instalou — suas configurações de idioma/tema/cor são mantidas:
+
+```sh
+# curl — execute o instalador de novo (pula a configuração, só atualiza a CLI)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Plugin do Claude Code: `/plugin marketplace update itdar` e depois `/reload-plugins`
+(ou reinicie). Ative a atualização automática em `/plugin` → **Marketplaces**.
 
 ## Desinstalar
 

package/readme/zh.md

@@ -29,7 +29,7 @@ npm i -g newsline-cli && newsline init
 /plugin install newsline@itdar
 ```
 
-新闻行会在你的 **下一条消息** 时出现——无需重启。设置会询问语言和主题，并保留你现有的状态栏。
+新闻行会在你的 **下一条消息** 时出现——无需重启。设置会询问语言、主题和文字颜色，并保留你现有的状态栏。
 
 ## 它做什么
 
@@ -65,6 +65,29 @@ npm i -g newsline-cli && newsline init
 | `count` | `15` | 轮播头条数量 |
 | `maxlen` | `120` | 最大字符数（`max` = 不截断） |
 | `icon` | `📰` | 前置图标（`none` 为隐藏） |
+| `color` | `cyan` | 新闻文字颜色：`default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+
+用 `newsline color <名称>` 直接设置颜色（如 `newsline color gray`），或不带名称运行
+`newsline color` 切换到下一种颜色（default → gray → white → cyan → yellow → green → blue →
+magenta → red）。`newsline colorlist` 会列出所有颜色并附带预览，更改在下次状态栏刷新时生效。
+
+## 更新
+
+按你安装的方式更新即可 — 语言/主题/颜色设置会保留：
+
+```sh
+# curl — 重新运行安装脚本（跳过设置，仅更新 CLI）
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Claude Code 插件：运行 `/plugin marketplace update itdar`，然后 `/reload-plugins`
+（或重启）。也可在 `/plugin` → **Marketplaces** 中启用后台自动更新。
 
 ## 卸载
 

package/refresh.sh

@@ -23,7 +23,7 @@ case "$API" in off|OFF|none|local) API="" ;; esac
 COUNT="${NEWSLINE_COUNT:-15}"         # how many headlines to cache for rotation
 # Client version, sent to /feed as ?v= for the server-side update nudge.
 # Bump together with package.json when tagging a release.
-export NEWSLINE_VERSION="${NEWSLINE_VERSION:-0.1.6}"
+export NEWSLINE_VERSION="${NEWSLINE_VERSION:-1.0.0}"
 LOCK="$CACHE_DIR/refresh.lock"
 mkdir -p "$CACHE_DIR" 2>/dev/null
 

package/statusline.sh

@@ -24,6 +24,24 @@ if [ "$needs_refresh" = "1" ]; then
   ( "$HERE/refresh.sh" >/dev/null 2>&1 & ) 2>/dev/null
 fi
 
+# --- optional headline color (NEWSLINE_COLOR: a name, or raw SGR params) ---
+# Applied at PRINT time, not baked into the cache, so `newsline color` shows up
+# on the next status-line tick without waiting for a refresh.
+SGR=""
+case "$(printf '%s' "${NEWSLINE_COLOR:-}" | tr '[:upper:]' '[:lower:]')" in
+  ''|default|none|off) SGR="" ;;
+  dim)        SGR="2"  ;;
+  gray|grey)  SGR="90" ;;
+  red)        SGR="31" ;;  green)   SGR="32" ;;  yellow) SGR="33" ;;
+  blue)       SGR="34" ;;  magenta) SGR="35" ;;  cyan)   SGR="36" ;;
+  white)      SGR="37" ;;  orange)  SGR="38;5;208" ;;
+  *[!0-9\;]*) SGR="" ;;                  # unknown name — ignore, print plain
+  *)          SGR="${NEWSLINE_COLOR}" ;; # raw SGR params, e.g. "38;5;245"
+esac
+colorize() { # wrap text in the configured color (no-op when unset); no newline
+  if [ -n "$SGR" ]; then printf '\033[%sm%s\033[0m' "$SGR" "$1"; else printf '%s' "$1"; fi
+}
+
 # --- print one headline, rotating across the cached set by wall-clock time ---
 # The cache holds N headlines (one per line). We show a different one every
 # NEWSLINE_ROTATE seconds — a ticker feel with zero stored state.
@@ -35,12 +53,12 @@ if [ -s "$CACHE_FILE" ]; then
     [ "$rot" -ge 1 ] || rot=6            # 0 would divide by zero below
     now="${NEWSLINE_NOW:-$(date +%s)}"   # NEWSLINE_NOW overrides clock (tests/debug)
     idx=$(( (now / rot) % n + 1 ))
-    sed -n "${idx}p" "$CACHE_FILE"
+    colorize "$(sed -n "${idx}p" "$CACHE_FILE")"; printf '\n'
   else
-    printf '📰 …'
+    colorize '📰 …'
   fi
 else
-  printf '📰 …'   # first run, before the first refresh lands
+  colorize '📰 …'   # first run, before the first refresh lands
 fi
 
 # --- server-driven update nudge (written/cleared by refresh.sh), below the news ---