✨ feat(cli): set process title on startup

Author: Jannchie

pyproject.toml

@@ -12,6 +12,7 @@ dependencies = [
     "questionary>=2.0.1",
     "beautifulsoup4>=4.13.3",
     "click>=8.0.0",
+    "setproctitle>=1.3.7",
 ]
 readme = { content-type = "text/markdown", file = "README.md" }
 requires-python = ">= 3.11"

tests/unit/test_cli.py

@@ -4,7 +4,7 @@
 import threading
 from click.testing import CliRunner
 
-from tgit.cli import app, set_terminal_title, version_callback
+from tgit.cli import app, set_process_title, set_terminal_title, version_callback
 
 
 class TestCLI:
@@ -53,15 +53,17 @@ def test_version_callback_false(self, mock_print, mock_version):
         mock_ctx.exit.assert_not_called()
 
     @patch("tgit.cli.threading.Thread")
+    @patch("tgit.cli.set_process_title")
     @patch("tgit.cli.set_terminal_title")
-    def test_app_starts_openai_import_thread(self, mock_set_terminal_title, mock_thread):
+    def test_app_starts_openai_import_thread(self, mock_set_terminal_title, mock_set_process_title, mock_thread):
         """Test that app starts a thread for OpenAI import"""
         mock_thread_instance = MagicMock()
         mock_thread.return_value = mock_thread_instance
 
         # Directly call the app function to test the callback
         app.callback()
 
+        mock_set_process_title.assert_called_once_with("tgit")
         mock_set_terminal_title.assert_called_once_with("tgit")
         # The app should run the callback and start the thread
         mock_thread.assert_called_once()
@@ -88,6 +90,20 @@ def test_app_callback_registration(self):
         assert isinstance(app, click.Group)
         # Verify the app exists and is configured correctly
 
+    @patch("tgit.cli.setproctitle_module.setproctitle")
+    def test_set_process_title_updates_process_name(self, mock_setproctitle):
+        """Test process title is updated when support is available."""
+        set_process_title("tgit")
+
+        mock_setproctitle.assert_called_once_with("tgit")
+
+    @patch("tgit.cli.setproctitle_module.setproctitle", side_effect=RuntimeError("boom"))
+    def test_set_process_title_ignores_errors(self, mock_setproctitle):
+        """Test process title errors do not break CLI startup."""
+        set_process_title("tgit")
+
+        mock_setproctitle.assert_called_once_with("tgit")
+
     @patch("tgit.cli.sys.stdout.flush")
     @patch("tgit.cli.sys.stdout.write")
     @patch("tgit.cli.sys.stdout.isatty", return_value=True)

tgit/cli.py

@@ -4,6 +4,7 @@
 import threading
 
 import click
+import setproctitle as setproctitle_module
 
 from tgit.add import add
 from tgit.changelog import changelog
@@ -13,6 +14,11 @@
 from tgit.version import version
 
 
+def set_process_title(title: str) -> None:
+    with contextlib.suppress(Exception):
+        setproctitle_module.setproctitle(title)
+
+
 def set_terminal_title(title: str) -> None:
     if not sys.stdout.isatty():
         return
@@ -42,6 +48,7 @@ def version_callback(ctx: click.Context, _param: click.Parameter, value: bool) -
     help="Show version",
 )
 def app() -> None:
+    set_process_title("tgit")
     set_terminal_title("tgit")
 
     def import_openai() -> None: