john-town.md

John Town

A local development dashboard for macOS that finds all your running dev servers.

  • Open Source
  • Deno
  • Fresh
Preview John Town dashboard showing two running dev servers with framework detection, git status, and Claude Code session monitoring
John Town detecting two running dev servers — each with its own animal mascot, port, git branch, and Claude Code session status.
Repository donjo/john-town A local development dashboard for macOS →

What it does

John Town is a zero-config development dashboard for macOS. Start it up and it automatically finds every dev server running on your machine — no setup needed. It scans common development ports and displays them in a table, each with its own animal character based on the framework it detects.

How it works

It recognizes frameworks like Vite, Next.js, Fresh, Django, Rails, Flask, Astro, and others. For each running server, it shows the project name, port, framework, and git branch info — including whether the branch has uncommitted changes or is running in a worktree.

It also detects active Claude Code sessions and shows whether Claude is working or waiting for input. The dashboard auto-refreshes every 5 seconds, so it always reflects what's actually running.

Built with

Deno, Fresh 2.x, Preact, and Tailwind CSS v4.

TERMINAL
$