fix-runbook

Synopsis

npx @refrainai/cli fix-runbook -- \
  --runbook <path> \
  --report <path> \
  [options]

Reads an execution report (generated by --self-heal or --report), extracts AI repair suggestions, and interactively applies them to the runbook YAML.

Required arguments

Argument	Description
`--runbook <path>`	Path to the runbook YAML file to patch
`--report <path>`	Path to the execution report (Markdown)

Optional arguments

AI model

Argument	Default	Description
`--model <id>`	`claude-sonnet-4-6`	AI model ID
`--model-provider <provider>`	`anthropic`	AI provider
`--model-base-url <url>`	-	Base URL for OpenAI-compatible endpoints

Advanced

Argument	Default	Description
`--locale <code>`	`en`	UI language: `en` or `ja`

How it works

Extract suggestions

AI reads the report and extracts actionable repair suggestions.

Review each suggestion

For each suggestion, you can choose to apply, skip, or abort.

Generate patches

AI generates YAML patches and shows a diff preview.

Confirm and write

After confirmation, the patched runbook is written to disk.

Examples

Basic usage

First, run a self-heal execution to generate a report:

npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --self-heal \
  --report

Then apply the repair suggestions:

npx @refrainai/cli fix-runbook -- \
  --runbook ./login-flow.yaml \
  --report ./login-flow-report.md

Environment variables

Variable	Description
`AI_MODEL_ID`	Default for `--model`
`AI_MODEL_PROVIDER`	Default for `--model-provider`
`REFRAIN_LOCALE`	Default for `--locale` (`en` or `ja`)

Getting Started

Workflow Guides

Use Cases

Support

Web Console

CLI Reference

SDK

Runbook YAML

Concepts

Synopsis

Required arguments

Optional arguments

AI model

Advanced

How it works

Examples

Basic usage

Environment variables

​Synopsis

​Required arguments

​Optional arguments

​AI model

​Advanced

​How it works

​Examples

​Basic usage

​Environment variables

Synopsis

Required arguments

Optional arguments

AI model

Advanced

How it works

Examples

Basic usage

Environment variables