How do I install the Dev Local skill?

Run npx skillmds@latest add superdesigndev/dev-local 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.

What does the Dev Local skill do?

One-command local dev stack for tools-registry. Use when asked to "start the dev server", "run treg locally", "test login locally", "bring the stack up", or before any manual/browser test against localhost. It is listed under Coding & Dev Tools on SkillMD.

Is Dev Local 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 Dev Local?

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 Dev Local free to use?

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

Who published Dev Local?

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

Dev Local by superdesigndev — Agent Skill

Name: Dev Local
Author: superdesigndev

File contents

dev-local — the local treg stack in one command

scripts/dev-local.sh runs the FastAPI server in a tmux session with dev-safe settings, and gives you a sandboxed CLI that never touches ~/.treg/config.json.

Service	Command (managed by the script)	Port
treg server	`uv run python -m treg --reload` + `TREG_EMAIL_DEV_MODE=true`, own sqlite `treg-dev.db`	18790

No infra deps (sqlite). Prerequisites: tmux, uv (the script runs uv sync if .venv is missing).

Subcommands

scripts/dev-local.sh up          # start (idempotent) — prints URLs when healthy
scripts/dev-local.sh down        # stop the session
scripts/dev-local.sh status      # windows + port check
scripts/dev-local.sh logs        # last 200 lines of the server window
scripts/dev-local.sh restart     # respawn the server window
scripts/dev-local.sh attach      # attach to tmux
scripts/dev-local.sh cli <args>  # working-tree treg CLI, sandboxed HOME, pre-pointed at localhost
scripts/dev-local.sh reset       # down + wipe treg-dev.db and the CLI sandbox

cli is the key trick for login testing: scripts/dev-local.sh cli login runs the repo's CLI against localhost with HOME=scripts/.dev-home, so the real ~/.treg/config.json (usually pointing at production) is never overwritten. Email OTP dev mode is on — codes appear in the login page / API response, no mail sender needed.

Troubleshooting

Port 18790 in use, no session → something else owns it: lsof -i :18790.
Server window died → scripts/dev-local.sh logs for the traceback, then restart.
Stale dev state / want a fresh DB → scripts/dev-local.sh reset then up.

Frequently asked questions

Dev Local