feat(core): set process titles for CLI and web workers

pyproject.toml

@@ -35,6 +35,7 @@ dependencies = [
     "scalar-fastapi>=1.5.0",
     "websockets>=14.0",
     "keyring>=25.7.0",
+    "setproctitle>=1.3.0",
 ]
 
 [dependency-groups]

src/kimi_cli/cli/__init__.py

@@ -302,6 +302,10 @@ def kimi(
     ] = None,
 ):
     """Kimi, your next CLI agent."""
+    from kimi_cli.utils.proctitle import init_process_name
+
+    init_process_name("Kimi Code")
+
     if ctx.invoked_subcommand is not None:
         return  # skip rest if a subcommand is invoked
 
@@ -745,6 +749,10 @@ def web_worker(session_id: str) -> None:
     """Run web worker subprocess (internal)."""
     from uuid import UUID
 
+    from kimi_cli.utils.proctitle import set_process_title
+
+    set_process_title("kimi-code-worker")
+
     from kimi_cli.app import enable_logging
     from kimi_cli.web.runner.worker import run_worker
 

src/kimi_cli/utils/proctitle.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import sys
+
+
+def set_process_title(title: str) -> None:
+    """Set the OS-level process title visible in ps/top/terminal panels."""
+    try:
+        import setproctitle
+
+        setproctitle.setproctitle(title)
+    except ImportError:
+        pass
+
+
+def set_terminal_title(title: str) -> None:
+    """Set the terminal tab/window title via ANSI OSC escape sequence.
+
+    Only writes when stderr is a TTY to avoid polluting piped output.
+    """
+    if not sys.stderr.isatty():
+        return
+    try:
+        sys.stderr.write(f"\033]0;{title}\007")
+        sys.stderr.flush()
+    except OSError:
+        pass
+
+
+def init_process_name(name: str = "Kimi Code") -> None:
+    """Initialize process name: OS process title + terminal tab title."""
+    set_process_title(name)
+    set_terminal_title(name)

src/kimi_cli/utils/pyinstaller.py

@@ -2,7 +2,7 @@
 
 from PyInstaller.utils.hooks import collect_data_files, collect_submodules
 
-hiddenimports = collect_submodules("kimi_cli.tools")
+hiddenimports = collect_submodules("kimi_cli.tools") + ["setproctitle"]
 datas = (
     collect_data_files(
         "kimi_cli",

src/kimi_cli/web/runner/worker.py

@@ -63,6 +63,10 @@ async def run_worker(session_id: UUID) -> None:
 
 def main() -> None:
     """Entry point for the worker subprocess."""
+    from kimi_cli.utils.proctitle import set_process_title
+
+    set_process_title("kimi-code-worker")
+
     if len(sys.argv) < 2:
         print("Usage: python -m kimi_cli.web.runner.worker <session_id>", file=sys.stderr)
         sys.exit(1)