VCS providers

Cascade auto-detects which VCS your repo is hosted on from the git origin URL and opens the PR on the right service.

Supported

Provider	Self-hosted	Default base URL
GitHub	Yes (GitHub Enterprise via `--base-url`)	`https://api.github.com`
GitLab	Yes (cloud + self-hosted)	`https://gitlab.com`
Bitbucket Cloud	Cloud only in v0.1	`https://api.bitbucket.org/2.0`
Azure DevOps Repos	Yes	`https://dev.azure.com`

Setup

GitHub

cascade configure vcs github --token ghp_xxx

Token needs repo scope. Create one at https://github.com/settings/tokens.

For GitHub Enterprise:

cascade configure vcs github --token ghp_xxx --base-url https://github.acme.com/api/v3

GitLab

# gitlab.com
cascade configure vcs gitlab --token glpat-xxx

# Self-hosted
cascade configure vcs gitlab --token glpat-xxx --base-url https://gitlab.acme.io

Token needs api scope. Create one at your GitLab profile settings.

Bitbucket Cloud

# Using an App Password (recommended)
cascade configure vcs bitbucket --token "your_username:your_app_password"

# Using a workspace token
cascade configure vcs bitbucket --token your_workspace_token

App Passwords need write access to “Pull requests”.

Azure DevOps

cascade configure vcs azure_devops --token your_pat --organization myorg

PAT needs Code (Read & Write) and Pull Request Threads (Read & Write) scopes.

How auto-detection works

When cascade build runs, it reads the repo’s git remote get-url origin and parses the URL. The hostname determines the provider:

URL pattern	Detected as
`github.com/owner/repo`	GitHub
`gitlab.com/group/project` or any URL containing `gitlab`	GitLab
`bitbucket.org/team/repo`	Bitbucket
`dev.azure.com/org/project/_git/repo`	Azure DevOps

Both HTTPS and SSH origin URLs are recognized.

Forcing a specific provider

If you have a non-standard URL or your repo is mirrored, you can override the provider in ~/.config/cascade/config.yaml:

defaults:
  vcs_provider: gitlab

PR description content

Cascade writes a structured PR description that includes:

The story title and description
All acceptance criteria
A list of every file changed with the reason
Test command, result, and summary
Attribution back to Cascade with the story ID and source

The format renders well on every supported VCS.

Coming in v0.2

Bitbucket Server (Data Center) support
Gitea / Codeberg support
Merge request comment loop (Cascade reads review comments and iterates)