Skip to main content
GitHub

At a glance

Cogno plugs into the repositories your team already works in. Connect GitHub and Cogno reads pull requests, issues, and commits as they happen, turns them into proposed tasks, and can carry out actions like merging a PR you’ve approved — without pulling you out of your normal workflow.

Before you start

  • You can open Settings in the target workspace.
  • You can install a GitHub App on the target organization (or an org owner can approve it).
  • You know which repositories Cogno should watch.

Connect GitHub in Cogno

1

Open the GitHub integration

Open Settings → Integrations and select GitHub.
2

Install the GitHub App

Click Install GitHub App. Cogno opens GitHub’s installation screen in a new window.
3

Approve on GitHub

Choose the organization and approve the app. On GitHub you can grant all repositories or pick specific ones.
4

Confirm the organization

Back in Cogno, the organization appears under Organizations. Connect more with Add Organization.

Choose repositories

1

Open the organization

Select the organization to open its detail page.
2

Sync the repo list

Under Repositories, click Sync Repos to pull the list from the GitHub App installation.
3

Select and save

Tick the repositories Cogno should watch, then click Save Selected Repos.
Only selected repositories send events to Cogno.

Map GitHub members to workspace members

Under User Mappings, click Sync Users to pull the organization’s members, then map each GitHub member to the matching Cogno member. This attributes GitHub activity to the right person.

What Cogno does with GitHub

Review pull requests from a task

When a task has an open pull request, use Review under GitHub work to submit a comment, approve, or request changes. If a reviewer requests changes, Cogno summarizes the feedback on the task and loads the complete live list of unresolved inline threads when you open Review threads, so every thread can be replied to or resolved in context. Use Comment on diff to load the pull request’s changed files, select an added, removed, or context line, and post a new inline comment. This is the direct path for giving the coding AI an exact file-and-line implementation instruction. Cogno checks the pull request’s latest head commit again before every review write. Inline comments are also checked against the live diff. If the PR changed after the task loaded, refresh the GitHub state and review the new head before submitting.
Reviews, replies, and thread resolution are posted as the connected Cogno GitHub App. Pull request authors cannot approve their own pull requests, so an App-created PR must be approved by a human reviewer. GitHub repository rules also determine whether an App approval satisfies required-review protection.

Manage or remove

  • Manage on GitHub opens the app’s installation settings on GitHub.
  • Remove Integration removes the connection and all synced data (repositories and member mappings) for that organization.
Removing an organization deletes its synced repos and member mappings from the workspace. You can reconnect anytime from the integrations page.

Common states

Reference URLs