<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Yingtse</title>
    <description>The latest articles on DEV Community by Yingtse (@yingtse).</description>
    <link>https://dev.to/yingtse</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4253854%2F8abfbbc9-311f-4495-a874-6773e260827a.png</url>
      <title>DEV Community: Yingtse</title>
      <link>https://dev.to/yingtse</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/yingtse"/>
    <language>en</language>
    <item>
      <title>Find and kill the process holding a port</title>
      <dc:creator>Yingtse</dc:creator>
      <pubDate>Fri, 20 Nov 2026 03:06:54 +0000</pubDate>
      <link>https://dev.to/yingtse/find-and-kill-the-process-holding-a-port-7e9</link>
      <guid>https://dev.to/yingtse/find-and-kill-the-process-holding-a-port-7e9</guid>
      <description>&lt;p&gt;Port 3000 is taken, and you want to kill whatever is holding it.&lt;/p&gt;

&lt;p&gt;How do you do it?&lt;/p&gt;

&lt;p&gt;You ask an AI for a script, paste it into your terminal, and run it.&lt;/p&gt;

&lt;p&gt;A week later, port 3000 is taken again. Asking the AI again feels slow, so this time you save the script somewhere: a Markdown note, or a &lt;code&gt;kill-port.sh&lt;/code&gt; file.&lt;/p&gt;

&lt;p&gt;Then it's port 8080. First you have to find where you saved it. Then you edit the port and run it.&lt;br&gt;
Or you finally make the port an argument, or add a &lt;code&gt;read -p "Port: "&lt;/code&gt;, so you don't have to edit it next time.&lt;/p&gt;

&lt;p&gt;That's a lot of work for one small job, and you'll still have to find the file again.&lt;/p&gt;

&lt;p&gt;With &lt;a href="https://printf.app/cmdbook" rel="noopener noreferrer"&gt;cmdbook&lt;/a&gt;, the script has one place to live, and it gets a GUI for free.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fn5o10k4jxmkvibshcoxk.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fn5o10k4jxmkvibshcoxk.png" alt="a form with a Port field" width="800" height="489"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  Here's how
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;1. Save the script once.&lt;/strong&gt; Create a command in cmdbook and paste the script.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;2. Mark what changes.&lt;/strong&gt; Replace the port with a placeholder:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;PORT&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="o"&gt;{&lt;/span&gt;&lt;span class="o"&gt;{&lt;/span&gt;prompt:port?3000&lt;span class="o"&gt;}&lt;/span&gt;&lt;span class="o"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;?3000&lt;/code&gt; is the default.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3. Click Run.&lt;/strong&gt; cmdbook shows a form with a Port field, already filled in with 3000. Type another port, or just press Enter.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;4. Decide in the output.&lt;/strong&gt; The script shows what holds the port, then asks before killing it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;PID 37920  user apple, running 00:01
  command: python3 -m http.server 3000
  folder:  /Users/apple/code/my-app
  parent:  37918 npm run dev

Stop 37920 with 'kill'? [y/N] y
Port 3000 is free.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You type &lt;code&gt;y&lt;/code&gt; right in the output panel, as you would in a terminal.&lt;/p&gt;

&lt;p&gt;Next time, your last port is already filled in. No searching, no editing, no asking again.&lt;/p&gt;

&lt;p&gt;That's all a script needs to get a GUI: mark the parts that change. The rest is the script you already have.&lt;/p&gt;

&lt;p&gt;Try cmdbook here: &lt;a href="https://printf.app/cmdbook" rel="noopener noreferrer"&gt;printf.app/cmdbook&lt;/a&gt;&lt;/p&gt;

The full script (macOS)&lt;br&gt;


&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;PORT&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="o"&gt;{&lt;/span&gt;&lt;span class="o"&gt;{&lt;/span&gt;prompt:port?3000&lt;span class="o"&gt;}&lt;/span&gt;&lt;span class="o"&gt;}&lt;/span&gt;

&lt;span class="c"&gt;# Who listens on the port. lsof only sees your own processes;&lt;/span&gt;
&lt;span class="c"&gt;# netstat -anv (macOS) also shows other users' listeners, with the PID.&lt;/span&gt;
&lt;span class="nv"&gt;PIDS&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;lsof -nP -tiTCP:&lt;span class="s2"&gt;"$PORT"&lt;/span&gt; -sTCP:LISTEN &lt;span class="o"&gt;|&lt;/span&gt; sort -u&lt;span class="o"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="o"&gt;[&lt;/span&gt; -z &lt;span class="s2"&gt;"$PIDS"&lt;/span&gt; &lt;span class="o"&gt;]&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;then&lt;/span&gt;
  &lt;span class="nv"&gt;PIDS&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;netstat -anv -p tcp 2&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;/dev/null &lt;span class="o"&gt;|&lt;/span&gt; awk -v &lt;span class="nv"&gt;p&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"$PORT"&lt;/span&gt; &lt;span class="s1"&gt;'
    $6 == "LISTEN" &amp;amp;&amp;amp; $4 ~ "[.:]" p "$" {
      for (i = 7; i &amp;lt;= NF; i++) if ($i ~ /^[^:]+:[0-9]+$/) { split($i, a, ":"); print a[2] }
    }'&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; sort -u&lt;span class="o"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;fi&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="o"&gt;[&lt;/span&gt; -z &lt;span class="s2"&gt;"$PIDS"&lt;/span&gt; &lt;span class="o"&gt;]&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;then&lt;/span&gt;
  &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"Nothing is listening on port $PORT."&lt;/span&gt;
  &lt;span class="nb"&gt;exit&lt;/span&gt; 1
&lt;span class="k"&gt;fi&lt;/span&gt;

&lt;span class="nv"&gt;KILL&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"kill"&lt;/span&gt;
&lt;span class="k"&gt;for&lt;/span&gt; PID &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="nv"&gt;$PIDS&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;do&lt;/span&gt;
  &lt;span class="nv"&gt;OWNER&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;ps -o &lt;span class="nv"&gt;user&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt; -p &lt;span class="s2"&gt;"$PID"&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; tr -d &lt;span class="s1"&gt;' '&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;
  &lt;span class="o"&gt;[&lt;/span&gt; &lt;span class="s2"&gt;"$OWNER"&lt;/span&gt; != &lt;span class="s2"&gt;"$(id -un)"&lt;/span&gt; &lt;span class="o"&gt;]&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nv"&gt;KILL&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"sudo kill"&lt;/span&gt;
  &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"PID $PID  user $OWNER, running $(ps -o etime= -p "&lt;/span&gt;&lt;span class="nv"&gt;$PID&lt;/span&gt;&lt;span class="s2"&gt;" | tr -d ' ')"&lt;/span&gt;
  &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"  command: $(ps -o command= -p "&lt;/span&gt;&lt;span class="nv"&gt;$PID&lt;/span&gt;&lt;span class="s2"&gt;" | cut -c1-120)"&lt;/span&gt;
  &lt;span class="nv"&gt;CWD&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;lsof -a -p &lt;span class="s2"&gt;"$PID"&lt;/span&gt; -d cwd -Fn 2&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;/dev/null &lt;span class="o"&gt;|&lt;/span&gt; sed -n &lt;span class="s1"&gt;'s/^n//p'&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;
  &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"  folder:  ${CWD:-(owned by another user: needs sudo to see)}"&lt;/span&gt;
  &lt;span class="nv"&gt;P&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;ps -o &lt;span class="nv"&gt;ppid&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt; -p &lt;span class="s2"&gt;"$PID"&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; tr -d &lt;span class="s1"&gt;' '&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;
  &lt;span class="k"&gt;while&lt;/span&gt; &lt;span class="o"&gt;[&lt;/span&gt; -n &lt;span class="s2"&gt;"$P"&lt;/span&gt; &lt;span class="o"&gt;]&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="o"&gt;[&lt;/span&gt; &lt;span class="s2"&gt;"$P"&lt;/span&gt; -gt 1 &lt;span class="o"&gt;]&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;do&lt;/span&gt;
    &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"  parent:  $P $(ps -o command= -p "&lt;/span&gt;&lt;span class="nv"&gt;$P&lt;/span&gt;&lt;span class="s2"&gt;" | cut -c1-100)"&lt;/span&gt;
    &lt;span class="nv"&gt;P&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;ps -o &lt;span class="nv"&gt;ppid&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt; -p &lt;span class="s2"&gt;"$P"&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; tr -d &lt;span class="s1"&gt;' '&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;
  &lt;span class="k"&gt;done&lt;/span&gt;
&lt;span class="k"&gt;done&lt;/span&gt;

&lt;span class="nb"&gt;echo&lt;/span&gt;
&lt;span class="nb"&gt;printf&lt;/span&gt; &lt;span class="s2"&gt;"Stop %s with '%s'? [y/N] "&lt;/span&gt; &lt;span class="s2"&gt;"$(echo $PIDS)"&lt;/span&gt; &lt;span class="s2"&gt;"$KILL"&lt;/span&gt;
&lt;span class="nb"&gt;read&lt;/span&gt; -r ANSWER
&lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="s2"&gt;"$ANSWER"&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; y&lt;span class="o"&gt;|&lt;/span&gt;Y&lt;span class="o"&gt;|&lt;/span&gt;yes&lt;span class="o"&gt;)&lt;/span&gt; &lt;span class="o"&gt;;&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; *&lt;span class="o"&gt;)&lt;/span&gt; &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"Left running."&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="nb"&gt;exit&lt;/span&gt; 0 &lt;span class="o"&gt;;&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;esac&lt;/span&gt;

&lt;span class="nv"&gt;$KILL&lt;/span&gt; &lt;span class="nv"&gt;$PIDS&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="nb"&gt;exit&lt;/span&gt; 1
&lt;span class="k"&gt;for&lt;/span&gt; i &lt;span class="k"&gt;in&lt;/span&gt; 1 2 3 4 5&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;do&lt;/span&gt;
  sleep 1
  &lt;span class="nv"&gt;NOW&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;lsof -nP -tiTCP:&lt;span class="s2"&gt;"$PORT"&lt;/span&gt; -sTCP:LISTEN &lt;span class="o"&gt;|&lt;/span&gt; sort -u&lt;span class="o"&gt;)&lt;/span&gt;
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="o"&gt;[&lt;/span&gt; -z &lt;span class="s2"&gt;"$NOW"&lt;/span&gt; &lt;span class="o"&gt;]&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; ! netstat -an -p tcp &lt;span class="o"&gt;|&lt;/span&gt; grep -q &lt;span class="s2"&gt;"[.:]$PORT .*LISTEN"&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;then&lt;/span&gt;
    &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"Port $PORT is free."&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="nb"&gt;exit&lt;/span&gt; 0
  &lt;span class="k"&gt;fi&lt;/span&gt;
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="o"&gt;[&lt;/span&gt; -n &lt;span class="s2"&gt;"$NOW"&lt;/span&gt; &lt;span class="o"&gt;]&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="o"&gt;[&lt;/span&gt; &lt;span class="s2"&gt;"$NOW"&lt;/span&gt; != &lt;span class="s2"&gt;"$PIDS"&lt;/span&gt; &lt;span class="o"&gt;]&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;then&lt;/span&gt;
    &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"Port $PORT was taken again by PID $(echo $NOW): something restarted it (a file watcher, its parent, or launchd)."&lt;/span&gt;
    &lt;span class="nb"&gt;exit&lt;/span&gt; 1
  &lt;span class="k"&gt;fi&lt;/span&gt;
&lt;span class="k"&gt;done&lt;/span&gt;

&lt;span class="nb"&gt;printf&lt;/span&gt; &lt;span class="s2"&gt;"Still listening after 5 s. Force it (%s -9)? [y/N] "&lt;/span&gt; &lt;span class="s2"&gt;"$KILL"&lt;/span&gt;
&lt;span class="nb"&gt;read&lt;/span&gt; -r ANSWER
&lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="s2"&gt;"$ANSWER"&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; y&lt;span class="o"&gt;|&lt;/span&gt;Y&lt;span class="o"&gt;|&lt;/span&gt;yes&lt;span class="o"&gt;)&lt;/span&gt; &lt;span class="nv"&gt;$KILL&lt;/span&gt; -9 &lt;span class="nv"&gt;$PIDS&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; sleep 1 &lt;span class="o"&gt;;&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; *&lt;span class="o"&gt;)&lt;/span&gt; &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"Left running."&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="nb"&gt;exit&lt;/span&gt; 1 &lt;span class="o"&gt;;&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;esac&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; netstat -an -p tcp &lt;span class="o"&gt;|&lt;/span&gt; grep -q &lt;span class="s2"&gt;"[.:]$PORT .*LISTEN"&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;then&lt;/span&gt; &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"Port $PORT is still busy."&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="nb"&gt;exit&lt;/span&gt; 1&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;fi&lt;/span&gt;
&lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"Port $PORT is free."&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;



</description>
      <category>bash</category>
      <category>productivity</category>
      <category>showdev</category>
      <category>devops</category>
    </item>
  </channel>
</rss>
