tarn_scaffold
Generate a minimal .tarn.yaml skeleton from OpenAPI operation, curl, method+URL, or a recorded fixture. Returns YAML with metadata and optionally writes to disk.
Instructions
Generate a minimal .tarn.yaml skeleton from one of four input modes (OpenAPI operation id, raw curl, method+url, or a recorded fixture). Returns the rendered YAML plus structured metadata (TODOs, inferred request, validation). Optional out writes the file to disk. Equivalent to: tarn scaffold --from-openapi / --from-curl / --method+--url / --from-recorded.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| curl | No | Payload for mode=curl. Provide either `command` (inline) or `file` (path to read). | |
| cwd | No | Absolute path to the project root. Defaults to the workspace root captured during MCP `initialize`, or the server process's current directory. | |
| explicit | No | Payload for mode=explicit. | |
| force | No | Allow overwriting an existing `out` path. | |
| format | No | When `out` is set, write YAML (default) or the JSON metadata block. | |
| mode | Yes | Input mode. Must match the payload object provided. | |
| name | No | Override the inferred top-level `name:` field. | |
| openapi | No | Payload for mode=openapi. | |
| out | No | Write the scaffold to this path (relative paths resolve against `cwd`). Refuses to overwrite unless `force=true`. | |
| recorded | No | Payload for mode=recorded. |