Metadata-Version: 2.4
Name: pss-cli
Version: 0.1.0
Summary: Cross-platform process finder with port/argument filtering
Requires-Python: >=3.12
Requires-Dist: psutil
Requires-Dist: rich
Description-Content-Type: text/markdown

# pss - 跨平台进程查找工具

快速按 **端口号 / 命令行参数 / 进程名** 模糊查找进程，彩色表格输出，支持一键 kill。

## 安装

需要 Python >= 3.12 和 [uv](https://docs.astral.sh/uv/)。

```bash
cd fast-process
uv tool install .
```

安装后全局可用 `pss` 命令。

## 使用

```bash
# 按端口查找（比如找占用 8000 端口的进程）
pss 8000

# 按命令行参数过滤（比如找包含 main.py 的进程）
pss main.py

# 按进程名过滤
pss python

# 查找后 kill（逐个确认）
pss 8000 --kill

# 查找后直接全部 kill（跳过确认）
pss 8000 --kill -y
```

## 输出示例

```
                          Matching Processes
+------------------------------------------------------------+
|   PID | Name       | Ports | Command Line                   |
|-------+------------+-------+--------------------------------|
|  1234 | python.exe | 8000  | python -m http.server 8000     |
|  5678 | node.exe   | 8000  | node server.js --port 8000     |
+------------------------------------------------------------+

Total: 2 process(es)
```

## 匹配规则

- 大小写不敏感
- 关键词同时匹配：端口号、完整命令行、进程名
- 任一匹配即展示

## 平台支持

- Windows (Git Bash / PowerShell / CMD)
- Linux
- macOS

> Windows 上获取所有进程的端口信息可能需要管理员权限，非管理员模式下仅能查看当前用户的连接。

## 开发

```bash
# 本地运行（无需全局安装）
uv run pss python

# 重新安装全局命令（修改代码后）
uv tool install . --force
```
