a-grasso

a-grasso / portbook

Public

Local Rust web dashboard that auto-discovers and labels HTTP dev services running on localhost ports — with live SSE updates, project-root detection, and live/error/dead classification.

11
0
100% credibility
Found May 11, 2026 at 11 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

Portbook automatically discovers and displays local HTTP development servers with labels from project folders and web page titles, categorizing them as live, error, or dead across web UI, terminal lists, and interactive views.

How It Works

1
😩 Frustrated with random ports

You're running multiple development servers on unknown ports and can't remember which is which.

2
📥 Grab it quickly

Download and install with a simple command or package manager—no complicated setup needed.

3
🚀 Start it up

Run the program and it opens a webpage showing all your local services at a glance.

4
✨ See everything labeled

Cards appear with project names, page titles, and colors showing if services are running smoothly, broken, or stopped.

5
🖱️ Click to visit

Click any card to jump straight to that service in your browser.

6
💻 Check from terminal too

Use simple commands for lists, live updates, or an interactive view right in your terminal.

🎉 Ports managed forever

Now you always know what's running where, saving time and headaches every day.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 11 to 11 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is portbook?

Portbook is a Rust-powered local web dashboard that scans localhost for HTTP dev servers on non-standard ports, probes them for liveness, and labels each with project name from process cwd plus page title. It classifies services as live, error, or dead, with live SSE updates in the browser UI at http://localhost:7777. CLI options include `portbook ls` for colored terminal lists, `tui` for interactive filtering, `watch --json` for scripts, and `explain ` for diagnostics—ideal for tracking local Rust servers or GitHub Actions runners.

Why is it gaining traction?

Zero-config auto-discovery beats manual port lists, with interchangeable UIs (web, TUI, JSON API at /api/ports) over stable snapshots. Secret redaction in cmdlines, project root detection, and per-port probes for HTTP status/titles make it practical for multi-service workflows, unlike bare lsof/ss wrappers. Devs dig the TUI for tmux and JSON for piping into jq when testing local GitHub Copilot alternatives or Rust playgrounds.

Who should use this?

Backend devs running local Rust servers, frontend folks with Vite/Next on random ports, or ops testing local GitHub runners and RustDesk servers. Suits anyone juggling ephemeral services in Docker or IDEs, especially on macOS/Linux where `lsof`/`ss` are standard. Avoid if you stick to one port at a time.

Verdict

Early project with 11 stars and 1.0% credibility score shows promise via polished README, shell/Homebrew installs, and single 5MB binary—but low traction means watch for stability. Try it now for localhost relief; it's a smart local Rust tool ready for your daily driver.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.