Apply Fixes

Overview

The fix-runbook command takes a self-heal diagnostic report and applies AI-generated repair suggestions to your runbook. Each suggestion is presented for review before applying.

Prerequisites

A self-heal diagnostic report (generated by --self-heal)
The original runbook that was used during self-heal

Workflow

Generate a self-heal report

Run the runbook with --self-heal to produce a diagnostic report:

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

The report is saved as {runbook-name}-report.md (e.g., login-flow-report.md).

Run fix-runbook

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

Review each suggestion

For each AI suggestion, the command shows:

The error and its classification category
The proposed fix (selector change, step modification, etc.)

For each suggestion, choose:

Apply — Generate a patch and preview the diff
Skip — Move to the next suggestion
Abort — Stop processing remaining suggestions

Verify the fixed runbook

After applying fixes, run a normal execution to verify:

npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --context ./context.md \
  --headless false

CLI reference

Argument	Required	Description
`--runbook <path>`	Yes	Path to the runbook to fix
`--report <path>`	Yes	Path to the self-heal report
`--model <id>`	No	AI model for patch generation (default: `claude-sonnet-4-6`)
`--model-provider <provider>`	No	AI provider (default: `anthropic`)
`--locale <code>`	No	UI language: `en` or `ja`

Getting Started

Workflow Guides

Use Cases

Support

Web Console

CLI Reference

SDK

Runbook YAML

Concepts

Overview

Prerequisites

Workflow

CLI reference

What’s next

Self-heal mode

Error classification

​Overview

​Prerequisites

​Workflow

​CLI reference

​What’s next

Self-heal mode

Error classification

Overview

Prerequisites

Workflow

CLI reference

What’s next