Connect your GitHub account to Goodweek to manage repositories, issues, pull requests, and workflows directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within GitHub, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the GitHub integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
The GitHub integration uses OAuth 2.0 and does not require any admin-level approval for personal repositories. However, accessing GitHub organization resources may require additional steps.
⚠️ GitHub Organization OAuth app restrictions
GitHub organizations can restrict which third-party OAuth apps have access to organization data. If your organization has enabled OAuth App access restrictions, a GitHub Organization Owner must approve Composio before users can access organization repositories and resources:
Go to your GitHub organization → Settings → Third-party access → OAuth App policy.
Find the Composio app and click Approve to grant organization access.
This restriction is enabled by default on new GitHub organizations. Without approval, users can connect their personal GitHub account but will not be able to access any organization-owned repositories.
User Connection
In Goodweek, go to Integrations.
Find GitHub and click Connect.
You will be redirected to GitHub, where you will be asked to sign in and authorize access.
Click Authorize to grant access and return to Goodweek.
Important Notes
Each user must connect their own account individually.
Goodweek can only access repositories and resources that your individual GitHub account has permission to see.
Access to organization-owned repositories requires the organization owner to approve Composio as described above.
You can revoke Goodweek's access at any time from GitHub → Settings → Applications → Authorized OAuth Apps → Composio → Revoke.
Available Tools
Tool | Description | Type |
Get a Repository | Retrieves detailed information about a specific GitHub repository. | Read |
List Repositories for User | Lists repositories for a specified user or the authenticated user. | Read |
List Organization Repositories | Lists repositories for a specified GitHub organization. | Read |
Search Repositories | Searches GitHub repositories using GitHub's search syntax. | Read |
Create a Repository | Creates a new GitHub repository for the authenticated user or organization. | Write |
Get Repository Content | Retrieves the contents of a file or directory in a repository. | Read |
Create or Update File Contents | Creates a new file or updates an existing file's content in a repository. | Write |
Get an Issue | Retrieves a specific GitHub issue by repository and issue number. | Read |
List Repository Issues | Lists issues in a repository with optional filtering by state, labels, and assignee. | Read |
Create an Issue | Creates a new issue in a specified repository. | Write |
Update an Issue | Updates an existing issue's title, body, state, labels, or assignees. | Write |
Add Labels to an Issue | Adds one or more labels to a GitHub issue. | Write |
Add Assignees to an Issue | Assigns one or more users to a GitHub issue. | Write |
Create Issue Comment | Adds a comment to an existing GitHub issue. | Write |
List Issue Comments | Lists all comments on a specific GitHub issue. | Read |
Get a Pull Request | Retrieves details for a specific pull request. | Read |
List Pull Requests | Lists pull requests in a repository with optional filtering by state and branch. | Read |
Create a Pull Request | Creates a new pull request from a head branch to a base branch. | Write |
Update a Pull Request | Updates a pull request's title, body, state, or base branch. | Write |
Create a Review Comment on a Pull Request | Adds a review comment to a specific line in a pull request. | Write |
Merge a Pull Request | Merges a pull request into its base branch. | Write |
List Repository Commits | Lists commits in a repository with optional filtering by author, path, or date range. | Read |
Get a Commit | Retrieves details for a specific commit by its SHA. | Read |
List Repository Branches | Lists branches in a specified repository. | Read |
Create a Branch | Creates a new branch in a repository from a specified SHA or branch. | Write |
Get a Workflow Run | Retrieves details about a specific GitHub Actions workflow run. | Read |
List Workflow Runs for a Workflow | Lists workflow runs for a specified workflow with optional status filter. | Read |
Re-run a Workflow | Re-runs all jobs in a specified workflow run. | Write |
Search Code | Searches for code across GitHub repositories using GitHub's code search syntax. | Read |
Search Issues and Pull Requests | Searches GitHub issues and pull requests using GitHub's search syntax. | Read |
Get a User | Retrieves public information for a specified GitHub user. | Read |
Get the Authenticated User | Retrieves the authenticated GitHub user's profile. | Read |
List Organization Members | Lists members of a GitHub organization. | Read |
Close an Issue | Closes a specified GitHub issue. | ⚠️ Destructive |
Close a Pull Request | Closes a specified pull request without merging it. | ⚠️ Destructive |
Delete a File | Deletes a file from a repository. This action is irreversible without version control history. | ⚠️ Destructive |
Use Cases
Create and manage issues from conversations. Log new GitHub issues with title, description, labels, and assignees directly from a Goodweek conversation — useful when capturing bugs or feature requests without switching to GitHub.
Review pull requests and commit history. Retrieve PR details, list recent commits, or check the status of a workflow run from Goodweek to stay on top of repository activity.
Search code and issues across repositories. Use GitHub's search syntax from within Goodweek to find specific code, issues, or PRs across your repositories without opening the GitHub UI.
Create and update files in repositories. Read file contents or push small file updates directly from Goodweek — useful for updating documentation, configuration files, or README content.
Troubleshooting
Connected successfully but organization repositories are missing
Your GitHub organization has OAuth App access restrictions enabled. A GitHub Organization Owner must approve Composio from the organization Settings → Third-party access → OAuth App policy.
Integration not visible in Goodweek
Make sure your organization admin has enabled the GitHub integration from the Goodweek Admin Panel under the Integrations tab.