Skip to main content

GitHub Integration

Sync your tk issues bidirectionally with GitHub Issues. Keep your local Markdown issues in sync with GitHub’s issue tracker.

Setup

1. Create a GitHub Token

Create a Personal Access Token with repo scope.

2. Configure tk

Or use environment variables:

Sync Issues

Pull from GitHub

Import GitHub Issues into tk:
This creates .tickets/ files for each GitHub Issue.

Push to GitHub

Push local tk issues to GitHub:

Bidirectional Sync

Sync both directions:

Mapping


Check Status

View sync status and any conflicts:

Configuration Options


Workflow Example


Troubleshooting

Verify your token has repo scope and is correctly configured:
Check the repo is set correctly:
Format should be owner/repo.
Run tk github status to see conflicts. Resolve by choosing which version to keep.

Next Steps

Linear Sync

Sync with Linear for team workflows.

CLI Reference

Full command documentation.