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
- Install the WarpFix GitHub App on your repositories
- When a CI workflow fails, WarpFix receives the webhook
- AI reads the error logs, classifies the failure, and generates a patch
- The patch is validated in a Docker sandbox environment
- If confidence is high enough, WarpFix opens a PR with the fix
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.
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: trueQuality 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-ciTrigger an auto-repair for a failing CI workflow.
Usage: @warpfix fix-ci or /fix-ci in PR comments
fix-testsFix broken test cases. Analyzes test output, identifies root cause, generates targeted patches.
Usage: @warpfix fix-tests
fix-depsResolve dependency conflicts. Detects version mismatches, lockfile issues, and breaking updates.
Usage: @warpfix fix-deps
predict-failureAnalyze PR diffs before CI runs. Warns about likely failures based on historical patterns.
Usage: @warpfix predict-failure
repair-lastShow 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 explainGet a detailed explanation of why a specific code change was made in a repair PR.
@warpfix securityRun a security analysis — checks for CVEs, OWASP issues, and unsafe patterns.
@warpfix testGenerate test cases for new or modified code in the PR.
@warpfix refactorGet refactoring suggestions — cleaner patterns, performance improvements.
@warpfix performanceAnalyze 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)
CI Error Decoder
AI-powered CI log analysis with root cause and fix suggestions
GitHub Actions Generator
Generate workflow YAML for any language/framework
Flaky Test Analyzer
Detect unreliable tests from CI log comparisons
CI/CD Cost Calculator
Calculate pipeline costs across major CI platforms
GitHub Actions Validator
Validate workflow YAML syntax and best practices
Cron Builder
Visual cron expression editor for Actions schedules
YAML Validator
Validate and format YAML with CI/Docker/K8s presets
Dockerfile Linter
16-rule security and best practices audit
.env Generator
Generate environment variable templates
Build Time Estimator
Estimate CI build duration and optimization
Postmortem Generator
Generate structured incident postmortem docs
CI Health Score
Calculate pipeline reliability score
Programmatic Content Pages
Integrations
GitHub Actions
Native integration — WarpFix listens to workflow_run webhooks. No extra CI config needed.
Slack
Get repair notifications, review summaries, and failure alerts in your channels. Configure in dashboard or .warpfix.yaml.
Webhooks
Send repair events to any HTTP endpoint — integrate with PagerDuty, Datadog, or custom dashboards.
GitLab CI
GitLab CI/CD integration for auto-repair of GitLab pipelines.
CircleCI
CircleCI integration for cross-platform CI monitoring.
Plans & Billing
Free
$0/month
- 3 auto CI repairs / month
- 1 connected repo
- Community support
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.