GoRunner docs
Search or askSearch⌘K

Fix failing workflows with Keel

Keel reads the failed run, tests a fix against its data, and drafts the change for you.

3 min · Cloud and Self-hosted

You need

Keel awake
An owner or admin adds an Anthropic or OpenAI key in Settings › Organization › Keel. Until then Keel says Keel is asleep. See Set up Keel.

Fix a failed run

  1. Open the failed run, from Runs or from the workflow.
  2. Press Fix with Keel in the run’s bar. Keel opens beside the run and says Fixing and the step’s name.
  3. Wait for the card. You can close Keel meanwhile: it keeps working, and says Keel’s fix is ready when it is done.
  4. Read the card, then press Apply. The fix is saved to the draft.
  5. In the Next box, press Publish…, then Run again. The failed run goes through on the fix.

The step on the canvas says what Keel proved: tested against this run, worked, still fails, or not tested against this run.

Note Keel never runs a step that sends something, such as an email, on its own. It asks first with a Run test card.

Can Keel explain the error without fixing it?

Yes. Press Explain this error under the error. Keel says what went wrong and offers to test a fix.

What if my role can’t apply or publish?

An operator or viewer can ask Keel, but can’t apply. An operator can’t publish either. Keel names who can: an editor or admin of the workspace.

Other ways in

In Keel
Type /fix for the latest failed run, or # to pick one.
In Runs
Under Needs you, Failed, grouped by cause: press Fix with Keel on a group.

Let Keel watch a workflow

Turn on Maintenance mode in the workflow’s Settings. When runs keep failing the same way, Keel opens a maintenance conversation, tests what it safely can against the failed run, and drafts the fix.

It needs
The most Keel may do set to Full, the default, in Settings › Organization › Keel. Below Full, Keel never starts on its own.
When it starts
After 3 failures of the same kind within 30 minutes. One failure never starts it.
How often
At most 3 fixes for one workflow a day.
What changes
Only the draft. The card may say Keel applied this to the draft by itself. Production runs the published version until someone publishes.
Where to read it
In the Keel conversations of the workflow’s creator, as Maintenance: and the workflow’s name, and as Keel offered a fix in the audit log.

Checked against 12d85b3b