Getting Started
Installation
Pre-built Binaries (Recommended)
Download from GitHub Releases(opens in new tab) for your platform.
Go Install
go install github.com/wusher/tsunami/cmd/tsunami@latest
Ensure $GOPATH/bin is in your PATH:
export PATH=$PATH:$(go env GOPATH)/bin
Build from Source
git clone https://github.com/wusher/tsunami.git
cd tsunami
go build -o tsunami ./cmd/tsunami/
Verify Installation
tsunami --version
First Commands
List listening ports
tsunami -l
Output:
PORT PID PROCESS USER PROTO
-----------------------------------------------------------------
3000 12345 node youruser tcp
8080 12346 python3 youruser tcp
Kill a process on a port
tsunami 3000
You’ll be prompted for confirmation. Use -f to skip:
tsunami 3000 -f
Interactive mode
tsunami
Use arrow keys to navigate, type to filter, Enter to select.
Platform Requirements
- macOS: Uses
lsof(pre-installed) - Linux: Uses
/proc/net/tcp(kernel built-in)
Note
You may need sudo to kill processes owned by other users.
Next
See Usage for the complete CLI reference.