Skip to main content
GitHub Issues Sync lets you browse your repository’s open issues directly from Claude Board and selectively import them as tasks. Imported tasks get a github tag and link back to the original issue.

​
Prerequisites

Install GitHub CLI

Install gh — Claude Board uses your existing gh authentication, no separate token needed.

Authenticate

Run gh auth login and follow the prompts. Claude Board will automatically use this session.

Configure project

Go to Project Settings > GitHub tab. The repository is auto-detected from your git remote. Enable sync and save.
The setup wizard checks for gh CLI during initial configuration. It’s optional — you can install it later.

​
Browsing Issues

Click the Issues button in the board toolbar to open the GitHub Issues panel on the right side. The panel shows all open issues from your repository with:
  • Issue number and title
  • Body preview (first 200 characters)
  • Labels with color-coded badges
  • Suggested task type based on label mapping
  • Import status — already imported issues are dimmed
Use the refresh button to fetch the latest issues from GitHub.

​
Importing Issues

Select issues

Click individual issues to select them, or use Select all new to select all unimported issues at once.

Import as tasks

Click Import N as tasks. Selected issues are created as backlog tasks with:
  • Title from issue title
  • Description from issue body
  • Task type mapped from labels (see below)
  • github tag automatically applied
  • Link to original GitHub issue

Work on tasks

Imported tasks appear in your backlog. They are NOT auto-queued — you review and start them manually like any other task.

​
Label Mapping

GitHub labels are automatically mapped to Claude Board task types:
GitHub LabelTask Type
bug, fixbugfix
refactorrefactor
documentation, docsdocs
test, testingtest
chore, maintenancechore
(no match)feature

​
Auto-Close on Approve

When you approve a task that was imported from a GitHub issue, the linked issue is automatically closed on GitHub. This keeps both systems in sync without manual work.

​
Task Card Badge

Tasks imported from GitHub show a small badge with the issue number (e.g., #42) on the task card. Clicking the badge opens the original issue on GitHub in a new tab.

​
Check Connection

In Project Settings > GitHub, use the Check Connection button to verify:
StatusMeaning
Connectedgh CLI installed, authenticated, and repo accessible
Not installedgh CLI not found — install from cli.github.com
Not authenticatedRun gh auth login to authenticate
Cannot accessToken doesn’t have access to this repository
Claude Board never stores your GitHub token. It reads it from gh auth token on every request, using your existing CLI session.