forge
Clone forge-starter
plane: controlresource: DevServerneeds Dockerrendered from forge v1.56.0 platform-model.json

run-dev-server

Start, stop or inspect the dev server (docker compose up / down / ps); vault secrets are injected on start.

RunDevServerPOST /capabilities/run-dev-server
DevServerthe Resource it produces
2 eventsDevServerStarted · DevServerStopped

Ask your agent forge → run-dev-server

you
Run hello.
claude
forge → run-dev-server Done — DevServer created; I recorded DevServerStopped.

From the terminal

$ forge dev --app hello [--stop | --status]

HTTP :3717

POST /capabilities/run-dev-server
Content-Type: application/json
x-forge-actor-type: builder
x-forge-actor-id: cli

{
  "app": "hello",
  "action": "start"
}

Input fields 4

app
platform
framework
action

Events ForgeEvent

DevServerStarted   resource_type: DevServer
DevServerStopped   resource_type: DevServer

Resource GET /resources/DevServer/:id

{
  "type": "DevServer",
  "id": "res_01J…",
  "app_id": "app_hello",
  "status": "succeeded",
  "created_at": "2026-09-03T14:00:00Z"
}

Errors: see Reference → Errors. Find it in the playground