Make notification title marker configurable (#457)

Author: frederikpyt

README.md

@@ -369,6 +369,7 @@ This means you can:
 - **notification_all_screens** (boolean, default: `true`): Show overlay notifications on all screens (`true`) or only the main screen (`false`). Themed overlays (`glass`, `jarvis`, `sakura`) previously only showed on one screen — existing configs with those themes are migrated to `false` automatically. macOS only.
 - **`CLAUDE_SESSION_NAME` env var**: Set before launching `claude` to give a session a custom name. Shows in both desktop notification titles and terminal tab titles. Priority over all config-based naming. Example: `CLAUDE_SESSION_NAME="Auth Refactor" claude` or `export CLAUDE_SESSION_NAME="Feature: Auth"` then `claude`. Each terminal gets its own title automatically since peon-ping runs as a child of that Claude instance.
 - **notification_title_override** (string, default: `""`): Override the project name shown in notification titles. When empty, the project name is auto-detected from `/peon-ping-rename` > `CLAUDE_SESSION_NAME` > `.peon-label` > `notification_title_script` > `project_name_map` > git repo name > folder name.
+- **notification_title_marker** (string, default: `"●"`): Character(s) shown before the project name in notification titles and terminal tab titles. Set to `""` to disable. Example: `"🔔"`.
 - **notification_title_script** (string, default: `""`): Shell command run at event time to compute the project name dynamically. Receives env vars: `PEON_SESSION_ID`, `PEON_CWD`, `PEON_HOOK_EVENT`, `PEON_SESSION_NAME`. Use stdout (trimmed, max 50 chars); non-zero exit falls through to the next tier. Example: `"basename $PEON_CWD"`.
 - **project_name_map** (object, default: `{}`): Map directory paths to custom project labels for notifications. Keys are path patterns, values are display names. Example: `{ "/home/user/work/client-a": "Client A" }`.
 - **notification_templates** (object, default: `{}`): Custom message format strings for notification events. Keys are event types (`stop`, `permission`, `error`, `idle`, `question`), values are template strings with variable substitution. Available variables: `{project}`, `{summary}`, `{tool_name}`, `{status}`, `{event}`. Example: `{ "stop": "{project}: {summary}", "permission": "{project}: {tool_name} needs approval" }`.

README_ja.md

@@ -358,6 +358,7 @@ peon-ping には3つの独立したコントロールがあり、自由に組み
 - **notification_dismiss_seconds**（数値、デフォルト: `4`）: N 秒後にオーバーレイ通知を自動的に消去。`0` に設定するとクリックで消去するまで永続的に表示。
 - **`CLAUDE_SESSION_NAME` 環境変数**: `claude` 起動前に設定すると、セッションにカスタム名を付けられます。デスクトップ通知タイトルとターミナルタブタイトルの両方に表示されます。すべての設定ベースの命名より優先。例: `CLAUDE_SESSION_NAME="Auth Refactor" claude` または `export CLAUDE_SESSION_NAME="Feature: Auth"` してから `claude`。各ターミナルは自動的に独自のタイトルを取得します。
 - **notification_title_override**（文字列、デフォルト: `""`）: 通知タイトルに表示されるプロジェクト名を上書き。空の場合は自動検出: `/peon-ping-rename` > `CLAUDE_SESSION_NAME` > `.peon-label` > `notification_title_script` > `project_name_map` > git リポジトリ名 > フォルダ名。
+- **notification_title_marker**（文字列、デフォルト: `"●"`）: 通知タイトルとターミナルタブタイトル前に表示される文字。`""` に設定すると無効化。例如：`"🔔"`。
 - **notification_title_script**（文字列、デフォルト: `""`）: イベント発生時に実行されるシェルコマンドで、プロジェクト名を動的に計算。利用可能な環境変数: `PEON_SESSION_ID`、`PEON_CWD`、`PEON_HOOK_EVENT`、`PEON_SESSION_NAME`。stdout を使用（トリミング済み、最大50文字）; 非ゼロ終了は次のティアにフォールスルー。例: `"basename $PEON_CWD"`。
 - **project_name_map**（オブジェクト、デフォルト: `{}`）: ディレクトリパスを通知のカスタムプロジェクトラベルにマッピング。キーはパスパターン、値は表示名。例: `{ "/home/user/work/client-a": "Client A" }`。
 - **notification_templates**（オブジェクト、デフォルト: `{}`）: 通知イベントのカスタムメッセージフォーマット文字列。キーはイベントタイプ（`stop`、`permission`、`error`、`idle`、`question`）、値は変数置換付きのテンプレート文字列。利用可能な変数: `{project}`、`{summary}`、`{tool_name}`、`{status}`、`{event}`。例: `{ "stop": "{project}: {summary}", "permission": "{project}: {tool_name} needs approval" }`。

README_zh.md

@@ -361,6 +361,7 @@ peon-ping 有三个独立的控制开关，可以混合使用：
 - **notification_dismiss_seconds**（数字，默认：`4`）：覆盖通知在 N 秒后自动消失。设为 `0` 则通知持续显示，需点击关闭。
 - **`CLAUDE_SESSION_NAME` 环境变量**：在启动 `claude` 前设置，为会话指定自定义名称。同时显示在桌面通知标题和终端标签标题中，优先级高于所有配置项。示例：`CLAUDE_SESSION_NAME="Auth Refactor" claude` 或先 `export CLAUDE_SESSION_NAME="功能: Auth"` 再 `claude`。
 - **notification_title_override**（字符串，默认：`""`）：覆盖通知标题中显示的项目名称。为空时自动检测：`/peon-ping-rename` > `CLAUDE_SESSION_NAME` > `.peon-label` > `notification_title_script` > `project_name_map` > git 仓库名 > 文件夹名。
+- **notification_title_marker**（字符串，默认：`"●"`）：通知标题和终端标签标题前显示的字符。设为 `""` 可禁用。例如：`"🔔"`。
 - **notification_title_script**（字符串，默认：`""`）：在事件触发时运行的 Shell 命令，用于动态计算项目名称。可用环境变量：`PEON_SESSION_ID`、`PEON_CWD`、`PEON_HOOK_EVENT`、`PEON_SESSION_NAME`。使用标准输出（去除首尾空白，最多 50 字符）；非零退出码则继续查找下一层级。示例：`"basename $PEON_CWD"`。
 - **project_name_map**（对象，默认：`{}`）：将目录路径映射为通知中的自定义项目标签。键为路径模式，值为显示名称。
 - **notification_templates**（对象，默认：`{}`）：自定义通知事件的消息格式。键为事件类型（`stop`、`permission`、`error`、`idle`、`question`），值为支持变量替换的模板字符串。可用变量：`{project}`、`{summary}`、`{tool_name}`、`{status}`、`{event}`。

config.json

@@ -34,6 +34,7 @@
   "notification_dismiss_seconds": 4,
   "notification_all_screens": true,
   "notification_title_override": "",
+  "notification_title_marker": "●",
   "notification_title_script": "",
   "project_name_map": {},
   "debug": false,

docs/public/llms.txt

@@ -105,7 +105,7 @@ Full list: https://openpeon.com/packs
 
 Config file: `~/.claude/hooks/peon-ping/config.json`
 
-Key settings: volume, categories (per-event toggles), default_pack (replaces active_pack), path_rules (glob-based per-repo pack assignment), pack_rotation, pack_rotation_mode, desktop_notifications, silent_window_seconds, session_start_cooldown_seconds (dedup greeting sounds when many workspaces open at once; default 30s), headphones_only (mute when no headphones detected), suppress_sound_when_tab_focused (skip sound when the generating tab is focused), notification_position (screen position for overlays), notification_dismiss_seconds (auto-dismiss timer, 0 = persistent), notification_title_override (custom project label), notification_title_script (shell command for dynamic project name; receives PEON_SESSION_ID/PEON_CWD/PEON_HOOK_EVENT/PEON_SESSION_NAME env vars), project_name_map (directory-to-label mapping), notification_templates (per-event message format strings with {project}/{summary}/{tool_name} variables), debug (enable structured hook logging), debug_retention_days (auto-prune old logs, default 7).
+Key settings: volume, categories (per-event toggles), default_pack (replaces active_pack), path_rules (glob-based per-repo pack assignment), pack_rotation, pack_rotation_mode, desktop_notifications, silent_window_seconds, session_start_cooldown_seconds (dedup greeting sounds when many workspaces open at once; default 30s), headphones_only (mute when no headphones detected), suppress_sound_when_tab_focused (skip sound when the generating tab is focused), notification_position (screen position for overlays), notification_dismiss_seconds (auto-dismiss timer, 0 = persistent), notification_title_override (custom project label), notification_title_marker (character(s) before project name in titles, set to "" to disable), notification_title_script (shell command for dynamic project name; receives PEON_SESSION_ID/PEON_CWD/PEON_HOOK_EVENT/PEON_SESSION_NAME env vars), project_name_map (directory-to-label mapping), notification_templates (per-event message format strings with {project}/{summary}/{tool_name} variables), debug (enable structured hook logging), debug_retention_days (auto-prune old logs, default 7).
 
 Pack selection hierarchy (highest to lowest priority): session_override (per-session via /peon-ping-use) > path_rules (glob match on working directory) > pack_rotation (random/round-robin from list) > default_pack (static fallback) > hardcoded "peon". Invalid or missing packs fall through to the next layer.
 

install.ps1

@@ -1861,8 +1861,8 @@ try {
     $config = Get-PeonConfigRaw $ConfigPath | ConvertFrom-Json
 } catch {
     $_configError = "$_"
-    # Fall back to minimal defaults so the hook can still run (logging requires PEON_DEBUG=1 when config is broken)
-    $config = [PSCustomObject]@{ enabled = $true; debug = $false; volume = 0.5; debug_retention_days = 7 }
+# Fall back to minimal defaults so the hook can still run (logging requires PEON_DEBUG=1 when config is broken)
+    $config = [PSCustomObject]@{ enabled = $true; debug = $false; volume = 0.5; debug_retention_days = 7; notification_title_marker = '●' }
 }
 
 # NOTE: enabled check moved below logging init so paused invocations are visible in debug logs
@@ -2686,7 +2686,7 @@ if ($null -eq $desktopNotif) { $desktopNotif = $true }
 if ($notify -and $desktopNotif) {
     $winNotifyScript = Join-Path $InstallDir "scripts\win-notify.ps1"
     if (Test-Path $winNotifyScript) {
-        $marker = [char]0x25CF  # ●
+$marker = if ($config.notification_title_marker) { $config.notification_title_marker } else { [char]0x25CF }
         $notifTitle = "$marker $project`: $notifyStatus"
         $dismissSecs = if ($config.notification_dismiss_seconds) { $config.notification_dismiss_seconds } else { 4 }
         # Resolve parent PID (the IDE/terminal that spawned Claude Code) for click-to-focus

peon.sh

@@ -1095,6 +1095,9 @@ if verbose:
         print('peon-ping: label override: ' + _lbl)
     if _pmap:
         print('peon-ping: project name map: ' + str(len(_pmap)) + ' pattern(s)')
+    _mrk = c.get('notification_title_marker', '●')
+    if _mrk != '●':
+        print('peon-ping: title marker: ' + (_mrk if _mrk else '(disabled)'))
     _tpls = c.get('notification_templates', {})
     if _tpls:
         print('peon-ping: notification templates:')
@@ -1433,10 +1436,48 @@ except Exception:
     cfg = {}
 cfg['notification_title_override'] = label
 json.dump(cfg, open(config_path, 'w'), indent=2)
-print(f'peon-ping: label override set to \"{label}\"')
+print(f'peon-ping: label override set to "{label}"')
 " "$LABEL_ARG"
         _rc=$?; [ "$_rc" -ne 0 ] && exit "$_rc"
         sync_adapter_configs; exit 0 ;;
+      marker)
+        MARKER_ARG="${3:-}"
+        if [ -z "$MARKER_ARG" ]; then
+          python3 -c "
+import json
+try:
+    cfg = json.load(open('$CONFIG_PY'))
+    m = cfg.get('notification_title_marker', '●')
+    if m == '●':
+        print('peon-ping: title marker: ● (default)')
+    elif m:
+        print(f'peon-ping: title marker: {m}')
+    else:
+        print('peon-ping: title marker: (disabled)')
+except Exception:
+    print('peon-ping: title marker: ● (default)')
+"
+          exit 0
+        fi
+        python3 -c "
+import json, sys
+config_path = '$GLOBAL_CONFIG_PY'
+marker = sys.argv[1]
+try:
+    cfg = json.load(open(config_path))
+except Exception:
+    cfg = {}
+cfg['notification_title_marker'] = marker
+json.dump(cfg, open(config_path, 'w'), indent=2)
+if marker == '●':
+    print('peon-ping: title marker reset to default ●')
+elif marker:
+    print(f'peon-ping: title marker set to \"{marker}\"')
+else:
+    print('peon-ping: title marker disabled')
+" "$MARKER_ARG"
+        _rc=$?; [ "$_rc" -ne 0 ] && exit "$_rc"
+        sync_adapter_configs; exit 0 ;;
       test)
         # Read config to check if notifications are enabled and get style
         _py_out="$(python3 -c "
@@ -2828,6 +2869,10 @@ if 'notification_all_screens' not in cfg:
     cfg['notification_all_screens'] = _theme not in ('glass', 'jarvis', 'sakura')
     changed = True
     migrations.append('notification_all_screens')
+if 'notification_title_marker' not in cfg:
+    cfg['notification_title_marker'] = '●'
+    changed = True
+    migrations.append('notification_title_marker')
 if changed:
     json.dump(cfg, open(config_path, 'w'), indent=2)
     print('peon-ping: config keys updated (' + ', '.join(migrations) + ')')
@@ -4284,6 +4329,7 @@ print('NOTIF_STYLE=' + q(cfg.get('notification_style', 'overlay')))
 print('NOTIF_POSITION=' + q(cfg.get('notification_position', 'top-center')))
 print('NOTIF_DISMISS=' + q(str(cfg.get('notification_dismiss_seconds', 4))))
 print('NOTIF_ALL_SCREENS=' + ('true' if cfg.get('notification_all_screens', True) else 'false'))
+print('NOTIF_MARKER=' + q(cfg.get('notification_title_marker', '●')))
 print('USE_SOUND_EFFECTS_DEVICE=' + q(str(use_sound_effects_device).lower()))
 print('LINUX_AUDIO_PLAYER=' + q(linux_audio_player))
 print('PEON_SSH_AUDIO_MODE=' + q(str(cfg.get('ssh_audio_mode', 'relay'))))
@@ -4363,7 +4409,7 @@ if [ "${PEON_EXIT:-true}" = "true" ]; then
   # Maintain tab title even on suppressed events (plan mode, unknown events, subagent start).
   # PROJECT is only emitted by paths that should maintain the title; agent/disabled paths omit it.
   if [ -n "${PROJECT:-}" ] && [ "${EVENT:-}" != "SessionEnd" ]; then
-    { printf '\033]0;%s\007' "${MARKER:-}${PROJECT}: ${STATUS:-working}" > /dev/tty; } 2>/dev/null || true
+    { printf '\033]0;%s\007' "${NOTIF_MARKER-${MARKER}}${PROJECT}: ${STATUS:-working}" > /dev/tty; } 2>/dev/null || true
   fi
   exit 0
 fi
@@ -4485,7 +4531,7 @@ if [ "$EVENT" = "SessionStart" ] && { [ "$PEON_PLATFORM" = "devcontainer" ] || [
 fi
 
 # --- Build tab title ---
-TITLE="${MARKER}${PROJECT}: ${STATUS}"
+TITLE="${NOTIF_MARKER-${MARKER}}${PROJECT}: ${STATUS}"
 
 # --- Resolve TTY for escape sequences ---
 # Write to /dev/tty so the escape sequence reaches the terminal directly.

tests/peon.bats

@@ -976,6 +976,55 @@ json.dump(c, open('$TEST_DIR/config.json', 'w'), indent=2)
   [ "$val" = "True" ]
 }
 
+@test "notifications marker shows default" {
+  run bash "$PEON_SH" notifications marker
+  [ "$status" -eq 0 ]
+  [[ "$output" == *"●"* ]]
+}
+
+@test "notifications marker set to empty disables it" {
+  run bash "$PEON_SH" notifications marker ""
+  [ "$status" -eq 0 ]
+  [[ "$output" == *"disabled"* ]]
+  val=$(/usr/bin/python3 -c "import json; print(json.load(open('$TEST_DIR/config.json')).get('notification_title_marker', '●'))")
+  [ "$val" = "" ]
+}
+
+@test "notifications marker set to custom" {
+  run bash "$PEON_SH" notifications marker "🔔"
+  [ "$status" -eq 0 ]
+  [[ "$output" == *"🔔"* ]]
+  val=$(/usr/bin/python3 -c "import json; print(json.load(open('$TEST_DIR/config.json')).get('notification_title_marker', '●'))")
+  [ "$val" = "🔔" ]
+}
+
+@test "notification_title_marker appears in notification title" {
+  /usr/bin/python3 -c "
+import json
+cfg = json.load(open('$TEST_DIR/config.json'))
+cfg['notification_style'] = 'standard'
+json.dump(cfg, open('$TEST_DIR/config.json', 'w'))
+"
+  run_peon '{"hook_event_name":"Stop","cwd":"/tmp/myproject","session_id":"s1","permission_mode":"default"}'
+  [ "$PEON_EXIT" -eq 0 ]
+  [ -f "$TEST_DIR/terminal_notifier.log" ]
+  grep -q "●" "$TEST_DIR/terminal_notifier.log"
+}
+
+@test "notification_title_marker empty removes marker from title" {
+  /usr/bin/python3 -c "
+import json
+cfg = json.load(open('$TEST_DIR/config.json'))
+cfg['notification_style'] = 'standard'
+cfg['notification_title_marker'] = ''
+json.dump(cfg, open('$TEST_DIR/config.json', 'w'))
+"
+  run_peon '{"hook_event_name":"Stop","cwd":"/tmp/myproject","session_id":"s1","permission_mode":"default"}'
+  [ "$PEON_EXIT" -eq 0 ]
+  [ -f "$TEST_DIR/terminal_notifier.log" ]
+  ! grep -q "●" "$TEST_DIR/terminal_notifier.log"
+}
+
 # ============================================================
 # packs list
 # ============================================================