Skip to content

WarpFix Documentation

Everything you need to install, configure, and use WarpFix — the AI-powered CI auto-repair platform for GitHub.

Getting Started

WarpFix monitors your GitHub repositories for CI failures and automatically generates fix PRs. It works with any language, any framework, and any GitHub Actions workflow.

How it works

  1. Install the WarpFix GitHub App on your repositories
  2. When a CI workflow fails, WarpFix receives the webhook
  3. AI reads the error logs, classifies the failure, and generates a patch
  4. The patch is validated in a Docker sandbox environment
  5. If confidence is high enough, WarpFix opens a PR with the fix
2 min
Setup time
30s avg
Time to fix PR
0 config
Works out of the box

Installation

Step 1: Connect GitHub

Visit warpfix.org and click "Connect GitHub". This authorizes WarpFix via GitHub OAuth.

Step 2: Install the GitHub App

Install the WarpFix GitHub App on your repositories. You can install it on all repos or select specific ones.

Permissions required: Read access to code, metadata, actions. Write access to pull requests, issues, checks.View full permissions list →

Step 3: Done

WarpFix starts monitoring immediately. The next time a CI workflow fails, you'll get an auto-fix PR. No configuration file needed — WarpFix works with zero config.

Configuration

WarpFix works without any configuration. Optionally, create a .warpfix.yaml in your repo root to customize behavior.

# .warpfix.yaml — WarpFix configuration
version: 1

repair:
  auto_fix: true                  # Enable automatic fix PRs
  confidence_threshold: 0.75      # Minimum AI confidence to open PR (0.0-1.0)
  max_retries: 2                  # Max repair attempts per failure
  sandbox_timeout: 300            # Sandbox validation timeout (seconds)

quality_gates:
  min_confidence: 0.8             # Block PRs below this confidence
  require_tests: true             # Require test pass in sandbox
  max_patch_lines: 50             # Max lines changed per fix
  block_on_security: true         # Block fixes with security concerns

review:
  auto_comment: true              # Comment on existing PRs with analysis
  severity_labels: true           # Add severity labels to issues
  mermaid_diagrams: true          # Include architecture diagrams
  effort_estimates: true          # Estimate fix effort in hours

ignore:
  paths:
    - "node_modules/**"
    - "dist/**"
    - "*.lock"
  errors:
    - "ECONNRESET"                # Ignore transient network errors
    - "rate limit"                # Ignore rate limiting

notifications:
  slack:
    channel: "#ci-repairs"
    on_repair: true
    on_failure: true
  email:
    to: "team@yourcompany.com"
    on_security: true

Quality Gates

Set minimum confidence scores, required test coverage, and maximum patch complexity for auto-approval of fix PRs.

Ignore Rules

Skip specific paths, file patterns, or error types that you don't want WarpFix to auto-repair.

CLI Commands

Trigger WarpFix actions from PR comments or the dashboard.

fix-ci

Trigger an auto-repair for a failing CI workflow.

Usage: @warpfix fix-ci or /fix-ci in PR comments

fix-tests

Fix broken test cases. Analyzes test output, identifies root cause, generates targeted patches.

Usage: @warpfix fix-tests

fix-deps

Resolve dependency conflicts. Detects version mismatches, lockfile issues, and breaking updates.

Usage: @warpfix fix-deps

predict-failure

Analyze PR diffs before CI runs. Warns about likely failures based on historical patterns.

Usage: @warpfix predict-failure

repair-last

Show the most recent repair — patch details, confidence score, validation status.

Usage: @warpfix repair-last

PR Chat Commands

Mention @warpfix in any PR comment to trigger AI analysis.

@warpfix explain

Get a detailed explanation of why a specific code change was made in a repair PR.

@warpfix security

Run a security analysis — checks for CVEs, OWASP issues, and unsafe patterns.

@warpfix test

Generate test cases for new or modified code in the PR.

@warpfix refactor

Get refactoring suggestions — cleaner patterns, performance improvements.

@warpfix performance

Analyze performance implications — algorithmic complexity, memory usage, bottlenecks.

Dashboard Features

Your WarpFix dashboard at warpfix.org/dashboard provides:

CI Brain

AI-powered analytics showing failure patterns, trends, and predictions across all repos.

Failure Genome

Fingerprint and categorize every CI failure. See which error types affect your codebase most.

Autopsy Reports

Automated incident postmortems for every CI failure with root cause analysis.

Flaky Test Detection

Identify unreliable tests that pass/fail inconsistently across runs.

PR Reviewer

AI-powered code review with severity labels, security checks, and refactoring suggestions.

Org Stability Score

Real-time health score across all repositories measuring CI reliability.

Predictive Failures

Analyze PR diffs and predict likely CI failures before the workflow runs.

Dependency Radar

Track outdated, vulnerable, or breaking dependencies across all repos.

Network Intelligence

Cross-repository pattern detection — learn from fixes in similar codebases.

Org Memory

Persistent knowledge base of past failures and fixes for faster future repairs.

Free Developer Tools

WarpFix offers 15 free developer tools at warpfix.org/tools — no signup required.

Interactive Tools (12)

Programmatic Content Pages

Integrations

GitHub Actions

Native integration — WarpFix listens to workflow_run webhooks. No extra CI config needed.

Live

Slack

Get repair notifications, review summaries, and failure alerts in your channels. Configure in dashboard or .warpfix.yaml.

Live

Webhooks

Send repair events to any HTTP endpoint — integrate with PagerDuty, Datadog, or custom dashboards.

Live

GitLab CI

GitLab CI/CD integration for auto-repair of GitLab pipelines.

Roadmap

CircleCI

CircleCI integration for cross-platform CI monitoring.

Roadmap

Plans & Billing

Free

$0/month

  • 3 auto CI repairs / month
  • 1 connected repo
  • Community support
Popular

Pro

$12/month

  • Unlimited auto CI repairs
  • Unlimited repos
  • CI Brain analytics
  • Failure fingerprinting
  • Flaky test detection
  • Auto PR reviews

Team

$36/month

  • Everything in Pro
  • Up to 10 team members
  • Org stability score
  • Network intelligence
  • Priority support

Manage your plan at Dashboard → Billing. Payments processed via Dodo Payments.

Troubleshooting

WarpFix isn't creating fix PRs

Verify the GitHub App is installed on the repo (Settings → GitHub Apps). Check that your plan has remaining repair credits. Ensure the workflow uses 'workflow_run' event.

Fix PR has low confidence score

WarpFix may not open a PR if confidence is below your threshold. Check .warpfix.yaml confidence_threshold setting. Complex multi-file errors may need manual review.

Repair was incorrect

Close the PR and leave feedback. WarpFix learns from rejected fixes. You can also adjust quality gates in .warpfix.yaml to require higher confidence.

Webhook not receiving events

The webhook URL is https://api.warpfix.org/webhooks/github. Verify in your GitHub App settings that the webhook is active and the secret matches.

How do I uninstall WarpFix?

Go to GitHub Settings → Applications → WarpFix → Configure → Uninstall. Your WarpFix account and data will be retained for 30 days.

Need help?

Reach out at support@warpfix.org or open an issue on GitHub.