Skip to content

Releases

AppShelf v0.7.0 — OSS-readiness release

Choose a tag to compare

@cspergel cspergel released this 20 Jun 23:36

AppShelf v0.7.0 — OSS-readiness release

The biggest hardening + cleanup pass since the WebView2/React rearchitecture. AppShelf goes from "works on my machine" to "works for a stranger who clones it."

✨ New

  • Tray quick-launch — right-click the tray icon to launch or stop any favorited or running app, each with a live colored status dot. No need to open the window.
  • Live log viewer — a per-app panel that streams the app's stdout/stderr while open, and auto-surfaces on a crash so you see what went wrong.

🧹 Cleanup

  • Dead-WPF cutover — removed the legacy WPF dialog/card-grid layer entirely (~1,900 lines). The tray now drives the WebView2 web UI directly. Spotlight stays WPF by design.

🔒 Hardening (comprehensive security + robustness pass)

  • Shell-injection fixed in the Open-Terminal/Editor quick actions (ProcessStartInfo.ArgumentList).
  • Edit-dialog data-loss fixed — editing a local app no longer silently drops its command or fixed port.
  • WebView2 init failures now show a clear message + runtime download link instead of a blank window.
  • Friendly permission-denied messages for restricted %APPDATA%/%LOCALAPPDATA%.
  • Lifecycle fixes: "crashed-forever" status heal, launch race (TOCTOU) guard, atomic regrouping, reclaim no longer launches into a doomed port bind.
  • WebView2 origin-lock navigation guard, hotkey input validation, log line-length cap, error.log rotation, full-path PowerShell for elevated service stop.

✅ Quality

  • 250 xUnit tests (up from 234) — Core engine fully covered. Build clean, clean-clone verified.

📦 Install

Download AppShelf.exe below (Windows x64, self-contained — no .NET install required; Windows 11 ships the WebView2 runtime, Windows 10 may need it from Microsoft).

v0.6.1 - Spotlight restyled

Choose a tag to compare

@cspergel cspergel released this 20 Jun 17:43

AppShelf v0.6.1 — Spotlight overlay restyled to match

The global-hotkey Spotlight launcher (press Alt+Space / your configured hotkey → search and launch any app from anywhere) now matches the new Ostara theme — slate surfaces with an emerald selection highlight and caret, instead of the old violet styling.

No functional changes; this is a visual polish patch on top of v0.6.0's web-UI rebuild.

  • Windows 11, self-contained single-file exe. Download AppShelf.exe below.

v0.6.0 - New web-based UI

Choose a tag to compare

@cspergel cspergel released this 20 Jun 16:58

AppShelf v0.6.0 — New web-based UI (complete front-end rebuild)

A ground-up redesign of the interface. The old WPF UI is replaced by a modern web UI (React + Tailwind, hosted in WebView2) with a refined dark "Ostara" look — emerald accent, layered slate surfaces — while the entire C# engine (AppShelf.Core) and its 234 tests are unchanged.

New look & feel

  • Refined dark theme — emerald-green accent, blue-slate floating-panel cards, matching tray/app icon.
  • Everything from the old app, rebuilt: card grid (apps + groups, live status, start/stop), favorites (persist + sort to top), and a fast, owner-aware status display.

Port Doctor

  • Scan listening ports, classified by tier (Managed / Registered / Likely-orphaned / Unknown), with a ⚙ service badge.
  • Expand any row for the full process-ancestry chain (with [dead] markers, command line, exe dir) — now with a Copy button.
  • Reclaim an orphaned port (kill + relaunch the owning app), Stop service (elevated), or Kill — each with a confirm + clear result.

Quick actions (new)

  • Per-app ⋯ menu: open a terminal in the app's folder, open in editor, open the folder, open .env, open API docs, copy URL / copy folder path.

Manage apps

  • Add / Edit / Remove apps in-app, with a native folder picker and stack auto-detection (fills in command/URL/port/framework).
  • Drag-to-rearrange / group cards — reorder, create a group, join/leave, reorder members — with smooth, instant drops.

Under the hood

  • Self-contained single-file exe (Windows x64) — no .NET install, no dev server required. Web assets are embedded.
  • Faster status polling (concurrent localhost probes) for a snappy UI.

Notes

  • Windows 11 (WebView2 runtime ships with the OS). Download AppShelf.exe below.

v0.5.0 - Dead-man's-switch crash watcher

Choose a tag to compare

@cspergel cspergel released this 18 Jun 22:52

AppShelf v0.5.0 — Dead-man's-switch crash watcher

AppShelf now actively watches the dev servers it launched and tells you when one dies on its own — instead of you finding out later when you go to use it.

New

  • Crash watcher — when a managed app's server exits unexpectedly (it crashed, wasn't stopped by you), AppShelf raises a tray balloon and flips the card to a red "stopped unexpectedly" state with its last log lines and a Restart button.
  • No false alarms — a clean Stop never triggers an alert, and hot-reload port blips are ridden out by a short debounce. Only a genuine unexpected exit fires.
  • Group members are covered automatically.

Notes

  • Windows x64, self-contained — no .NET install required. Download AppShelf.exe below.
  • 234 unit tests, single-user personal tool.

v0.4.0 - Port Doctor: reclaim, stop-service, conflict-aware launch

Choose a tag to compare

@cspergel cspergel released this 18 Jun 19:13

AppShelf v0.4.0 — Port Doctor: reclaim, stop-service, conflict-aware launch

This release makes the Port Doctor actually resolve port problems, not just diagnose them — and stops AppShelf from silently launching into an occupied port.

New

  • Reclaim & Relaunch — when an orphaned port belongs to a registered app, one click stops the orphan, frees the port, and relaunches your app.
  • One-click Stop-Service (elevated) — service-backed ports now show a ⚙ Service badge and a Stop service button that does a proper SCM Stop-Service via a single UAC prompt (no more "access denied" dead-end). Detects service workers, not just direct services.exe children.
  • Pre-flight conflict check — launching an app whose port is held by another process now flags it: the card shows "port in use" and Start asks to reclaim (stop the other process and start your app) instead of silently opening the browser to the wrong server.
  • Owner-aware status — a registered port held by something AppShelf doesn't manage shows "port in use" rather than a misleading "running".
  • CLI appshelf doctor --json / --watch — scriptable port scans: clean JSON to stdout, an interval watch mode, and JSONL streaming with --json --watch.

Notes

  • Windows x64, self-contained — no .NET install required. Download AppShelf.exe below.
  • 225 unit tests, single-user personal tool.

v0.3.0 - Port Doctor ancestry traceback

Choose a tag to compare

@cspergel cspergel released this 18 Jun 01:17

AppShelf v0.3.0 — Port Doctor: process-ancestry traceback

The Port Doctor now explains why a port is stuck, not just that it is.

New

  • Process-ancestry traceback — expand any port row to see the full parent chain of the process holding it (e.g. node ← [dead] npm ← [dead] cmd), with each process's command line and exe directory pulled from WMI. Makes "why is this orphaned" obvious at a glance.
  • Copyable & selectable — a pinned Copy button copies the whole chain; the panel text is also drag-selectable for partial copies. Long chains scroll within the panel (no more jumping to the next row).
  • Service-aware kill — when a port is held by a Windows service (including a service's worker processes, detected via the Service Control Manager), AppShelf now says so and explains it needs elevation, instead of dumping a raw taskkill error.

Fixed

  • Ancestry walk now stops at the first dead ancestor instead of fabricating a bogus chain through recycled PIDs.
  • Kill failures surface a clean, readable message (no raw taskkill output).
  • Hardened the Ports panel refresh: crash-safe async scan and no dropped refresh after a kill.

Notes

  • Windows x64, self-contained — no .NET install required. Download AppShelf.exe below.
  • 194 unit tests, single-user personal tool.

AppShelf v0.2.1

Choose a tag to compare

@cspergel cspergel released this 12 Jun 16:19

AppShelf is a personal, one-click launcher for your local web/prototype projects on Windows — register a project once, then start its dev server and open the browser with a single click (or one CLI command).

Install

Download AppShelf.exe below and run it. It's self-contained — no .NET runtime needed — and lives in your system tray. Click + Add App to register your first project.

Windows 10/11 (x64). ~155 MB (bundles the .NET 8 runtime). Unsigned, so SmartScreen may warn on first run — click More info → Run anyway, or build from source.

What's new in 0.2.1

  • Spotlight: groups are one entry. A project group now shows as a single result (Enter or click starts the whole group, backend → frontend; opens the frontend if it's already running) instead of its members scattered as separate rows — and it still matches when you type a member's name or tag.
  • Spotlight: click to launch. Result rows now activate on a single mouse click, not just Enter.

From 0.2.0

  • Spotlight overlay — global-hotkey launcher: press your shortcut anywhere, type to fuzzy-match, Enter/click to launch. Also on the tray menu as "Search…".
  • Configurable hotkey — pick your own combo (tray → Hotkey…); defaults to Alt+Space → Ctrl+Alt+Space.
  • Launch pre-flight + one-click Run setup — a plain-English reason when an app can't start, plus a button that runs your install command and retries.
  • Rename a group from the GUI.
  • Smarter, package-aware stack detection (python -m uvicorn app.main:app from the package root; auto pip install -r requirements.txt).

Core features

  • One-click launch with live IPv4/IPv6 status; clean stop that kills the whole process tree and frees the port
  • Project groups (backend + frontend as one card); favorites; search
  • Port registry + Port Doctor (classify and kill zombie dev-server ports)
  • System tray; full CLI (add / list / launch / stop / rm / port / ports / doctor / open)
  • Hand-editable JSON config — no database

See the README and SECURITY.md for details.

AppShelf v0.2.0

Choose a tag to compare

@cspergel cspergel released this 12 Jun 03:27

AppShelf is a personal, one-click launcher for your local web/prototype projects on Windows — register a project once, then start its dev server and open the browser with a single click (or one CLI command).

Install

Download AppShelf.exe below and run it. It's self-contained — no .NET runtime needed — and lives in your system tray. Click + Add App to register your first project.

Windows 10/11 (x64). ~155 MB (bundles the .NET 8 runtime). Unsigned, so SmartScreen may warn on first run — click More info → Run anyway, or build from source.

What's new in 0.2.0

  • Spotlight overlay — a global-hotkey launcher: press your shortcut anywhere, type to fuzzy-match an app, Enter to launch (or open if it's already running). Also on the tray menu as "Search…".
  • Configurable hotkey — pick your own combo (tray → Hotkey…) so it never collides with your other tools. Defaults to Alt+Space → Ctrl+Alt+Space.
  • Launch pre-flight + one-click Run setup — when an app can't start (missing folder, uninstalled deps, no node_modules), AppShelf shows a plain-English reason and a Run setup button that runs your install command and retries.
  • Rename a group from the GUI.
  • Smarter stack detection — uses python -m uvicorn/streamlit (no PATH assumptions) and is package-aware: a FastAPI/Flask app inside a package detects as app.main:app from the package root, and auto-sets pip install -r requirements.txt.

Highlights (carried over)

  • One-click launch with live IPv4/IPv6 status; clean stop that kills the whole process tree and frees the port
  • Project groups (backend + frontend as one card); favorites; search
  • Port registry + Port Doctor (classify and kill zombie dev-server ports)
  • System tray; full CLI (add / list / launch / stop / rm / port / ports / doctor / open)
  • Hand-editable JSON config — no database

See the README and SECURITY.md for details.

Note: this release also fixes a packaging bug where the core process/port files were missing from the source tree — the repo now builds cleanly from a fresh clone.

AppShelf v0.1.0

Choose a tag to compare

@cspergel cspergel released this 11 Jun 03:05

AppShelf is a personal, one-click launcher for your local web/prototype projects on Windows. Register a project once, then start its dev server and open the browser with a single click — or one CLI command. Like Spotlight for your own local apps.

Install

Download AppShelf.exe below and run it. It's self-contained — no .NET runtime needed — and lives in your system tray. Click + Add App to register your first project.

Windows 10/11 (x64). The download is ~155 MB because it bundles the .NET 8 runtime.

The binary is unsigned, so Windows SmartScreen may warn on first run — click More info → Run anyway. Or build it yourself from source (see the README).

Highlights

  • One-click launch with live status — polls until the port is actually up (IPv4 and IPv6)
  • Clean stop — kills the whole process tree and frees the port (no orphaned node)
  • Project groups — backend + frontend as one card; Start-all brings the backend up first
  • Port registry + Port Doctor — clash-free reserved ports, and find/kill zombie dev servers
  • System tray + a full CLI (add / list / launch / stop / rm / port / ports / doctor / open)
  • Auto-detects Vite, Next.js, CRA, Astro, SvelteKit, Angular, FastAPI, Flask, Streamlit, Gradio
  • Hand-editable JSON config at %APPDATA%/AppShelf/config.json — no database

See the README for full docs, and SECURITY.md for the trust model.

Known limitation: the global-hotkey Spotlight overlay isn't built yet — it's the next planned feature.