https://github.com/fiqryq/port
A tiny tmux plugin to view listening ports and kill processes — in a centered popup or split panes.
https://github.com/fiqryq/port
lsof nvim plugins port terminal tmux vim
Last synced: 2 months ago
JSON representation
A tiny tmux plugin to view listening ports and kill processes — in a centered popup or split panes.
- Host: GitHub
- URL: https://github.com/fiqryq/port
- Owner: fiqryq
- Created: 2025-08-31T10:10:18.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-08-31T16:50:39.000Z (3 months ago)
- Last Synced: 2025-09-05T21:57:40.557Z (2 months ago)
- Topics: lsof, nvim, plugins, port, terminal, tmux, vim
- Language: Shell
- Homepage:
- Size: 5.86 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-tmux - tmux-port
README
# tmux-port
A tiny tmux plugin to view listening ports and kill processes — in a centered popup or split panes.
https://github.com/user-attachments/assets/672e5a16-8be0-441b-ba86-ef36d5dca411
## Features
- **Prefix + G** toggles a floating popup showing `PORT • PID • COMMAND`.
- Kill a process by selecting it (fzf if available; prompt fallback).
- Works on macOS (lsof) and Linux (ss).
## Install via github
```sh
git clone git@github.com:fiqryq/port.git #close inside tmux/plugin and hit bind + I for install plugins
```
## Install (TPM)
```tmux
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'fiqryq/port'
# Optional:
set -g @port_popup_width 80
set -g @port_popup_height 20
set -g @port_popup_border on # on|off
run '~/.tmux/plugins/tpm/tpm'
```