devpin

devpin

devpin helps agents reuse an existing managed dev server instead of starting duplicate servers across sessions.

Install

pnpm add -D devpin

Use

Start by asking devpin how this repo should be handled:

devpin guide

Common flow:

devpin status
devpin run --wait
devpin url
devpin logs --tail 100
devpin stop

If the project has no configured dev command:

devpin run --wait -- pnpm run dev

Configure

{
  "devpin": {
    "command": ["pnpm", "run", "dev"],
    "env": {
      "APP_PORT": "{port}"
    },
    "publicUrl": "https://web.localhost"
  }
}

publicUrl is optional. Without it, devpin url returns the local managed URL.

env is optional. Values are passed to the managed command and can use {port}, {host}, {url}, and {root}.

For Portless, mirror devpin's chosen port into PORTLESS_APP_PORT:

{
  "devpin": {
    "command": ["vp", "exec", "portless"],
    "env": {
      "PORTLESS_APP_PORT": "{port}"
    },
    "publicUrl": "https://web.localhost"
  }
}