# DevPilot

Dev server supervisor for AI coders. Manages dev server lifecycles, detects reloads, checks health, and recovers from crashes. 10 MCP tools for full lifecycle management. Best used as a local stdio s…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add benzsevern/devpilot

# Browse available tools
npx -y smithery tool list benzsevern/devpilot

# Get full schema for a tool
npx -y smithery tool get benzsevern/devpilot devpilot_status

# Call a tool
npx -y smithery tool call benzsevern/devpilot devpilot_status '{}'
```

## Direct MCP Connection

Endpoint: `https://devpilot--benzsevern.run.tools`

**Optional config:**
- `projectDir` (query) — Path to the project directory (defaults to current working directory)

## Tools (10)

- `devpilot_status` — Check health status of dev server services. Returns live health check results including status, response time, and conf…
- `devpilot_changed` — Report a file change and check if the dev server reloaded successfully. Call this AFTER editing a file. Returns which s…
- `devpilot_run` — Start and manage a dev server process. Spawns the process, captures stdout, detects reload patterns, monitors health, a…
- `devpilot_attach` — Attach to an already-running dev server for health monitoring. Discovers the process by port but does NOT own or restar…
- `devpilot_stop` — Gracefully stop managed dev server services. Only stops services that devpilot started. Never kills processes it didn't…
- `devpilot_init` — Auto-detect project structure and generate .devpilot.yaml config. Scans for pyproject.toml, requirements.txt, and packa…
- `devpilot_up` — Start all services defined in .devpilot.yaml. Reads the project config and starts each service under supervision with a…
- `devpilot_log` — View recent devpilot events including auto-restarts, crashes, recoveries, and escalations.
- `devpilot_cleanup` — Remove stale state entries for processes that are no longer running. Cleans up dead PIDs and orphan service registratio…
- `devpilot_health_check` — Perform a direct health check on any port. Returns healthy/unhealthy status, HTTP status code, and response time. Works…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get benzsevern/devpilot <tool-name>
```