fml - find my local | Summon your localhost window instantly

Readme.txt

What is fml?

fml (Find My Local) is a productivity tool for developers who work with multiple local development projects. It lives in your menu bar and gives you instant access to your dev servers with intelligent features like:

👁️ Smart Window Finding - Finds existing browser tabs with your localhost URL and reloads them

🕵️ Always Incognito - Opens browsers in private/incognito mode (no cache issues!)

🚀 Auto Server Management - Detects if your dev server is running, can start it via Terminal

📦 Project Auto-Detection - Scans your projects folder and automatically detects project types

🔌 Port Detection - Intelligently reads port from config files (package.json, vite.config, etc.)

⌨️ Global Hotkey - Quick access from anywhere with a keyboard shortcut

🔄 Smart Project Switching - Switch between projects with automatic server restart and browser reload

Key Features

Smart Browser Management

Find & Reload - Finds existing browser tab with your URL and automatically reloads it

New Window - Always opens a fresh incognito window

Bring to Front - Just activates the browser (useful when you manage tabs manually)

Multi-Browser Support - Chrome, Firefox, Edge (with auto-detection)

Intelligent Project Detection

fml automatically scans your projects folder and detects:

Type	Marker File	Default Command	Port Detection
Node.js	`package.json`	`npm run dev`	package.json, vite.config, next.config
Rust	`Cargo.toml`	`cargo run`	Cargo.toml
Go	`go.mod`	`go run .`	main.go
Ruby	`Gemfile`	`rails s`	config/puma.rb
Python	`requirements.txt`	`python -m http.server 3000`	-
PHP	`composer.json`	`php -S localhost:3000`	-
Java	`pom.xml`	`./mvnw spring-boot:run`	pom.xml

Type

Marker File

Default Command

Port Detection

Node.js

package.json

npm run dev

package.json, vite.config, next.config

Rust

Cargo.toml

cargo run

Cargo.toml

go.mod

go run .

main.go

Ruby

Gemfile

rails s

config/puma.rb

Python

requirements.txt

python -m http.server 3000

PHP

composer.json

php -S localhost:3000

Java

pom.xml

./mvnw spring-boot:run

pom.xml

Server Status Monitoring

Real-time Status - Color-coded indicator (🟢 Running / ⚪ Stopped / 🟡 Starting)

Port Monitoring - Continuously checks if your dev server is running

Smart Start - Prompts to start server if it's not running

Terminal Integration - Opens Terminal and runs your dev command

Custom URLs

Not just for localhost! You can also set a custom URL like:

staging.example.com

localhost:8080/admin

https://dev.myapp.com