DevPilot

tools

• 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.

  in ▸ cmd name port service_type health_endpoint

• 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.

  in ▸ timeout filepath verify_endpoint

• devpilot_cleanup

  Remove stale state entries for processes that are no longer running. Cleans up dead PIDs and orphan service registrations.

• devpilot_health_check

  Perform a direct health check on any port. Returns healthy/unhealthy status, HTTP status code, and response time. Works without registering a service. Args: port: Port number to check. endpoint: HTTP path like "/health". Uses raw TCP check if omitted.

  in ▸ port endpoint

• 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.

• devpilot_log

  View recent devpilot events including auto-restarts, crashes, recoveries, and escalations. Args: service_name: Filter to a specific service. Omit for all events.

  in ▸ service_name

• 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.

  in ▸ cmd name port service_type file_patterns health_endpoint reload_patterns

• 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.

  in ▸ service_name

• 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.

  in ▸ name stop_all

• devpilot_up

  Start all services defined in .devpilot.yaml. Reads the project config and starts each service under supervision with auto-recovery.