🇨🇳 🇺🇸

http-server

Forget ports, just preview.

🔄 Auto port· 🧠 Smart index· 📋 Project tracking· ⚡ Zero dep· 🤖 AI-ready (MCP + prompt)

pip install http-server-cli
🚀 Quick start
$ hs -o
$ hs --open --index index.html
$ hs list
$ hs kill 8081
📊 Comparison
Tool Start Auto port Tracking List Kill Open
python3 -m http.server ✅ — — — — —
http-server (npm) ✅ — — — — ✅
serve (npm) ✅ — — — — ✅
live-server (npm) ✅ ✅ — — — ✅
hs (pip) ✅ ✅ ✅ ✅ ✅ ✅
↓ Scenarios

http-server · Scenarios ↑ Back to top

Start · View · Kill · Bookmark · Manage · AI — every command with one-click copy

▶ Start
$ hs -o
✅ http://localhost:8081 → ~/project-alpha
$ hs snapshots/*.html -o
✅ http://localhost:8081/snapshots/latest.html
▶ Bookmark
$ hs bookmark add alpha ~/project-alpha
✅ Bookmark 'alpha' → ~/project-alpha
$ hs bookmark list
📊 1 bookmark(s):
📌 alpha
📁 ~/project-alpha
$ hs alpha -o
✅ http://localhost:8081 → ~/project-alpha
▶ View
$ hs list
📊 Total 2 HTTP services
http://localhost:8081 → ~/project-beta
http://localhost:8081 → ~/project-alpha
$ hs list --json
[{"port":8081,"path":"~/beta",...}]
$ hs status
✅ Daemon running (PID: 12345)
$ hs dashboard -o
📊 Dashboard → http://localhost:8180
▶ Kill
$ hs kill 8081
🛑 Terminated PID: 45678
✅ Port 8081 closed
$ hs kill ~/project-alpha
✅ ~/project-alpha closed
$ hs kill-all
✅ 3 service(s) closed
▶ Manage
$ hs dashboard -o
📊 Dashboard → http://localhost:8180
▶ AI
$ hs prompt
📖 Usage docs for AI agents (5 skills)
$ hs mcp
🤖 hs mcp (SSE) → http://localhost:8181/sse
$ hs mcp --transport stdio
🔌 stdio mode — for Claude Code / Cursor / Hermes
$ hs mcp --config
⚙️ mcpServers snippet — paste & connect