procclean 1.3.0__tar.gz → 2.0.0__tar.gz

procclean-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kaj Kowalski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{procclean-1.3.0 → procclean-2.0.0}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: procclean
-Version: 1.3.0
+Version: 2.0.0
 Summary: Interactive TUI for exploring and cleaning up processes - find orphans, memory hogs, and kill them
 Keywords: cleanup,kill,memory,orphan,process,terminal,tui
 Author: Kaj Kowalski
 Author-email: Kaj Kowalski <info@kajkowalski.nl>
 License-Expression: MIT
-Classifier: Development Status :: 4 - Beta
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
@@ -22,6 +23,7 @@ Requires-Dist: tabulate>=0.9.0
 Requires-Dist: textual>=7.0.0
 Requires-Python: >=3.14
 Project-URL: Homepage, https://procclean.kjanat.com
+Project-URL: Issues, https://github.com/kjanat/procclean/issues
 Project-URL: Repository, https://github.com/kjanat/procclean
 Description-Content-Type: text/markdown
 
@@ -35,6 +37,8 @@ Description-Content-Type: text/markdown
 
 <p align="center">
   <a href="https://pypi.org/project/procclean/"><img src="https://img.shields.io/pypi/v/procclean" alt="PyPI"></a>
+  <a href="https://pypi.org/project/procclean/"><img src="https://img.shields.io/pypi/dm/procclean" alt="Downloads"></a>
+  <a href="https://github.com/kjanat/procclean/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/kjanat/procclean/ci.yml?branch=master" alt="CI"></a>
   <a href="https://github.com/kjanat/procclean/blob/master/LICENSE"><img src="https://img.shields.io/github/license/kjanat/procclean" alt="License"></a>
   <a href="https://procclean.kjanat.com"><img src="https://img.shields.io/badge/docs-mkdocs-blue" alt="Docs"></a>
   <img src="https://img.shields.io/badge/python-3.14%2B-blue" alt="Python 3.14+">
@@ -44,13 +48,18 @@ Description-Content-Type: text/markdown
 ## Features
 
 - **Memory overview** - Real-time total/used/free/swap display
-- **Multiple views** - All processes, Orphaned, Process Groups, High Memory
-  (>500MB)
+- **Multiple views** - All, Orphaned, Killable, Process Groups, High Memory
 - **Orphan detection** - Finds processes whose parent died (PPID=1)
+- **Killable detection** - Orphans safe to kill (not tmux, not system services)
+- **Stale detection** - Flags processes with deleted executables
 - **Tmux awareness** - Won't flag tmux processes as orphan candidates
 - **Batch operations** - Select multiple processes and kill them at once
 - **Process grouping** - Find duplicate/similar processes consuming resources
+- **Custom columns** - Select which columns to display in CLI output
+- **Configurable thresholds** - Adjust memory filters via CLI flags
+- **Preview mode** - Dry-run for kill operations with formatting options
 - **CLI mode** - Scriptable commands with JSON/CSV/Markdown output
+- **Clickable TUI** - Click headers to sort, rows to select
 
 ## Installation
 
@@ -58,16 +67,24 @@ Description-Content-Type: text/markdown
 pip install procclean
 ```
 
-Or with [uv](https://docs.astral.sh/uv/):
+Or with [uv](https://docs.astral.sh/uv/) (recommended):
 
 ```bash
 uv tool install procclean
 ```
 
+Or with [pipx](https://pipx.pypa.io/):
+
+```bash
+pipx install procclean
+```
+
 Run without installing:
 
 ```bash
 uvx procclean
+# or
+pipx run procclean
 ```
 
 ## Usage
@@ -81,24 +98,40 @@ procclean
 ### CLI Commands
 
 ```bash
+# List processes
 procclean list                      # List processes (table)
+procclean ls                        # Alias for 'list'
 procclean list -f json|csv|md       # Different output formats
 procclean list -s mem|cpu|pid|name|cwd  # Sort by field
+procclean list -a                   # Sort ascending (default: descending)
 procclean list -o                   # Orphans only
-procclean list -m                   # High memory only
+procclean list -m                   # High memory only (>500MB)
 procclean list -k                   # Killable orphans only
 procclean list --cwd                # Filter by current directory
 procclean list --cwd /path/to/dir   # Filter by specific cwd
+procclean list -n 20                # Limit output to 20 processes
+procclean list -c pid,name,rss_mb   # Custom columns
+procclean list --min-memory 10      # Only processes using >10 MB
+procclean list --high-memory-threshold 1000  # High-mem at 1000 MB
 
+# Process groups
 procclean groups                    # Show process groups
+procclean g                         # Alias for 'groups'
+procclean groups -f json            # Groups as JSON
 
+# Kill processes
 procclean kill <PID> [PID...]       # Kill process(es)
 procclean kill -f <PID>             # Force kill (SIGKILL)
 procclean kill --cwd /path -y       # Kill all in cwd (skip confirm)
 procclean kill -k -y                # Kill all killable orphans
 procclean kill -k --preview         # Preview what would be killed
+procclean kill -k --dry-run         # Alias for --preview
+procclean kill -k --preview -O json # Preview in JSON format
 
+# Memory summary
 procclean mem                       # Show memory summary
+procclean memory                    # Full name for 'mem'
+procclean mem -f json               # Memory info as JSON
 ```
 
 ## TUI Keybindings
@@ -110,6 +143,7 @@ procclean mem                       # Show memory summary
 | `k`     | Kill selected (SIGTERM) |
 | `K`     | Force kill (SIGKILL)    |
 | `o`     | Show orphans            |
+| `O`     | Show killable           |
 | `a`     | Show all                |
 | `g`     | Show groups             |
 | `w`     | Filter by selected cwd  |
@@ -124,12 +158,15 @@ procclean mem                       # Show memory summary
 | `5`     | Sort by cwd             |
 | `!`     | Reverse sort order      |
 
+Click column headers to sort, click rows to toggle selection.
+
 ## Views
 
 - **All Processes** - All user processes sorted by memory usage
 - **Orphaned** - Processes with PPID=1 (parent died)
+- **Killable** - Orphans safe to kill (not in tmux, not system services)
 - **Process Groups** - Similar processes grouped together
-- **High Memory** - Processes using >500MB RAM
+- **High Memory** - Processes using >500MB RAM (configurable)
 
 ## Output Formats
 
@@ -140,6 +177,17 @@ CLI supports multiple output formats via `-f`:
 - `csv` - CSV for spreadsheets
 - `md` - Markdown table
 
+## Custom Columns
+
+Use `-c` to specify which columns to display:
+
+```bash
+procclean list -c pid,name,rss_mb,cwd
+```
+
+Available columns: `pid`, `name`, `rss_mb`, `cpu_percent`, `cwd`, `ppid`,
+`parent_name`, `status`, `cmdline`, `username`
+
 ## Requirements
 
 - Python 3.14+
@@ -151,13 +199,21 @@ CLI supports multiple output formats via `-f`:
 git clone https://github.com/kjanat/procclean
 cd procclean
 uv sync
-uv run pre-commit install
+uv run pre-commit install --install-hooks
 ```
 
 Run tests:
 
 ```bash
-uv run pytest
+uv run pytest                    # All tests
+uv run pytest --cov -vv          # With coverage
+```
+
+Lint and type check:
+
+```bash
+uv run ruff check src/
+uv run ty check
 ```
 
 ## License

{procclean-1.3.0 → procclean-2.0.0}/README.md

@@ -8,6 +8,8 @@
 
 <p align="center">
   <a href="https://pypi.org/project/procclean/"><img src="https://img.shields.io/pypi/v/procclean" alt="PyPI"></a>
+  <a href="https://pypi.org/project/procclean/"><img src="https://img.shields.io/pypi/dm/procclean" alt="Downloads"></a>
+  <a href="https://github.com/kjanat/procclean/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/kjanat/procclean/ci.yml?branch=master" alt="CI"></a>
   <a href="https://github.com/kjanat/procclean/blob/master/LICENSE"><img src="https://img.shields.io/github/license/kjanat/procclean" alt="License"></a>
   <a href="https://procclean.kjanat.com"><img src="https://img.shields.io/badge/docs-mkdocs-blue" alt="Docs"></a>
   <img src="https://img.shields.io/badge/python-3.14%2B-blue" alt="Python 3.14+">
@@ -17,13 +19,18 @@
 ## Features
 
 - **Memory overview** - Real-time total/used/free/swap display
-- **Multiple views** - All processes, Orphaned, Process Groups, High Memory
-  (>500MB)
+- **Multiple views** - All, Orphaned, Killable, Process Groups, High Memory
 - **Orphan detection** - Finds processes whose parent died (PPID=1)
+- **Killable detection** - Orphans safe to kill (not tmux, not system services)
+- **Stale detection** - Flags processes with deleted executables
 - **Tmux awareness** - Won't flag tmux processes as orphan candidates
 - **Batch operations** - Select multiple processes and kill them at once
 - **Process grouping** - Find duplicate/similar processes consuming resources
+- **Custom columns** - Select which columns to display in CLI output
+- **Configurable thresholds** - Adjust memory filters via CLI flags
+- **Preview mode** - Dry-run for kill operations with formatting options
 - **CLI mode** - Scriptable commands with JSON/CSV/Markdown output
+- **Clickable TUI** - Click headers to sort, rows to select
 
 ## Installation
 
@@ -31,16 +38,24 @@
 pip install procclean
 ```
 
-Or with [uv](https://docs.astral.sh/uv/):
+Or with [uv](https://docs.astral.sh/uv/) (recommended):
 
 ```bash
 uv tool install procclean
 ```
 
+Or with [pipx](https://pipx.pypa.io/):
+
+```bash
+pipx install procclean
+```
+
 Run without installing:
 
 ```bash
 uvx procclean
+# or
+pipx run procclean
 ```
 
 ## Usage
@@ -54,24 +69,40 @@ procclean
 ### CLI Commands
 
 ```bash
+# List processes
 procclean list                      # List processes (table)
+procclean ls                        # Alias for 'list'
 procclean list -f json|csv|md       # Different output formats
 procclean list -s mem|cpu|pid|name|cwd  # Sort by field
+procclean list -a                   # Sort ascending (default: descending)
 procclean list -o                   # Orphans only
-procclean list -m                   # High memory only
+procclean list -m                   # High memory only (>500MB)
 procclean list -k                   # Killable orphans only
 procclean list --cwd                # Filter by current directory
 procclean list --cwd /path/to/dir   # Filter by specific cwd
+procclean list -n 20                # Limit output to 20 processes
+procclean list -c pid,name,rss_mb   # Custom columns
+procclean list --min-memory 10      # Only processes using >10 MB
+procclean list --high-memory-threshold 1000  # High-mem at 1000 MB
 
+# Process groups
 procclean groups                    # Show process groups
+procclean g                         # Alias for 'groups'
+procclean groups -f json            # Groups as JSON
 
+# Kill processes
 procclean kill <PID> [PID...]       # Kill process(es)
 procclean kill -f <PID>             # Force kill (SIGKILL)
 procclean kill --cwd /path -y       # Kill all in cwd (skip confirm)
 procclean kill -k -y                # Kill all killable orphans
 procclean kill -k --preview         # Preview what would be killed
+procclean kill -k --dry-run         # Alias for --preview
+procclean kill -k --preview -O json # Preview in JSON format
 
+# Memory summary
 procclean mem                       # Show memory summary
+procclean memory                    # Full name for 'mem'
+procclean mem -f json               # Memory info as JSON
 ```
 
 ## TUI Keybindings
@@ -83,6 +114,7 @@ procclean mem                       # Show memory summary
 | `k`     | Kill selected (SIGTERM) |
 | `K`     | Force kill (SIGKILL)    |
 | `o`     | Show orphans            |
+| `O`     | Show killable           |
 | `a`     | Show all                |
 | `g`     | Show groups             |
 | `w`     | Filter by selected cwd  |
@@ -97,12 +129,15 @@ procclean mem                       # Show memory summary
 | `5`     | Sort by cwd             |
 | `!`     | Reverse sort order      |
 
+Click column headers to sort, click rows to toggle selection.
+
 ## Views
 
 - **All Processes** - All user processes sorted by memory usage
 - **Orphaned** - Processes with PPID=1 (parent died)
+- **Killable** - Orphans safe to kill (not in tmux, not system services)
 - **Process Groups** - Similar processes grouped together
-- **High Memory** - Processes using >500MB RAM
+- **High Memory** - Processes using >500MB RAM (configurable)
 
 ## Output Formats
 
@@ -113,6 +148,17 @@ CLI supports multiple output formats via `-f`:
 - `csv` - CSV for spreadsheets
 - `md` - Markdown table
 
+## Custom Columns
+
+Use `-c` to specify which columns to display:
+
+```bash
+procclean list -c pid,name,rss_mb,cwd
+```
+
+Available columns: `pid`, `name`, `rss_mb`, `cpu_percent`, `cwd`, `ppid`,
+`parent_name`, `status`, `cmdline`, `username`
+
 ## Requirements
 
 - Python 3.14+
@@ -124,13 +170,21 @@ CLI supports multiple output formats via `-f`:
 git clone https://github.com/kjanat/procclean
 cd procclean
 uv sync
-uv run pre-commit install
+uv run pre-commit install --install-hooks
 ```
 
 Run tests:
 
 ```bash
-uv run pytest
+uv run pytest                    # All tests
+uv run pytest --cov -vv          # With coverage
+```
+
+Lint and type check:
+
+```bash
+uv run ruff check src/
+uv run ty check
 ```
 
 ## License

{procclean-1.3.0 → procclean-2.0.0}/pyproject.toml

@@ -3,15 +3,16 @@
 
 [project]
 name = "procclean"
-version = "1.3.0"
+version = "2.0.0"
 description = "Interactive TUI for exploring and cleaning up processes - find orphans, memory hogs, and kill them"
 readme = "README.md"
 requires-python = ">=3.14"
 license = "MIT"
+license-files = ["LICENSE"]
 authors = [{ name = "Kaj Kowalski", email = "info@kajkowalski.nl" }]
 keywords = ["cleanup", "kill", "memory", "orphan", "process", "terminal", "tui"]
 classifiers = [
-  "Development Status :: 4 - Beta",
+  "Development Status :: 5 - Production/Stable",
   "Environment :: Console",
   "Intended Audience :: Developers",
   "Intended Audience :: System Administrators",
@@ -31,6 +32,7 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://procclean.kjanat.com"
+Issues = "https://github.com/kjanat/procclean/issues"
 Repository = "https://github.com/kjanat/procclean"
 
 [project.scripts]

{procclean-1.3.0 → procclean-2.0.0}/src/procclean/cli/docs.py

@@ -4,9 +4,9 @@ from __future__ import annotations
 
 import argparse
 import io
-import os
 import re
 from collections import defaultdict
+from functools import partial
 from pathlib import Path
 
 from markdown_it import MarkdownIt
@@ -52,23 +52,31 @@ def _capture_help(parser: argparse.ArgumentParser) -> str:
     Returns:
         HTML string with colored help output.
     """
-    # Force colored output even when not in a TTY
-    old_force_color = os.environ.get("FORCE_COLOR")
-    os.environ["FORCE_COLOR"] = "1"
+    # Create a truecolor console for both formatting and export
+    # - color_system="truecolor" ensures hex colors like #98f641 aren't downgraded
+    # - width=80 ensures consistent text wrapping across environments
+    truecolor_console = Console(
+        file=io.StringIO(),
+        record=True,
+        force_terminal=True,
+        color_system="truecolor",
+        width=80,
+    )
+
+    # Save original formatter_class and restore after use
+    orig_formatter_class = parser.formatter_class
     try:
-        parser.formatter_class = RichHelpFormatter
-        text = Text.from_ansi(parser.format_help())
+        # Pass the truecolor console to RichHelpFormatter via partial
+        parser.formatter_class = partial(RichHelpFormatter, console=truecolor_console)
+        help_text = parser.format_help()
     finally:
-        if old_force_color is None:
-            os.environ.pop("FORCE_COLOR", None)
-        else:
-            os.environ["FORCE_COLOR"] = old_force_color
+        parser.formatter_class = orig_formatter_class
 
-    # force_terminal=True ensures colored output even when not in a TTY
-    console = Console(file=io.StringIO(), record=True, force_terminal=True)
-    console.print(text, crop=False)
+    # Parse ANSI back to Rich Text and re-render for HTML export
+    text = Text.from_ansi(help_text)
+    truecolor_console.print(text, crop=False)
 
-    return console.export_html(code_format=_CODE_FORMAT, inline_styles=True)
+    return truecolor_console.export_html(code_format=_CODE_FORMAT, inline_styles=True)
 
 
 def _argparser_to_markdown(

{procclean-1.3.0 → procclean-2.0.0}/src/procclean/tui/app.py

@@ -6,6 +6,7 @@ from textual import on, work
 from textual.app import App, ComposeResult
 from textual.binding import Binding
 from textual.containers import Horizontal, Vertical
+from textual.coordinate import Coordinate
 from textual.reactive import reactive
 from textual.widgets import (
     DataTable,
@@ -15,6 +16,7 @@ from textual.widgets import (
     OptionList,
     Static,
 )
+from textual.widgets.data_table import RowDoesNotExist
 from textual.widgets.option_list import Option
 
 from procclean.core import (
@@ -32,7 +34,7 @@ from procclean.core import (
 from .screens import ConfirmKillScreen
 
 # Type aliases
-ViewType = Literal["all", "orphans", "stale", "groups", "high-mem"]
+ViewType = Literal["all", "orphans", "killable", "groups", "high-mem"]
 SortKey = Literal["memory", "cpu", "pid", "name", "cwd"]
 
 
@@ -53,7 +55,7 @@ class ProcessCleanerApp(App):
         Binding("k", "kill_selected", "Kill"),
         Binding("K", "force_kill_selected", "Force Kill"),
         Binding("o", "show_orphans", "Orphans"),
-        Binding("t", "show_stale", "Stale"),
+        Binding("O", "show_killable", "Killable"),
         Binding("a", "show_all", "All"),
         Binding("g", "show_groups", "Groups"),
         Binding("w", "filter_cwd", "Filter CWD"),
@@ -94,7 +96,7 @@ class ProcessCleanerApp(App):
                 yield OptionList(
                     Option("All Processes", id="view-all"),
                     Option("Orphaned", id="view-orphans"),
-                    Option("Stale (Updated)", id="view-stale"),
+                    Option("Killable", id="view-killable"),
                     Option("Process Groups", id="view-groups"),
                     Option("High Memory (>500MB)", id="view-high-mem"),
                     id="view-selector",
@@ -179,30 +181,50 @@ class ProcessCleanerApp(App):
         key_func = sort_keys.get(self.sort_key, sort_keys["memory"])
         return sorted(procs, key=key_func, reverse=self.sort_reverse)
 
+    def _filter_by_view(self) -> list[ProcessInfo]:
+        """Filter processes based on current view.
+
+        Returns:
+            Filtered list of processes for the current view.
+        """
+        if self.current_view == "orphans":
+            return [p for p in self.processes if p.is_orphan]
+        if self.current_view == "killable":
+            return [p for p in self.processes if p.is_orphan_candidate]
+        if self.current_view == "high-mem":
+            return [p for p in self.processes if p.rss_mb > HIGH_MEMORY_THRESHOLD_MB]
+        if self.current_view == "groups":
+            groups = find_similar_processes(self.processes)
+            return [p for group in groups.values() for p in group]
+        return list(self.processes)
+
+    @staticmethod
+    def _restore_cursor(table: DataTable, cursor_pid: int | None) -> None:
+        """Restore cursor to the row with the given PID.
+
+        Args:
+            table: The DataTable to restore cursor in.
+            cursor_pid: The PID to restore cursor to, or None to skip.
+        """
+        if cursor_pid is None:
+            return
+        try:
+            row_idx = table.get_row_index(str(cursor_pid))
+        except RowDoesNotExist:
+            if table.row_count:
+                table.move_cursor(row=0)
+            return
+        table.move_cursor(row=row_idx)
+
     def update_table(self) -> None:
         """Update the process table based on current view and sort."""
         table = self.query_one("#process-table", DataTable)
+        cursor_pid = self._get_pid_at_cursor()
         table.clear()
 
-        if self.current_view == "orphans":
-            procs = [p for p in self.processes if p.is_orphan]
-        elif self.current_view == "stale":
-            procs = [p for p in self.processes if p.exe_deleted]
-        elif self.current_view == "high-mem":
-            procs = [p for p in self.processes if p.rss_mb > HIGH_MEMORY_THRESHOLD_MB]
-        elif self.current_view == "groups":
-            groups = find_similar_processes(self.processes)
-            procs = []
-            for group_procs in groups.values():
-                procs.extend(group_procs)
-        else:
-            procs = self.processes
-
-        # Apply cwd filter
+        procs = self._filter_by_view()
         if self.cwd_filter:
             procs = filter_by_cwd(procs, self.cwd_filter)
-
-        # Apply sorting
         procs = self._sort_processes(procs)
 
         for proc in procs:
@@ -229,6 +251,7 @@ class ProcessCleanerApp(App):
                 key=str(proc.pid),
             )
 
+        self._restore_cursor(table, cursor_pid)
         self.update_status()
 
     def update_status(self) -> None:
@@ -245,13 +268,55 @@ class ProcessCleanerApp(App):
         view_map: dict[str, ViewType] = {
             "view-all": "all",
             "view-orphans": "orphans",
-            "view-stale": "stale",
+            "view-killable": "killable",
             "view-groups": "groups",
             "view-high-mem": "high-mem",
         }
         if event.option.id and event.option.id in view_map:
             self.current_view = view_map[event.option.id]
 
+    @on(DataTable.RowSelected, "#process-table")
+    def on_row_clicked(self, event: DataTable.RowSelected) -> None:
+        """Toggle selection when a row is clicked."""
+        # Get PID from the row data (column 1 is PID)
+        # Guard against race: auto-refresh can remove rows mid-flight
+        try:
+            row_data = event.data_table.get_row(event.row_key)
+            pid = int(row_data[1])
+        except RowDoesNotExist:
+            return
+
+        # Toggle selection
+        if pid in self.selected_pids:
+            self.selected_pids.remove(pid)
+            new_value = "[ ]"
+        else:
+            self.selected_pids.add(pid)
+            new_value = "[X]"
+
+        # Update the clicked row's selection cell using row_key (not cursor_row)
+        selection_column_key = event.data_table.ordered_columns[0].key
+        event.data_table.update_cell(event.row_key, selection_column_key, new_value)
+        self.update_status()
+
+    @on(DataTable.HeaderSelected, "#process-table")
+    def on_header_clicked(self, event: DataTable.HeaderSelected) -> None:
+        """Sort by column when header is clicked."""
+        # Map column index to sort key.
+        # Sortable: PID(1), Name(2), RAM(3), CPU(4), CWD(5)
+        # Not sortable (no-op): Selection(0), PPID(6), Parent(7), Status(8)
+        # NOTE: Indexes must be updated if column order changes in update_table()
+        column_sort_map: dict[int, SortKey] = {
+            1: "pid",
+            2: "name",
+            3: "memory",
+            4: "cpu",
+            5: "cwd",
+        }
+        col_idx = event.column_index
+        if col_idx in column_sort_map:
+            self._set_sort(column_sort_map[col_idx])
+
     def action_refresh(self) -> None:
         """Refresh process data."""
         self.refresh_data()
@@ -262,14 +327,14 @@ class ProcessCleanerApp(App):
 
         Returns:
             The PID at the current cursor position, or ``None`` if there is no
-            current row selected.
+            current row selected or the table is empty.
         """
         table = self.query_one("#process-table", DataTable)
-        if table.cursor_row is None:
+        if table.cursor_row is None or table.row_count == 0:
             return None
-        row_key = table.get_row_at(table.cursor_row)
-        # row_key is a tuple of cell values: (selected, pid, name, ...)
-        return int(row_key[1])
+        row_data = table.get_row_at(table.cursor_row)
+        # row_data is a list of cell values: [selected, pid, name, ...]
+        return int(row_data[1])
 
     def _get_process_at_cursor(self) -> ProcessInfo | None:
         """Get the ProcessInfo at the current cursor position.
@@ -286,13 +351,23 @@ class ProcessCleanerApp(App):
 
     def action_toggle_select(self) -> None:
         """Toggle selection of current row."""
+        table = self.query_one("#process-table", DataTable)
+        if table.cursor_row is None:
+            return
+
         pid = self._get_pid_at_cursor()
         if pid is not None:
+            # Toggle selection
             if pid in self.selected_pids:
                 self.selected_pids.remove(pid)
+                new_value = "[ ]"
             else:
                 self.selected_pids.add(pid)
-            self.update_table()
+                new_value = "[X]"
+
+            # Update just the selection cell, not the entire table
+            table.update_cell_at(Coordinate(table.cursor_row, 0), new_value)
+            self.update_status()
 
     def action_select_all_visible(self) -> None:
         """Select all visible processes."""
@@ -312,9 +387,9 @@ class ProcessCleanerApp(App):
         """Switch to orphans view."""
         self.current_view = "orphans"
 
-    def action_show_stale(self) -> None:
-        """Switch to stale processes view (deleted/updated executables)."""
-        self.current_view = "stale"
+    def action_show_killable(self) -> None:
+        """Switch to killable orphans view (orphans not in tmux)."""
+        self.current_view = "killable"
 
     def action_show_all(self) -> None:
         """Switch to all processes view."""