GitHub Integration

Connect Zenflow to GitHub for repository management and pull requests.

Overview

Zenflow integrates with GitHub to streamline your development workflow. Connect your repositories, create pull requests directly from tasks, and sync status across platforms.

Connecting to GitHub

1. Open project settings

   Go to Project → Settings → Integrations.

2. Click Connect GitHub

   Authorize Zenflow to access your GitHub account.

3. Select repositories

   Choose which repositories Zenflow can access. You can grant access to all repos or select specific ones.

4. Confirm permissions

   Zenflow requests:

   • Read access to code and metadata
   • Write access to create branches and PRs
   • Webhook access for status updates

Features

Clone from GitHub

When creating a new project, you can clone directly from GitHub:

1. Click New Project → Clone from GitHub
2. Select the repository
3. Choose the local directory
4. Zenflow clones and sets up the project

Create Pull Requests

When a task is complete:

1. Open the task’s context menu (⋯)
2. Click Create PR
3. Review the PR title and description (pre-filled from task)
4. Select target branch
5. Create the pull request

Zenflow pushes the task branch and opens the PR on GitHub.

PR Status Sync

Zenflow syncs PR status back to tasks:

GitHub Status	Task Status
PR Open	Review
PR Merged	Completed
PR Closed	Archived (optional)

Automated Workflows

Trigger Zenflow tasks from GitHub events:

• Issue created: Auto-create a Fix Bug task
• PR comment: Re-run agents with new instructions
• Review requested: Notify in Zenflow inbox

Authentication Options

OAuth (Recommended)

Standard GitHub OAuth flow—sign in with your GitHub account and authorize Zenflow.

Personal Access Token

For fine-grained control or organizations with OAuth restrictions:

1. Generate a token at GitHub → Settings → Developer settings → Personal access tokens
2. Required scopes: repo, workflow
3. Enter the token in Project → Settings → GitHub

GitHub App (Enterprise)

Organizations can install the Zenflow GitHub App for centralized access control:

• Admin manages permissions
• No individual tokens needed
• Audit logging for compliance

Repository Settings

Configure per-repository behavior:

Setting	Description
Default branch	Base for new tasks (usually main)
Branch prefix	Naming pattern for task branches
Auto-push	Push branches automatically
PR template	Default description template

Troubleshooting

Can't see my repository

Verify that your GitHub connection has access to the repository. For organization repos, an admin may need to grant access.

PR creation fails

Check that:

• The task branch has commits
• You have write access to the repository
• The target branch exists
• There are no GitHub branch protection conflicts

Webhook not triggering

Zenflow webhooks may be blocked by:

• Firewall rules
• GitHub organization settings
• Network connectivity issues

Check Project → Settings → Integrations for webhook status.

Next Steps

MCPs

Connect additional tools via MCP

Project Configuration

Configure automation settings