Connecting Integrations

Zero0 integrates with your version control system, your tracker (Jira or Azure DevOps), and your messaging platform (Slack or Microsoft Teams) to fit into your existing workflow. A VCS provider (GitHub, GitLab, or Bitbucket) is required; a tracker and a messaging platform are optional but recommended for the full experience.

You can connect integrations during onboarding or at any time from Settings → Integrations.

GitHub​

GitHub is connected via a GitHub App. Zero0 uses it to read your codebase, create branches, commit code, and open pull requests.

Connecting to Git​

1. Navigate to Settings → Integrations → GitHub
2. Click Connect to Git
3. A popup opens on GitHub — select the organization or user account
4. Choose repository access:
   • All repositories — grants access to every repo in the org
   • Select repositories — pick specific repos
5. Click Install & Authorize
6. The popup closes and your connection status updates

Configuring Execution Repositories​

After connecting, you need to select which repositories the AI agent can work in:

1. In the GitHub integration page, find the Execution Repositories section
2. Select the repositories where you want the AI to create branches and PRs
3. Click Save

These are the repos that appear as options when you create a story on the Board. You can change this list at any time.

Configuring Base Branches​

For each execution repository, you can configure which base branch the AI uses when creating feature branches. By default, Zero0 looks for branches in this order: develop → dev → main → master. You can override this per repository in the GitHub settings or when creating a story.

For more details, see the GitHub Integration admin page.

GitLab​

GitLab is connected via OAuth. Zero0 uses it to read your codebase, create branches, commit code, and open merge requests in your GitLab projects.

Connecting via OAuth​

1. Navigate to Settings → Integrations → GitLab
2. Click Connect to Git
3. A popup opens to GitLab's OAuth authorization screen
4. Grant Zero0 access to your GitLab.com group
5. The popup closes and your connection status updates, displaying your group name

Configuring Execution Repositories​

After connecting, you need to add projects for AI execution:

1. In the GitLab integration page, browse the Projects table
2. Use Search to filter projects by name, and pagination controls to navigate large lists
3. Click + Add next to a project to register it for AI execution — this also registers a webhook on the project
4. Click Unuse to remove a project from the execution list

Only projects added for execution appear as options when creating stories on the Board.

Excluded Paths​

If your group contains projects you don't need (archived repos, forks, internal tooling), you can hide them:

1. Open the Excluded Paths section
2. Type a path prefix (e.g., my_group/archived) and press Enter
3. Projects matching any excluded prefix are hidden from the list
4. Click Save to apply

For more details, see the GitLab Integration admin page.

Bitbucket​

Bitbucket is connected via OAuth. Zero0 uses it to read your codebase, create branches, commit code, and open pull requests in your Bitbucket Cloud repositories.

Connecting via OAuth​

1. Navigate to Settings → Integrations → Bitbucket
2. Click Connect to Git
3. A popup opens to Bitbucket's OAuth authorization screen
4. Grant Zero0 access to your Bitbucket Cloud account
5. The popup closes and your connection status updates

Configuring Your Workspace​

After connecting, you need to set your workspace before repositories are listed:

1. In the Repositories section, find the Workspace slug field
2. Enter your workspace slug — the first path segment of your repository URLs (e.g., for bitbucket.org/zero0ai/my-repo, the workspace slug is zero0ai)
3. Click Save

Once the workspace is saved, the repository list populates automatically.

Configuring Execution Repositories​

After configuring your workspace, select which repositories the AI agent can work in:

1. Open the Execution Repositories section
2. Use the multi-select dropdown to choose repositories from your workspace
3. Click Save to apply changes, or Discard to revert unsaved selections

Only selected repositories appear as options when creating stories on the Board.

For more details, see the Bitbucket Integration admin page.

Jira​

Jira integration syncs stories between your Jira backlog and the Zero0 Board.

Connecting via OAuth​

1. Navigate to Settings → Integrations → Jira
2. Click Connect Jira
3. Sign in to your Atlassian account in the popup
4. Authorize Zero0 to access your workspace
5. Your Jira domain appears once connected (e.g., your-team.atlassian.net)

Setting Up the Webhook​

The webhook allows Jira to notify Zero0 when issues change:

1. In the Jira integration page, copy the Webhook URL
2. In Jira, go to Settings → System → WebHooks
3. Create a new webhook:
   • Name: Zero0
   • URL: paste the URL from step 1
   • Events: check Issue Created, Issue Updated, Issue Deleted
4. Back in Zero0, generate and save the webhook secret

Adding Required Statuses​

Zero0 uses custom Jira statuses to track the execution pipeline. Add these statuses to your Jira projects:

Status	Category	Description
Enriched	In Progress	Story analyzed, spec generated
Product Approved	In Progress	Spec approved, ready for decomposition
Ready For Dev	In Progress	Subtasks created, implementation starting
Validation	In Progress	PRs created, awaiting review

You can use the Jira Project Statuses audit tool in Settings (admin only) to check which projects have these statuses configured and auto-create any that are missing.

Azure DevOps​

Azure DevOps integration syncs work items between your Azure DevOps Boards organisation (cloud, dev.azure.com) and the Zero0 Board. The recommended way to connect is as the Zero0 app.

1. Navigate to Settings → Integrations → Azure DevOps
2. Click Connect as the Zero0 app (recommended)
3. Follow the setup steps: approve Zero0 in Microsoft Entra, choose your organisation, add Zero0 to the organisation, and allow it to manage service hooks
4. Click Finish connecting

See the Azure DevOps guide for the full steps, or the onboarding guide if you are setting up for the first time.

Slack​

Slack enables notifications when stories need attention and supports interactive Q&A during story analysis.

Connecting Your Workspace​

1. Navigate to Settings → Integrations → Slack
2. Click Connect Slack
3. Select your Slack workspace in the popup
4. Authorize Zero0

Once connected, Zero0 can:

• Send direct messages when stories need your input (e.g., Q&A questions)
• Notify you when PRs are ready for review
• Alert you when execution completes or fails

Without a Messaging Platform​

If you skip the Slack or Microsoft Teams integration, all interactions happen directly on the Zero0 Board. Q&A questions appear in the story detail panel, and you can monitor status through the kanban view.

Microsoft Teams​

Microsoft Teams offers the same notifications and Q&A as Slack. Zero0 messages people through one platform, either Slack or Microsoft Teams.

1. Navigate to Settings → Integrations → Teams
2. Click Connect Microsoft Teams and grant admin consent as a Microsoft 365 administrator
3. Download the Teams app and have a Teams admin upload it to your organization's app catalog

See the Microsoft Teams guide for the full steps, including how to choose Teams as your messaging platform.

Verifying Your Setup​

After connecting your integrations, verify everything is working:

1. VCS provider: Check that your repositories (or projects, for GitLab) appear in the execution repos list
2. Jira (if connected): Verify the webhook secret is saved and the domain is displayed
3. Azure DevOps (if connected): Verify the setup checks pass and the service hooks show as healthy
4. Slack or Microsoft Teams (if connected): Confirm the workspace or tenant name appears on the integration page

You're now ready to create your first AI story.