dev

Start and manage local dev servers for ACT infrastructure projects.

Updated Dec 27, 2025
One-click install
npx skills add https://github.com/Acurioustractor/act-global-infrastructure --skill dev-acurioustractor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev
Source: https://github.com/Acurioustractor/act-global-infrastructure/tree/main/.claude/skills/dev
Command: npx skills add https://github.com/Acurioustractor/act-global-infrastructure --skill dev-acurioustractor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill starts and manages a full local development environment for ACT global infrastructure projects.

Core Features & Use Cases

  • Start dev servers: Dashboard (Next.js) and API servers to facilitate local development.
  • Optional tunnel: Enable a cloudflared tunnel for webhook testing.
  • Health checks & logs: Run health checks and tail logs to monitor locally.
  • Start/stop automation: Manage PM2 processes and optional cron scripts for local workflows.
  • Real-world use case: A developer tests a Telegram or webhook integration against a local instance before deploying.

Quick Start

Use the dev skill to start the local development stack with the command: ./dev start. Then verify readiness:

  • Check prerequisites: node --version && pnpm --version && pm2 --version
  • Start: cd /Users/benknight/Code/act-global-infrastructure; ./dev start
  • Verify dashboard: curl -s -o /dev/null -w "Dashboard: %{http_code}\n" http://localhost:3001/
  • Verify API: curl -s -o /dev/null -w "API: %{http_code}\n" http://localhost:3456/api/health
  • PM2 status: pm2 status

Frequently Asked Questions about dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a local development environment with Next.js and API servers?

You can start local development by running the ./dev start command in your project directory, which uses PM2 to orchestrate and launch the Next.js dashboard and API servers concurrently for local testing.

Can I test webhooks locally without deploying my application?

Yes, you can test webhooks locally by enabling an optional cloudflared tunnel. This exposes your local environment to external webhook requests, allowing you to validate integrations safely before deploying.

Do I need pnpm and PM2 installed to run the local dev stack?

Yes, you need Node, pnpm, and PM2 installed as prerequisites. The local dev stack relies on pnpm for package management and PM2 to orchestrate and manage the background server processes.

How do I check logs and health status for my local API and dashboard?

You can verify health status by curling the local API and dashboard endpoints, or by running pm2 status. The skill also provides commands to run health checks and tail logs to monitor local processes.

What is the best way to manage PM2 processes and cron scripts for local workflows?

The best way to manage PM2 processes and optional cron scripts is through the dev skill's start and stop automation. It orchestrates the local stack lifecycle, including background tasks, for seamless local workflows.