dev-run

What problem does it solve?

This Skill eliminates the tedious, error-prone manual work of setting up the finance-hledger local development environment, which requires coordinating a FastAPI backend, Vite frontend, Python virtual environment, Node dependencies, hledger CLI validation, and correct environment variable configuration that often causes silent uvicorn failures.

Core Features & Use Cases

• Idempotent Startup: The included startup script handles first-run setup (venv creation, npm install, .env scaffolding) and safely restarts existing dev servers if they are already running.
• Prerequisite Validation: Automatically checks for required tools including hledger 1.52+, Python 3.10+, and Node 18+, and provides clear install instructions if any are missing.
• Safe Shutdown: The stop script only kills the dev processes it started, with fallback logic to avoid accidentally terminating unrelated services running on ports 8080 or 5173.
• Use Case: A developer contributing to the finance-hledger project can use this Skill to spin up the full local dev stack in one command instead of running 10+ separate manual setup and startup steps, and cleanly shut it down when finished.

Quick Start

Use the dev-run skill to start the full local finance-hledger development environment with the backend on port 8080 and frontend on port 5173, or run the provided stop script to cleanly shut down all dev processes when you are finished working.