Specbench

Connecting to source control

Install the GitHub App and bind projects to repositories

Specbench connects each project to a git repository. Your organization installs the Specbench GitHub App on its GitHub account, then each project binds to one of the permitted repositories.

Once a project is connected, publishing a Task's spec writes the whole published spec to that repository and opens a pull request over it — see Publishing the spec.

On app.specbench.io the GitHub App is Specbench's own, preconfigured — there's nothing to register. A self-hosted Instance acts through a GitHub App you register yourself; set that up first — see the GitHub App — and the rest of this page applies unchanged.

Install the App

In the app, Integrations (organization level) installs the App on a GitHub account — GitHub asks which repositories to permit. Installing needs GitHub-side rights on that account; GitHub will say so if you don't have them.

Connect a project

Each project's Settings → Git pane binds the project to one of the permitted repositories: pick the repository, keep or change the branch (main) and output path (.specbench), and optionally set commit and PR message templates. Publishing uses all of these.

On this page