Universal Localhost Manager

Never struggle with localhost setup again. One command to rule them all.

See It In Action

Terminal - PROJECT_lechworld
$ dev

How It Works

1

Project Detection

Automatically detects Node.js, Python, Ruby, Go, or Rust projects by analyzing your files

2

Port Assignment

Assigns a unique port to each project and remembers it for future sessions

3

Process Cleanup

Kills any zombie processes and frees up the required port automatically

4

Database Magic

Detects and starts PostgreSQL, MySQL, MongoDB, or Redis based on your config

5

Dependencies

Installs missing packages with npm, pip, bundle, or cargo as needed

6

Launch Server

Starts your development server with the correct command and environment

Key Features

๐ŸŽฏ

Smart Detection

Recognizes project type from package.json, requirements.txt, Gemfile, etc.

๐Ÿ”’

Port Memory

Each project gets its own port, remembered between sessions

๐Ÿ—„๏ธ

Database Auto-Start

Starts PostgreSQL, MySQL, MongoDB, Redis automatically

๐Ÿงน

Process Cleanup

Kills zombie processes and frees ports automatically

๐Ÿ“ฆ

Dependency Install

Runs npm install, pip install, bundle install as needed

๐Ÿ”„

Migration Runner

Executes database migrations automatically

๐ŸŒ

ENV Setup

Creates .env from .env.example, updates PORT

๐Ÿšฆ

Parallel Safe

Multiple Claude sessions work without conflicts

Port Management

Port 3000
/Users/lech/my-express-app
Active
Port 5173
/Users/lech/PROJECT_lechworld
Reserved
Port 8000
/Users/lech/django-project
Reserved

Command Reference

Basic Usage

$ dev

Start any project automatically

$ dev npm run custom-start

Override with custom command

Port Management

$ port-manager list

Show all port allocations

$ port-manager free 3000

Free a specific port

$ port-manager kill-all

Kill all development servers

Troubleshooting

$ PORT=8080 dev

Force a specific port

$ SKIP_DB=1 dev

Skip database startup

$ DEBUG=1 dev

Run in debug mode

Try It Out

Click the buttons to see what happens behind the scenes