Skip to content

velobase/DevMinder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DevMinder

GitHub stars Build macOS DMG Latest release Download DMG

A tiny macOS menu bar app that helps you spot forgotten dev processes from Codex, Cursor, Next.js, Vite, test watchers, Docker containers, and other local tools before they quietly drain your Mac.

Download the latest DMG · Releases · Issues

Why

When you are building with Codex, Cursor, or any fast AI coding workflow, it is easy to ask the tool to start a Next.js app, run a Vite preview, kick off tests, or bring up a Docker container. The work moves quickly. The cleanup does not always keep up.

A forgotten next dev, a Vite server on 5173, a Flask API on 5000, a test watcher, Redis, Postgres, or a mapped Docker container can sit in the background for hours. You usually notice only when your Mac feels warm, the battery drops faster than expected, or a familiar port is mysteriously already in use.

DevMinder was made for that small but annoying moment. It lives in the menu bar, watches the development ports and process rules you care about, and lets you stop forgotten processes when you decide they should go.

Features

  • Menu bar first: no Dock icon and no desktop window on launch.
  • Port monitoring: defaults cover common development ports for Next.js/React/Nuxt, Vite, Angular, Astro, Flask/API, Postgres, Redis, Storybook, Django/FastAPI, Spring/Tomcat/API, Wrangler, and more.
  • Process rules: match global processes with plain keywords or /regex/ patterns such as vite, next dev, rails server, or uvicorn.
  • Sleep mode: pause or resume monitoring from the menu bar.
  • Low overhead scanning: defaults to a 30-second interval and batches port checks to avoid repeatedly spawning heavy commands.
  • Safe stopping flow: send TERM first, then offer KILL only if the process does not exit.
  • Docker-aware stopping: mapped Docker Desktop ports resolve to containers and use docker stop / docker kill instead of terminating Docker backend processes.
  • System process protection: Apple system processes are marked as protected and cannot be stopped from the app.
  • Collapsible idle ports: running ports stay visible while idle ports can stay tucked away.
  • Localization and appearance: follows system language and appearance, with Chinese/English and light/dark modes available in settings.

Install

  1. Download DevMinder.dmg.
  2. Open the DMG and drag DevMinder.app into Applications.
  3. Launch the app and look for the menu bar icon.

This free distribution build is not notarized with an Apple Developer ID. If macOS says the developer cannot be verified, open System Settings -> Privacy & Security and choose Open Anyway. This keeps the project free to distribute, but it is not as smooth as a fully signed and notarized commercial build.

Usage

  • Click the menu bar icon to view matched port processes and rule matches.
  • Click refresh to scan immediately.
  • Click pause to enter sleep mode and stop the background timer.
  • Click the close button on a process row to send TERM.
  • If the process does not exit, the button changes to a force-stop action.
  • Docker rows show the resolved container name and stop the container directly.
  • Apple system processes show a protected system badge instead of a stop button.

Development

swift run ProcessManager

Checks

swift run ProcessManagerCheck

Local Packaging

Build the .app:

./scripts/build-app.sh
open dist/DevMinder.app

Build the .dmg:

./scripts/build-dmg.sh
open dist/DevMinder-0.1.2.dmg

Override version metadata and the DMG name:

APP_VERSION=0.1.2 BUILD_NUMBER=3 DMG_NAME=DevMinder-0.1.2.dmg ./scripts/build-dmg.sh

Automated Releases

GitHub Actions builds a DMG in these cases:

  • Push to main: build, smoke test, package, and upload an Actions artifact.
  • Pull request: build, smoke test, package, and upload an Actions artifact.
  • Push a v* tag: create a GitHub Release and upload DMG assets.

Create a release:

git tag v0.1.2
git push origin v0.1.2

Each release contains:

  • DevMinder-0.1.2.dmg: versioned archive asset.
  • DevMinder.dmg: stable filename for README and website download links.

Stable latest download URL:

https://github.com/velobase/DevMinder/releases/latest/download/DevMinder.dmg

Star History

Star History Chart

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors