---
name: devserver
description: "Dev server process management with port allocation and health checks"
version: "0.1.0"
entry: ./adapter.ts
npm_deps:
  required: []
  optional: []
fields: []
health_check: null
keywords:
  - service
  - devserver
  - process
  - port
  - health
---

Manage dev server processes (Vite, Nuxt, Next, etc.) with automatic port
allocation, health checks, log capture, and optional git worktree isolation.

## Operations

| Operation | Access | Description |
|-----------|--------|-------------|
| `start` | write | Spawn a dev server process |
| `register` | write | Track an externally started process |
| `stop` | write | Stop an instance |
| `restart` | write | Restart a managed instance |
| `status` | read | Check instance health |
| `logs` | read | Get recent stdout/stderr |
| `list_instances` | read | List all tracked instances |
| `free_port` | read | Allocate a port from the pool |

## Configuration

```yaml
connectors:
  - id: dev
    adapter: devserver
    access: read-write
    options:
      port_range: [3000, 3099]
```