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

build

next build in Docker; the standalone output is parsed into the Build resource.

BuildPOST /capabilities/build
Buildthe Resource it produces
3 eventsBuildStarted · BuildSucceeded · BuildFailed

Ask your agent forge → build

you
Build hello.
claude
forge → build Done — Build created; I recorded BuildFailed.

From the terminal

$ forge build --app hello

HTTP :3717

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

{
  "app": "hello"
}

Input fields 3

app
platform
framework

Events ForgeEvent

BuildStarted   resource_type: Build
BuildSucceeded   resource_type: Build
BuildFailed   resource_type: Build

Resource GET /resources/Build/:id

{
  "type": "Build",
  "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