Integrations

GitHub Integration

Connect your GitHub account to sync issues with board cards — import open issues, create issues from cards, and keep everything in sync.

Connect GitHub Projects & Boards

Setup: 3 steps
Sync: 2-way
Accounts: Multi

What you can do

Three ways GitHub and your boards stay connected.

Import issues

Pull open GitHub issues into your board as cards in one click.

Create from cards

Open a card and spin up a new GitHub issue or link an existing one.

Bi-directional sync

Keep issue status and card position aligned across both systems.

How it connects

From your GitHub account down to individual card ↔ issue links.

Account

OAuth connect

Repository

Linked to board

Board

Kanban workspace

Sync

Cards ↔ issues

Using the hosted app?

GitHub OAuth is already configured at whatthehellhaveidone.net. Skip the self-hosting setup below and jump straight to Connect your account.

Self-hosting — GitHub OAuth App

Required once per server before anyone can connect a GitHub account.

Create an OAuth App

Create a new OAuth App on GitHub, or browse Developer settings → OAuth Apps. See GitHub's OAuth app guide.

Set the callback URL

Set Authorization callback URL to:

https://your-domain.com/github/callback

Copy credentials

Copy the Client ID and generate a Client Secret.

Add to your .env

Add credentials to your environment file:

GITHUB_CLIENT_ID=your_client_id
GITHUB_CLIENT_SECRET=your_client_secret
GITHUB_REDIRECT_URL=https://your-domain.com/github/callback

Reload config

Run php artisan config:clear to pick up the new variables.

Connect your GitHub account

Link one or more GitHub accounts to your user profile.

Open Integrations

Go to Settings → Integrations.

Authorize on GitHub

Click Connect GitHub Account and authorize — you'll be redirected back automatically.

Add more accounts (optional)

Connect multiple GitHub accounts from the same page — useful across personal and org repos.

Link a repository to a board

Choose which repo syncs with which board.

Open board settings

From the dashboard, open a board and click Settings.

Select a repository

Under GitHub Integration, pick a repository from the dropdown.

Connect

Click Connect Repository — the board is ready to import or sync issues.

Working with issues

Import existing issues or create new ones from cards.

Import GitHub issues as cards

Once a repository is connected, click the refresh icon next to the repo name in board settings.

Open issues are imported as cards in the first list of the board — ready to drag through your workflow.

Create a GitHub issue from a card

Open any card and use the GitHub panel to create a new issue or link to an existing one.

The card stays linked so status changes can sync in both directions when webhooks are configured.

Workflow automation

Turn card moves and pull requests into a lightweight GitHub delivery flow.

Read the full GitHub + board workflow guide →

Create issues when work starts

On a column menu (⋯), enable Create GitHub issue on your In Progress column. Moving a card there creates a linked issue when the board has a connected repository.

Choose who works on it

After the move, assign the card to GitHub Copilot or a team member. Team members stay assigned on the board only; auto Copilot review is skipped for them.

Move pull requests into review automatically

In board settings, choose which column receives cards when a linked pull request opens. New boards default this to Review.

Reference the issue in your pull request

Mention the linked issue in the PR title or body with Fixes #12 or #12. The app moves the card automatically, and Copilot review is requested only when the card was assigned to Copilot on move.

Sync direction

Choose how tightly GitHub and your board stay coupled.

Two-way sync

Changes in GitHub reflect on the board and vice versa when webhooks are configured on the repository.

Import only

Pull issues into the board without pushing card changes back to GitHub.

Webhook setup (two-way sync)

For GitHub → board updates, add a repository webhook with this payload URL:

https://your-domain.com/webhooks/github

Connecting a repository registers this webhook for issues and pull_request events. GitHub must be able to reach your app over HTTPS.

See GitHub's webhook documentation for event types, secrets, and delivery settings.

Local testing checklist

Set APP_URL to your public tunnel URL, not localhost.
Expose the app over HTTPS with a tunnel such as ngrok http https://whatthehellhaveidone.test or Herd Share.
Run php artisan queue:work so webhook jobs can process deliveries.
Reconnect the repository in board settings so GitHub picks up the refreshed webhook URL.

Ready to connect?

Link your GitHub account, pick a repo, and import your open issues in under a minute.

Open integrations

Next steps

Projects & Boards

Learn how boards, lists, and cards work.

Connect an AI assistant

Manage cards from Claude or ChatGPT via MCP.

Import from Trello

Migrate existing boards in one click.