Overview
The GitHub connector lets you link your GitHub account to Workshop using a Personal Access Token. Once connected, you can access repositories, analyze code, clone repos, and perform API operations through natural conversation.This is different from GitHub Integration. The GitHub connector gives the Workshop agent API access to your repositories and issues via a Personal Access Token. GitHub Integration is the app-level feature for push/pull syncing between your Workshop project and a GitHub repo — it uses a GitHub App OAuth flow, not a PAT.
What You’ll Need
Creating a Personal Access Token
1
Open GitHub settings
Sign in to github.com, click your profile photo, and select Settings.
2
Navigate to developer settings
Scroll down the sidebar and click Developer settings > Personal access tokens > Fine-grained tokens.
3
Generate a token
Click Generate new token. Enter a Token name (e.g., “Workshop Access”), set an Expiration date, and choose the Resource owner (your account or an organization).
4
Set repository access
Under Repository access, select which repositories the token can access.
5
Set permissions
Under Permissions, grant the access you need:
- Contents: Read (to view files)
- Metadata: Read (required for all tokens)
- Issues: Read and write (if you want Workshop to create/manage issues)
- Pull requests: Read and write (if you want Workshop to create PRs)
6
Copy the token
Click Generate token and copy it immediately. GitHub only shows the token once.
Organization tokens may require approval. If you select an organization as the resource owner, the organization may need to approve the token before it becomes active. Check with your organization administrator if the token isn’t working.
Connecting to Workshop
1
Open the Hub
Open the Workshop Hub from the sidebar.
2
Go to Connectors
Click the Connectors tab.
3
Select GitHub
Click the GitHub card.
4
Enter details
Enter a Connection Name (e.g., “My GitHub Account”) and paste your Personal Access Token.
5
Save
Click Add Connection.
Using Your Connection
Once connected, you can ask Workshop to work with your GitHub data:Security Best Practices
- Use fine-grained tokens with the minimum permissions needed
- Set an expiration date on all tokens
- Create separate tokens for different integrations
- If you suspect a token is compromised, revoke it immediately in GitHub Settings > Developer settings > Personal access tokens