How do I install the Agent Dev Services skill?

Run npx skillmds@latest add tomevault-io/agent-dev-services in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Agent Dev Services safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agent Dev Services?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agent Dev Services free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agent Dev Services?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agent Dev Services by tomevault-io — Agent Skill

Name: Agent Dev Services
Author: tomevault-io

Agent Dev Services

Start and persist the local .NET API and React frontend on the managed agent runtime (supervisord, system Postgres on 5432). Use when (1) starting backend/frontend for local dev on the agent machine, (2) services died after an agent turn, (3) user asks to run npm run dev or dotnet run persistently, (4) wiring API to non-Docker Postgres on this environment. Use when this capability is needed.

tomevault-io b53f677 2 files · 3.9 KB Updated Sep 17, 2026

File contents

Agent Dev Services (Managed Runtime)

Background shell processes die when an agent turn ends. Use supervisord drop-ins under /data/.glenn/supervisor.d/ so the API and frontend survive across turns.

Quick start

bash .claude/skills/agent-dev-services/scripts/install-supervisor-services.sh

This will:

Start system PostgreSQL 15 on 127.0.0.1:5432 (not Docker)
Ensure database app exists
npm install (with NODE_ENV=development) + dotnet restore + migrations
Register dotnet-api and backoffice-web with supervisord
Start both services

Endpoints

Service	URL
Frontend	http://localhost:5173
API	http://localhost:5338
Swagger	http://localhost:5338/swagger

Vite proxies /api and /hubs → 5338 (see packages/backoffice-web/vite.config.ts).

Database (non-Docker)

Uses the Debian system Postgres, not packages/local-db Docker compose:

Host=localhost;Port=5432;Database=app;Username=postgres;Password=postgres

Passed via DATABASE_URL in the supervisord program env (overrides appsettings.json).

First boot seeds dev users (OTP/password Test123!):

admin@test.com — OTP 111111
test@test.com — OTP 123456

Supervisord commands

supervisorctl status dotnet-api backoffice-web
supervisorctl restart dotnet-api
supervisorctl restart backoffice-web
supervisorctl tail -f dotnet-api stderr
supervisorctl tail -f backoffice-web stderr

Logs on disk:

/var/log/supervisor/dotnet-api.out.log
/var/log/supervisor/backoffice-web.out.log

Do NOT use for persistence

# Dies when the agent turn ends:
dotnet run &
npm run dev &

Prerequisites on a fresh machine

Tool	Install (if missing)
.NET 9 SDK	`sudo apt install dotnet-sdk-9.0`
PostgreSQL 15	`sudo apt install postgresql`
EF migrations tool	`dotnet tool install --global dotnet-ef`

`NODE_ENV=production` gotcha

The agent shell sets NODE_ENV=production, which skips frontend devDependencies. The install script and run wrappers force NODE_ENV=development for Vite.

Files

Path	Purpose
`scripts/install-supervisor-services.sh`	One-shot install + start
`scripts/run-dotnet-api.sh`	Supervisord command for API
`scripts/run-backoffice-web.sh`	Supervisord command for Vite
`templates/*.conf`	Copied to `/data/.glenn/supervisor.d/`

Uninstall

supervisorctl stop dotnet-api backoffice-web
rm /data/.glenn/supervisor.d/dotnet-api.conf /data/.glenn/supervisor.d/backoffice-web.conf
supervisorctl reread && supervisorctl update

Source: dotnetmentor/glenn-code-factory — distributed by TomeVault.

---name: agent-dev-servicesdescription: Start and persist the local .NET API and React frontend on the managed agent runtime (supervisord, system Postgres on 5432). Use when (1) starting backend/frontend for local dev on the agent machine, (2) services died after an agent turn, (3) user asks to run npm run dev or dotnet run persistently, (4) wiring API to non-Docker Postgres on this environment. Use when this capability is needed.---# Agent Dev Services (Managed Runtime)Background shell processes **die when an agent turn ends**. Use **supervisord** drop-ins under `/data/.glenn/supervisor.d/` so the API and frontend survive across turns.## Quick start```bashbash .claude/skills/agent-dev-services/scripts/install-supervisor-services.sh```This will:1. Start **system PostgreSQL 15** on `127.0.0.1:5432` (not Docker)2. Ensure database `app` exists3. `npm install` (with `NODE_ENV=development`) + `dotnet restore` + migrations4. Register `dotnet-api` and `backoffice-web` with supervisord5. Start both services## Endpoints| Service | URL ||---------|-----|| Frontend | http://localhost:5173 || API | http://localhost:5338 || Swagger | http://localhost:5338/swagger |Vite proxies `/api` and `/hubs` → `5338` (see `packages/backoffice-web/vite.config.ts`).## Database (non-Docker)Uses the **Debian system Postgres**, not `packages/local-db` Docker compose:```Host=localhost;Port=5432;Database=app;Username=postgres;Password=postgres```Passed via `DATABASE_URL` in the supervisord program env (overrides `appsettings.json`).First boot seeds dev users (OTP/password `Test123!`):- `admin@test.com` — OTP `111111`- `test@test.com` — OTP `123456`## Supervisord commands```bashsupervisorctl status dotnet-api backoffice-websupervisorctl restart dotnet-apisupervisorctl restart backoffice-websupervisorctl tail -f dotnet-api stderrsupervisorctl tail -f backoffice-web stderr```Logs on disk:- `/var/log/supervisor/dotnet-api.out.log`- `/var/log/supervisor/backoffice-web.out.log`## Do NOT use for persistence```bash# Dies when the agent turn ends:dotnet run &npm run dev &```## Prerequisites on a fresh machine| Tool | Install (if missing) ||------|----------------------|| .NET 9 SDK | `sudo apt install dotnet-sdk-9.0` || PostgreSQL 15 | `sudo apt install postgresql` || EF migrations tool | `dotnet tool install --global dotnet-ef` |## `NODE_ENV=production` gotchaThe agent shell sets `NODE_ENV=production`, which skips frontend **devDependencies**. The install script and run wrappers force `NODE_ENV=development` for Vite.## Files| Path | Purpose ||------|---------|| `scripts/install-supervisor-services.sh` | One-shot install + start || `scripts/run-dotnet-api.sh` | Supervisord command for API || `scripts/run-backoffice-web.sh` | Supervisord command for Vite || `templates/*.conf` | Copied to `/data/.glenn/supervisor.d/` |## Uninstall```bashsupervisorctl stop dotnet-api backoffice-webrm /data/.glenn/supervisor.d/dotnet-api.conf /data/.glenn/supervisor.d/backoffice-web.confsupervisorctl reread && supervisorctl update```---> Source: [dotnetmentor/glenn-code-factory](https://github.com/dotnetmentor/glenn-code-factory) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions