freeport-cli

Free up any port instantly by killing the process bound to it.

Installation

Run directly with npx:

npx freeport-cli 3000

Or install globally:

npm install -g freeport-cli
freeport-cli 3000

Usage

npx freeport-cli 3000
npx freeport-cli --help
npx freeport-cli --version

Programmatic Usage

const { killPort } = require('freeport-cli');

async function run() {
  const result = await killPort(3000);
  console.log(result);
}

run();

How It Works

• On macOS/Linux, it runs lsof -ti tcp:{port} to find process IDs, then kill -9 {PID}.
• On Windows, it runs netstat -ano | findstr :{port} to find process IDs, then taskkill /PID {PID} /F.
• It handles empty ports, invalid input, multi-PID scenarios, and permission errors with clear output.

Platform Support

| Platform | Supported | | --- | --- | | macOS | ? | | Linux | ? | | Windows | ? |

Contributing

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Open a pull request.

License

MIT