Documentation

Get AetherCI running in under 5 minutes. Connect your CI/CD tools, and let AI diagnose your pipeline failures.

Quick Start

How It Works

AetherCI sits between your CI/CD platforms and your team. Here's the flow:

1. Webhook event arrives — Your CI/CD platform sends a webhook when a build, deploy, or workflow runs. AetherCI normalizes the event regardless of platform.
2. Context gathering — AetherCI pulls additional context: recent commits, logs, configuration files, dependency changes, and security data (if Snyk/Veracode is connected).
3. AI analysis — Claude analyzes the failure with all available context. It identifies the root cause, suggests specific fixes, and rates its confidence.
4. Action — From the analysis, you can create a GitHub/Linear issue, generate a fix PR, or copy the analysis to share with your team.

All data is scoped to your organization using Row-Level Security. Your data is never shared with other customers or used to train AI models.

Your First Analysis

After connecting an integration and receiving your first failure event:

1. Navigate to Projects and select your project
2. In the Events tab, find the failed event (marked with a red indicator)
3. Click the event to open the detail panel
4. Click Analyze Event
5. Analysis runs in the background — you can navigate freely while it processes
6. When complete, you'll see the root cause, suggested fixes, and confidence score

Supported Integrations

AetherCI connects to 15+ platforms across your DevOps stack. Each integration receives events via webhooks and provides context for AI analysis.

GitHub Integration

Setup

1. In AetherCI, go to Integrations → GitHub
2. Enter your GitHub Personal Access Token (with repo scope for private repos, or public_repo for public only)
3. Enter the repository in owner/repo format
4. Click Save — AetherCI generates a webhook URL
5. In GitHub, go to Settings → Webhooks → Add webhook
6. Paste the webhook URL, set content type to application/json
7. Select events: Workflow runs, Deployments, Push

What GitHub provides

• Workflow run events — triggers on every GitHub Actions run (success or failure)
• Code context — recent commits, changed files, branch info
• Issue creation — create GitHub issues directly from analysis results
• Fix PRs — AI generates a fix and opens a pull request in your repo

Netlify Integration

Setup

1. In AetherCI, go to Integrations → Netlify
2. Enter your Netlify Personal Access Token (from Netlify User Settings)
3. Enter your Site ID (found in Site Settings → General)
4. Click Save — AetherCI generates a webhook URL
5. In Netlify, go to Site Settings → Build & deploy → Deploy notifications
6. Add an Outgoing webhook for: Deploy started, Deploy succeeded, Deploy failed
7. Paste the AetherCI webhook URL for each event

What Netlify provides

• Deploy events — success, failure, and in-progress notifications
• Build logs — full build output for AI context
• Deploy metrics — success rate, deploy time, error rates

Render Integration

Setup

1. In AetherCI, go to Integrations → Render
2. Enter your Render API Key (from Render Dashboard → Account Settings)
3. Enter your Service ID (starts with srv-, found in your service's settings)
4. Click Save — AetherCI generates a webhook URL
5. In Render, go to Service Settings → Notifications
6. Add a webhook with the AetherCI URL, selecting deploy events

What Render provides

• Deploy events — build started, live, failed
• Service metrics — memory usage, CPU, error rates, latency
• Deploy logs — build output for root cause analysis

Azure DevOps Integration

Setup

1. In AetherCI, go to Integrations → Azure DevOps
2. Enter your Personal Access Token, Organization, and Project
3. Click Save — AetherCI generates a webhook URL
4. In Azure DevOps, go to Project Settings → Service Hooks
5. Create a new webhook subscription for Build and Release events
6. Paste the AetherCI webhook URL

What Azure DevOps provides

• Build pipeline events — triggered on build completion
• Work item context — linked work items for traceability
• Repository context — code changes and branch info

Sentry Integration

Setup

1. In AetherCI, go to Integrations → Sentry
2. Enter your Sentry Auth Token, Organization Slug, and Project Slug
3. Click Save — AetherCI generates a webhook URL
4. In Sentry, go to Settings → Integrations → Webhooks
5. Add the AetherCI webhook URL and select Issue and Error events

What Sentry provides

• Error context — stack traces, breadcrumbs, and environment info enrich AI analysis
• Issue correlation — connect runtime errors to deployment failures

AI Analysis

AetherCI uses Claude by Anthropic to analyze pipeline failures. When you trigger an analysis, here's what happens:

1. The failure event is enriched with context from all connected integrations — logs, code changes, config, security data
2. Claude analyzes the combined context and identifies the most likely root cause
3. It generates specific, actionable fix suggestions with confidence scores
4. Results are displayed in the analysis panel with options to create issues or PRs

Each analysis includes:

• Root cause — what went wrong and why
• Suggested fixes — numbered, actionable steps to resolve the issue
• Confidence score — how certain the AI is (higher = more context available)
• Security context — vulnerability data from Snyk/Veracode if connected

Pattern Detection

AetherCI identifies recurring failure patterns across your project's history. The Pattern Insights tab shows:

• Recurring issues — failures that keep happening with the same root cause
• Systemic problems — infrastructure or process issues causing multiple failure types
• Known patterns — recognized failure signatures that can be auto-classified
• Cost impact — estimated engineering time and cost of recurring failures
• Process improvements — actionable suggestions to reduce failure frequency

Run a pattern analysis from the Pattern Insights tab in any project. It analyzes your last 90 days of failure data.

Anomaly Predictions

AetherCI monitors trends in your deployment metrics and predicts failures before they happen. Predictions include:

• Failure type — what's likely to break
• Severity — Critical, High, Medium, or Low based on estimated time to failure
• Estimated time — how many hours until the predicted failure
• Recommended actions — preventive steps to avoid the failure
• Confidence score — prediction reliability based on available data

Predictions run automatically on a 6-hour cycle when metrics data is available from your integrations.

Pipeline Optimization

AI analyzes your CI/CD pipeline configuration and suggests optimizations:

• Build speed — caching strategies, parallelization, unnecessary steps
• Cost reduction — resource rightsizing, build minutes optimization
• Reliability — retry strategies, timeout configurations, flaky test handling
• Security — secrets management, dependency pinning, supply chain hardening

Each recommendation can be applied with one click via Create PR — AetherCI generates the code change and opens a pull request in your repo.

Webhook Security

Every integration in AetherCI gets a unique webhook URL with a cryptographic token. Incoming webhooks are validated before processing:

• Token verification — each webhook URL contains a unique token tied to your integration
• Signature validation — for platforms that support it (GitHub, Sentry), AetherCI verifies HMAC signatures
• Rate limiting — webhook endpoints are rate-limited to prevent abuse
• Credential encryption — API keys and tokens are encrypted at rest using AES-256

See our Security page for full details on data handling and compliance.

Billing & Quotas

AetherCI offers four tiers:

• Free — 10 analyses/month, 1 project, 1 VCS integration
• Team ($99/mo) — 200 analyses/month, 10 projects, all integrations
• Business ($349/mo) — 800 analyses/month, 50 projects, priority support
• Enterprise — unlimited, BYOK, SSO/SAML, custom SLA

Annual billing saves 17%. Overages are billed at $0.75/analysis (Team) or $0.50/analysis (Business). See Pricing for full details.

Manage your subscription in Settings → Billing within the app.

Support

Need help? Here's how to reach us:

• Email: support@aetherci.com
• In-app: Use the Support page in the sidebar for guided help
• GitHub: File issues at github.com/aetherci-hq

Business and Enterprise customers receive priority support with guaranteed response times.