joshuatownsend

Project Minder

Name: Project Minder
Author: joshuatownsend

Git community

SOURCE https://github.com/joshuatownsend/project-minder

Description

A local-only dev dashboard that auto-scans your projects and surfaces the context you need — git status, Claude Code sessions, TODOs, costs, and more — without leaving your browser.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Project Minder

A local-only dev dashboard that auto-scans your projects and surfaces the context you need — git status, Claude Code sessions, TODOs, costs, and more — without leaving your browser.

![Node](https://img.shields.io/badge/node-%3E%3D22.13-brightgreen) ![License](https://img.shields.io/badge/license-MIT-blue) ![Stack](https://img.shields.io/badge/stack-Next.js%2016%20%2B%20TypeScript-black)

![Dashboard](docs/images/dashboard.png)

Check out [https://joshuatownsend.github.io/project-minder/](https://joshuatownsend.github.io/project-minder/) for more info and interface screenshots!

Install

Option 1 — Desktop app (recommended)

The fastest way to get started. The installer bundles the dashboard server and an embedded Node runtime — nothing else to install.

Download the installer for your platform from GitHub Releases: Windows (NSIS .exe), macOS Apple Silicon (.dmg), macOS Intel (.app.tar.gz — extract, then drag the app to Applications), or Linux (.AppImage / .deb).
Run the installer. The builds are unsigned: on Windows, SmartScreen warns — click "More info" → "Run anyway"; on macOS, right-click the app → Open on first launch.
Launch the app. A tray icon appears; click Open Dashboard to open the web UI at http://localhost:4100.
Optional: click Start at login in the tray menu to enable autostart.

By default Project Minder scans `C:\dev` on Windows and `~/dev` on macOS/Linux. To scan different directories, change the scan roots from the dashboard's **Config** page, or edit `~/.minder/.minder.json`. See [Tray App help](docs/help/tray-app.md) for the menu reference, notifications, and troubleshooting.

Option 2 — Run from source

**Prerequisites:** Node.js ≥ 22.13 and [pnpm](https://pnpm.io) (run `corepack enable` to use the version pinned in `package.json`) — runs on macOS, Linux, and Windows