devpilot_status
Check health status of dev server services. Returns live health check results including status, response time, and configuration for all registered services or a specific one.
Args:
service_name: Name of a specific service to check. Omit to check all.
devpilot_changed
Report a file change and check if the dev server reloaded successfully. Call this AFTER editing a file. Returns which service was affected, reload status (reloaded/reload_failed/timeout), and health. This is the primary feedback loop for AI coders.
Args:
filepath: Path of the changed file relative to project root.
verify_endpoint: Optional HTTP endpoint to hit after reload, e.g. "/api/hello".
timeout: Max seconds to wait for reload detection. Default 15.
devpilot_run
Start and manage a dev server process. Spawns the process, captures stdout, detects reload patterns, monitors health, and auto-recovers from crashes. Supports FastAPI, Flask, Django, Vite, Next.js, and CRA with auto-detected defaults.
Args:
name: Unique service name, e.g. "api" or "frontend".
cmd: Shell command to start the server, e.g. "uvicorn main:app --reload --port 8000".
port: Port the server listens on. Auto-detected from framework if omitted.
service_type: "backend" or "frontend". Auto-detected if omitted.
health_endpoint: HTTP path for health checks, e.g. "/health". Uses TCP if omitted.
file_patterns: Glob patterns for watched files, e.g. ["**/*.py"].
reload_patterns: Stdout patterns indicating a successful reload.
devpilot_attach
Attach to an already-running dev server for health monitoring. Discovers the process by port but does NOT own or restart it. Use when the server was started externally.
Args:
name: Unique service name.
port: Port the existing server listens on.
service_type: "backend" or "frontend".
cmd: Original start command (for reference only).
health_endpoint: HTTP path for health checks.
devpilot_stop
Gracefully stop managed dev server services. Only stops services that devpilot started. Never kills processes it didn't start.
Args:
name: Name of a specific service to stop.
stop_all: Set true to stop all managed services.
devpilot_init
Auto-detect project structure and generate .devpilot.yaml config. Scans for pyproject.toml, requirements.txt, and package.json to detect frameworks (FastAPI, Flask, Django, Vite, Next.js, CRA) and generates appropriate service configuration.