How do I install the Local Dev skill?

Run npx skillmds@latest add mahabdalla/local-dev 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 Local Dev safe to use?

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

Which AI agents work with Local Dev?

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

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

Who published Local Dev?

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

Local Dev by mahabdalla — Agent Skill

Name: Local Dev
Rating: 4.2 (5 reviews)
Author: mahabdalla

File contents

Local Development

Quick Start

./scripts/dev-runner.sh --restart   # First time / full rebuild
./scripts/dev-runner.sh --start     # Daily start (no rebuild)
./scripts/dev-runner.sh --stop      # Stop everything
./scripts/dev-runner.sh --verify    # Check status

Modes

Mode	Command	Frontend	Use When
Standard	`--restart`	localhost:5174	Frontend work, full-stack
BE-only	`--be-only-restart`	localhost:5173	Backend-focused, faster rebuilds

URLs

Frontend: localhost:5174 (standard) / localhost:5173 (BE-only)
Backend API: localhost:8080
Health: http://localhost:8080/health-check?name=all

Build Commands

./scripts/dev-runner.sh --build-be   # Backend only
./scripts/dev-runner.sh --build-fe   # Frontend only
./scripts/dev-runner.sh --lint-be    # Spotless
./scripts/dev-runner.sh --lint-fe    # ESLint
./scripts/dev-runner.sh --migrate    # DB migrations

Logs

tail -f /tmp/opik-backend.log        # Backend
tail -f /tmp/opik-frontend.log       # Frontend (standard)
docker logs -f opik-frontend-1       # Frontend (BE-only)

SDK Config

export OPIK_URL_OVERRIDE='http://localhost:8080'
export OPIK_WORKSPACE='default'

Troubleshooting

Won't start:

./scripts/dev-runner.sh --verify
lsof -i :8080                        # Port conflict?
./scripts/dev-runner.sh --stop && ./scripts/dev-runner.sh --restart

Build fails:

cd apps/opik-backend && mvn clean install -DskipTests
cd apps/opik-frontend && rm -rf node_modules && npm install

Database issues:

./scripts/dev-runner.sh --stop
./opik.sh --clean                    # WARNING: deletes data
./scripts/dev-runner.sh --restart

Converted and distributed by TomeVault | Claim this content

---name: local-devdescription: Local development environment setup and commands. Use when helping with dev server, Docker, or local testing.---# Local Development## Quick Start```bash./scripts/dev-runner.sh --restart # First time / full rebuild./scripts/dev-runner.sh --start # Daily start (no rebuild)./scripts/dev-runner.sh --stop # Stop everything./scripts/dev-runner.sh --verify # Check status```## Modes| Mode | Command | Frontend | Use When ||------|---------|----------|----------|| Standard | `--restart` | localhost:5174 | Frontend work, full-stack || BE-only | `--be-only-restart` | localhost:5173 | Backend-focused, faster rebuilds |## URLs- **Frontend**: localhost:5174 (standard) / localhost:5173 (BE-only)- **Backend API**: localhost:8080- **Health**: http://localhost:8080/health-check?name=all## Build Commands```bash./scripts/dev-runner.sh --build-be # Backend only./scripts/dev-runner.sh --build-fe # Frontend only./scripts/dev-runner.sh --lint-be # Spotless./scripts/dev-runner.sh --lint-fe # ESLint./scripts/dev-runner.sh --migrate # DB migrations```## Logs```bashtail -f /tmp/opik-backend.log # Backendtail -f /tmp/opik-frontend.log # Frontend (standard)docker logs -f opik-frontend-1 # Frontend (BE-only)```## SDK Config```bashexport OPIK_URL_OVERRIDE='http://localhost:8080'export OPIK_WORKSPACE='default'```## Troubleshooting**Won't start:**```bash./scripts/dev-runner.sh --verifylsof -i :8080 # Port conflict?./scripts/dev-runner.sh --stop && ./scripts/dev-runner.sh --restart```**Build fails:**```bashcd apps/opik-backend && mvn clean install -DskipTestscd apps/opik-frontend && rm -rf node_modules && npm install```**Database issues:**```bash./scripts/dev-runner.sh --stop./opik.sh --clean # WARNING: deletes data./scripts/dev-runner.sh --restart```---> Converted and distributed by [TomeVault](https://tomevault.io) | [Claim this content](https://tomevault.io/claim/comet-ml/opik)

Frequently asked questions

Local Dev