Setup guide

From repo connect to first AI-managed pipeline in under 15 minutes.

No agents to install. No YAML migration. SuperPlane reads your existing pipeline history and activates the AI layer on your first push.

4 steps

How the setup works.

01

Connect your repo

GitHub or GitLab OAuth in one click. SuperPlane reads your pipeline history and test structure. No agents to install on your runners.

superplane connect
$ superplane connect github
Opening GitHub OAuth...
✓ Authorized: your-org/monorepo
Reading pipeline history (last 30 days)...
✓ Found 847 pipeline runs · 12 workflows
02

SuperPlane analyzes your existing config

It maps your current YAML logic, identifies duplication and orphan jobs, shows you what it can own. You see exactly what SuperPlane proposes to manage before anything changes.

superplane analyze
Scanning .github/workflows/ ...
Found 12 workflow files · 47 jobs
AI can own: test selection (12 jobs)
AI can own: env provisioning (8 jobs)
AI can own: canary logic (3 jobs)
Duplication found: deploy.sh called in 6 separate jobs
03

Write your first policy

Replace one YAML file with a 10-line SuperPlane policy. Test selection activates immediately on your next push. You keep your existing CI runner — SuperPlane wraps around it.

superplane.policy.yml (generated)
$ superplane policy init
✓ Generated superplane.policy.yml
Based on your repo's test structure
ai.test-selection: enabled
Review and commit to activate
04

Ship from the policy

SuperPlane runs every subsequent build through its AI layer. You review decisions in the run log. Every choice SuperPlane makes is auditable, exportable, and overridable.

superplane · run #1 with AI
✓ Policy loaded: superplane.policy.yml
✓ Test selection: 34 / 189 tests selected
✓ Env provisioned: staging-us-east-1
✓ Canary: 5% → 25% → 100% · all clear
Pipeline done · 11 min (was 34 min)
Architecture

What connects where.

SuperPlane doesn't replace your CI runner. It wraps the intelligence around it. Your GitHub Actions / Buildkite / CircleCI keeps running — SuperPlane decides what it runs and when.

GitHub GitLab push event SuperPlane AI decision layer select · provision · rollout Your CI Runner Actions · Buildkite · CircleCI Kubernetes Terraform Datadog
Common questions

Technical questions answered.

No. SuperPlane wraps around your existing CI runner — GitHub Actions, Buildkite, CircleCI, Jenkins. It adds the intelligence layer on top. Your current runner still executes the jobs. SuperPlane decides which jobs to run, which environment to provision, and when to promote or roll back. You don't migrate away from what you have.
SuperPlane never reads your source code. It reads commit metadata (file paths changed, author, branch) and test result history (pass/fail per test per run). From that, it builds a dependency graph: which file changes tend to trigger which test failures. The model is trained on your own pipeline history — no source code, no AST, no static analysis. You opt into a 30-day history window in your policy.
Every rollback decision is logged with its full rationale — the specific metric that crossed your threshold, the threshold value, and the timestamp. You can review, override, and re-deploy via the CLI or dashboard. If SuperPlane rolled back incorrectly (e.g., a flaky external dependency caused a transient spike), you can mark the run and SuperPlane adjusts its model for that signal. Decisions are auditable and can be exported.
Use superplane policy validate to lint your policy file locally before committing. superplane run dry-run shows you exactly what SuperPlane would do on a given commit without executing anything. The run log in the dashboard explains every AI decision in plain language — not just what was done, but why, with the specific input data that drove the decision.
No. SuperPlane never stores source code. The only data that passes through SuperPlane's systems is: commit metadata (SHA, file paths, author), test result summaries (pass/fail counts per suite, not test body content), and pipeline event data (timing, env configuration). All tokens are encrypted at rest. See our Security page for the full data handling model.

See it in action

See the first pipeline decision your AI makes.