Overview

Export task breakdowns from Projan plans to GitHub as issues, and import existing issues or pull requests as conversation context for AI grounding.

Prerequisites

• GitHub account with write access to the target repository
• Projan team admin or individual account

Setup Steps

1. Go to Settings > Integrations > GitHub
2. Click “Connect GitHub”
3. Authorize via GitHub’s OAuth consent screen
4. Grant access to the organisations you want to export to

Permissions Requested

Scope	Purpose	Access Level
repo	Read repositories, create and update issues	Read/Write
read:org	List organisations and their repositories	Read

What Data is Accessed

• Repository names and metadata
• Existing issues and pull requests (for context import)
• Issue labels and milestones

Data Storage

• Encrypted access token
• Connected account login

Disconnecting

Go to Settings > Integrations > GitHub > Disconnect.

Token is purged immediately. Previously exported issues remain in GitHub unaffected. You can also revoke the authorisation from GitHub > Settings > Applications.

Troubleshooting

“No repositories found”

• Check that you granted access to the correct organisation during authorisation
• Organisation owners may need to approve third-party OAuth access

Export fails with “Permission denied”

• The connected account needs write access to the target repository

Private repositories not appearing

• The repo scope requires organisation approval for private repositories in some organisations