MCPcopy
hub / github.com/superplanehq/superplane

github.com/superplanehq/superplane @v0.27.0 sqlite

repository ↗ · DeepWiki ↗ · release v0.27.0 ↗
32,803 symbols 113,899 edges 4,109 files 2,211 documented · 7%
README

SuperPlane

SuperPlane is an open source automation engine for AI-driven engineering.

It lets you orchestrate engineering workflows across the tools you use — such as Git, LLMs, CI/CD, observability, incident tools, and infrastructure — with durable execution, approvals, and operational UI.

SuperPlane executes your processes deterministically, providing the exact guardrails both humans and AI need to safely interact with your systems.

SuperPlane screenshot

Project status

CI Status on Semaphore GitHub commit activity Discord server

SuperPlane is in beta. Self-host the core engine (installation guide) or use SuperPlane Cloud for managed runners and one-click app installs. Core primitives and integrations are maturing; breaking changes are possible. Report issues on GitHub.

What it does

SuperPlane orchestrates your existing stack into git-backed apps with durable execution — workflows too complex for a single script or CI job.

  • Apps: A deployable unit combining a workflow graph, custom console UI, app-scoped memory, and deterministic execution. Versioned in git (canvas.yaml, console.yaml); defines guardrails for AI agents and human operators.
  • Event-driven orchestration: Multi-step workflows across your Git, CI/CD, observability, incident tools, and notifications — triggered by webhooks, schedules, and tool events, with approvals, policy checks, and human-in-the-loop steps.
  • Console dashboards: Define your own per-app operational UI as a dynamic grid of panels. Use it to display KPIs, tables, charts, runbooks, pinned nodes, and workflow controls, backed by live data from memory, runs, and executions.
  • Agents & operators: Built-in per-app agent to design workflows and debug runs; CLI and skills for external coding agents. Same RBAC on all paths.

How it works

  • Canvases: A graph of steps and their dependencies; a single canvas can express multiple workflows and run them concurrently.
  • Components: Each node is a trigger or action, built-in or integration-backed that performs a specific task (for example: deploy a service, open an incident, post a notification, wait for a condition, require approval, etc.).
  • Events & triggers: Incoming events match triggers and start runs with the event payload as input.
  • Runs & durable execution: Runs, run items, and payloads are tracked across restarts; failed steps can resume without custom retry logic.
  • Memory: App-scoped JSON storage that persists across runs.

Example use cases

A few concrete things teams build with SuperPlane:

  • PR preview environments: on pull request, provision an ephemeral environment, run tests, and post the live URL back to the PR.
  • Policy-gated production deploy: when CI finishes green, hold outside business hours, require on-call + product approval, then trigger the deploy.
  • Progressive delivery (10% → 50% → 100%): deploy in waves, wait/verify at each step, and rollback on failure with an approval gate.
  • Release train with a multi-repo ship set: wait for tags/builds from a set of services, fan-in once all are ready, then dispatch a coordinated deploy.
  • “First 5 minutes” incident triage: on incident created, fetch context in parallel (recent deploys + health signals), generate an evidence pack, and open an issue.

Quick start

Local (demo container):

docker pull ghcr.io/superplanehq/superplane-demo:stable
docker run --rm -p 3000:3000 -v spdata:/app/data -ti ghcr.io/superplanehq/superplane-demo:stable

Open http://localhost:3000.

Cloud: Sign up at app.superplane.com (cloud beta overview).

For a guided first workflow, see the quick start guide.

Supported Integrations

SuperPlane integrates with the tools you already use. Each integration provides triggers (events that start workflows) and components (actions you can run).

View the full list in our documentation. Missing a provider? Open an issue.

AI & LLM

Claude Claude Cursor Cursor OpenAI OpenAI Perplexity Perplexity

Version Control & CI/CD

Bitbucket Bitbucket CircleCI CircleCI GitHub GitHub GitLab GitLab Harness Harness Octopus Deploy Octopus Deploy Render Render Semaphore Semaphore

Cloud & Infrastructure

AWS ECR AWS ECR AWS Lambda AWS Lambda AWS CodeArtifact AWS CodeArtifact AWS CloudWatch AWS CloudWatch AWS SNS AWS SNS
GCP Cloud Build GCP Cloud Build GCP Cloud Functions GCP Cloud Functions GCP Compute GCP Compute Cloudflare Cloudflare DigitalOcean DigitalOcean
DockerHub DockerHub Hetzner Cloud Hetzner Cloud Azure Azure Oracle Cloud Infrastructure OCI Coolify Coolify

Observability

DataDog DataDog Dash0 Dash0 Grafana Grafana

Extension points exported contracts — how you extend this code

Widget (Interface)
* * Widgets are used to represent every node not event or execution related. * Use it to display and group data in the [522 …
pkg/core/widget.go
Action (Interface)
Action executes one superplane_app action value. [429 implementers]
pkg/agents/agent_tools/actions/registry.go
Command (Interface)
(no doc) [503 implementers]
pkg/cli/core/command.go
Service (Interface)
(no doc) [10 implementers]
pkg/usage/service.go
Encryptor (Interface)
(no doc) [4 implementers]
pkg/crypto/encryptor.go
EmailService (Interface)
(no doc) [4 implementers]
pkg/services/email.go
GroupManager (Interface)
Group management interface [1 implementers]
pkg/authorization/interface.go
Client (Interface)
Client is the interface used by Cloud DNS components to call the API. [1 implementers]
pkg/integrations/gcp/clouddns/client.go

Core symbols most depended-on inside this repo

Errorf
called by 9328
pkg/logging/tackle_logger.go
Equal
called by 9164
web_src/src/lib/exprEvaluator.ts
Run
called by 5430
pkg/core/component.go
Error
called by 2354
pkg/core/integration.go
Set
called by 1681
pkg/core/metadata.go
Conn
called by 868
pkg/database/connection.go
String
called by 857
pkg/grpc/actions/canvases/changesets/changeset.go
String
called by 731
pkg/installation/repo.go

Shape

Function 14,068
Method 13,531
Struct 3,736
Interface 1,411
Class 26
TypeAlias 22
FuncType 9

Languages

Go77%
TypeScript23%

Modules by API surface

pkg/integrations/aws/ec2/client.go219 symbols
pkg/integrations/digitalocean/client.go209 symbols
pkg/integrations/jira/client.go182 symbols
pkg/integrations/cloudflare/client.go123 symbols
pkg/integrations/gcp/compute/list_resource_handler.go101 symbols
test/support/contexts/contexts.go93 symbols
pkg/integrations/oci/client.go93 symbols
pkg/integrations/gcp/compute/create_vm.go92 symbols
web_src/src/hooks/useCanvasData.ts81 symbols
pkg/integrations/grafana/client.go76 symbols
test/e2e/shared/canvas_steps.go71 symbols
web_src/src/pages/app/mappers/grafana/types.ts70 symbols

Dependencies from manifests, versioned

cloud.google.com/go/authv0.18.1 · 1×
cloud.google.com/go/auth/oauth2adaptv0.2.8 · 1×
cloud.google.com/go/compute/metadatav0.9.0 · 1×
filippo.io/edwards25519v1.1.1 · 1×
github.com/Azure/azure-sdk-for-go/sdk/azcorev1.13.0 · 1×
github.com/Azure/azure-sdk-for-go/sdk/azidentityv1.7.0 · 1×
github.com/Azure/azure-sdk-for-go/sdk/internalv1.10.0 · 1×
github.com/AzureAD/microsoft-authentication-library-for-gov1.2.2 · 1×
github.com/aws/aws-sdk-go-v2v1.41.1 · 1×
github.com/aws/smithy-gov1.24.0 · 1×
github.com/bmatcuk/doublestar/v4v4.6.1 · 1×
github.com/bradleyfalzon/ghinstallation/v2v2.17.0 · 1×

Datastores touched

analyticsDatabase · 1 repos
defaultdbDatabase · 1 repos
superplane_devDatabase · 1 repos

For agents

$ claude mcp add superplane \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact