GitHub Integration

Clacky’s GitHub integration enables seamless collaboration between your workspace and GitHub repositories. This integration allows you to manage repositories, track issues, create pull requests, and leverage GitHub Actions directly from your Clacky environment.

Connection Setup

Follow these steps to connect Clacky with your GitHub account:

1. GitHub OAuth Authorization

Clacky connects to GitHub using OAuth:

1. Click “Create Project”, select “GitHub”, and follow the authorization process
2. You’ll be redirected to GitHub’s authorization page
3. Review the requested permissions (see Required Permissions section)
4. Click “Install”
5. You’ll be redirected back to Clacky after successful authorization

2. Repository Selection

1. After successful authorization, you’ll see a list of your GitHub repositories
2. Select a repository to connect
3. Clacky will automatically create a project and clone the repository for you
4. The connection will be established with the permissions you granted during OAuth

Required Permissions

Clacky requests these GitHub permissions:

• Read: access to commit statuses and metadata
• Read and write: access to administration, code, issues, and pull requests

Troubleshooting

Connection Issues

If you’re experiencing connection problems:

1. Verify your GitHub authorization hasn’t expired
2. Check that you haven’t revoked Clacky’s access from your GitHub settings
3. Ensure your network allows connections to GitHub
4. Try disconnecting and reconnecting the integration

Permission Denied

If you receive “Permission denied” errors:

1. Check that you’ve granted the necessary OAuth scopes during authorization
2. Verify you have appropriate access to the repository in GitHub
3. For organization repositories, ensure organization admins have approved Clacky

Repository Not Found

If repositories are missing from the list:

1. Make sure you have access to the repository in GitHub
2. For organization repositories, check if you’ve granted organization access
3. Try searching for the repository by name or URL
4. Verify the repository exists and hasn’t been deleted or renamed

Frequently Asked Questions

Can I connect multiple GitHub accounts?

Currently, Clacky supports one GitHub account connection per workspace. If you need to switch accounts, disconnect the current one before connecting a new one.

Is my GitHub access secure?

Yes, Clacky uses industry-standard OAuth for GitHub authentication. You can review and revoke access at any time through your GitHub settings.

How do I disconnect my GitHub account?

You can revoke Clacky’s access in your GitHub settings under Applications