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

test

npm test (Vitest) in Docker; pass and fail counts land on the TestRun.

TestPOST /capabilities/test
TestRunthe Resource it produces
3 eventsTestRunStarted · TestRunSucceeded · TestRunFailed

Ask your agent forge → test

you
Run hello's tests.
claude
forge → test Done — TestRun created; I recorded TestRunFailed.

From the terminal

$ forge test --app hello

HTTP :3717

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

{
  "app": "hello"
}

Input fields 3

app
platform
framework

Events ForgeEvent

TestRunStarted   resource_type: TestRun
TestRunSucceeded   resource_type: TestRun
TestRunFailed   resource_type: TestRun

Resource GET /resources/TestRun/:id

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