Rename --tray-focus-only -> --indicator-focus-only

Author: neko-kai

README.md

@@ -57,7 +57,7 @@ All environments use the unified daemon (`src/daemon/`). Backends are event-driv
 
 If systemd-logind is unavailable (no system bus, permissions, etc.), the daemon keeps running but native terminal switching is disabled; a warning is logged on startup.
 
-For non-GNOME desktops, the SNI tray menu's "Show app layer only" setting is persisted via the GNOME extension's GSettings schema when available. Use `--tray-focus-only true|false` to override it at startup.
+For non-GNOME desktops, the SNI tray menu's "Show app layer only" setting is persisted via the GNOME extension's GSettings schema when available. Use `--indicator-focus-only true|false` to override it at startup.
 
 ### Config Format
 
@@ -393,21 +393,21 @@ passed on the command line. To update the entry, rerun the install command with
 ### Daemon Options
 
 ```
--p, --port PORT              Kanata TCP port (default: 10000)
--H, --host HOST              Kanata host (default: 127.0.0.1)
--c, --config PATH            Config file path
--q, --quiet                  Suppress focus/layer-switch messages
---quiet-focus                Suppress focus messages only
---install-autostart          Install autostart desktop entry and exit
---uninstall-autostart        Uninstall autostart desktop entry and exit
---install-gnome-extension    Auto-install GNOME extension if missing (default)
---no-install-gnome-extension Do not auto-install GNOME extension
---no-indicator               Disable the StatusNotifier (SNI) indicator on non-GNOME desktops
---tray-focus-only true|false Override SNI focus-only mode and skip GSettings read
---restart                    Send Restart request to an existing daemon and exit
---pause                      Send Pause request to an existing daemon and exit
---unpause                    Send Unpause request to an existing daemon and exit
--h, --help                   Show help
+-p, --port PORT                    Kanata TCP port (default: 10000)
+-H, --host HOST                    Kanata host (default: 127.0.0.1)
+-c, --config PATH                  Config file path
+-q, --quiet                        Suppress focus/layer-switch messages
+--quiet-focus                      Suppress focus messages only
+--install-autostart                Install autostart desktop entry and exit
+--uninstall-autostart              Uninstall autostart desktop entry and exit
+--install-gnome-extension          Auto-install GNOME extension if missing (default)
+--no-install-gnome-extension       Do not auto-install GNOME extension
+--no-indicator                     Disable the StatusNotifier (SNI) indicator on non-GNOME desktops
+--indicator-focus-only true|false  Override StatusNotifier (SNI) indicator focus-only mode
+--restart                          Send Restart request to an existing daemon and exit
+--pause                            Send Pause request to an existing daemon and exit
+--unpause                          Send Unpause request to an existing daemon and exit
+-h, --help                         Show help
 ```
 
 Systemd units use `--quiet-focus` by default to reduce log noise.

llm-docs/implementation-notes.md

@@ -163,7 +163,7 @@ SNI indicator (non-GNOME):
 - Optional StatusNotifier item for KDE/wlroots/COSMIC/X11; menu includes Pause/Restart and “Show app layer only”
 - Uses the same layer + virtual key formatting as GNOME; pause toggles through local handlers on non-DBus backends
 - Tooltip: shows current layer; if any VKs are held, also lists the VK names (comma-separated)
-- Persists "Show app layer only" via GSettings key `show-focus-layer-only` in schema `org.gnome.shell.extensions.kanata-switcher` when available; `--tray-focus-only true|false` skips the GSettings read
+- Persists "Show app layer only" via GSettings key `show-focus-layer-only` in schema `org.gnome.shell.extensions.kanata-switcher` when available; `--indicator-focus-only true|false` skips the GSettings read
 
 ## Virtual Key Support
 

qa/sni-indicator-checklist.md

@@ -21,7 +21,7 @@ Environment: (DE/compositor, panel/bar, session type)
 
 ## Persistence
 - [ ] "Show app layer only" persists across daemon restarts when GSettings is available
-- [ ] `--tray-focus-only true|false` overrides startup value without locking the toggle
+- [ ] `--indicator-focus-only true|false` overrides startup value without locking the toggle
 
 ## Failure behavior
 - [ ] If SNI cannot be started, daemon keeps running and logs error

src/daemon/main.rs

@@ -369,7 +369,7 @@ fn autostart_passthrough_args(matches: &ArgMatches, args: &Args) -> Vec<String>
                 let value = args
                     .tray_focus_only
                     .expect("tray_focus_only missing after command-line input");
-                exec_args.push("--tray-focus-only".to_string());
+                exec_args.push("--indicator-focus-only".to_string());
                 exec_args.push(value.as_arg().to_string());
             }
             _ => {

src/daemon/tests.rs

@@ -285,14 +285,14 @@ fn test_autostart_passthrough_args_tray_focus_only() {
     let matches = Args::command().get_matches_from([
         "kanata-switcher",
         "--install-autostart",
-        "--tray-focus-only",
+        "--indicator-focus-only",
         "false",
     ]);
     let args = Args::from_arg_matches(&matches).unwrap();
     let exec_args = autostart_passthrough_args(&matches, &args);
     assert_eq!(
         exec_args,
-        vec!["--tray-focus-only".to_string(), "false".to_string()]
+        vec!["--indicator-focus-only".to_string(), "false".to_string()]
     );
 }