Skip to main content

GitHub integration

GitHub is most useful in ClarityLoop when pull requests and review work are important evidence of contribution. The goal is not to mirror engineering activity for its own sake. It is to make meaningful code work easier to reference in feedback, goals, and performance conversations.

What GitHub helps with​

Use GitHub when you want to bring strong technical examples into ClarityLoop, especially:

  • notable pull requests
  • collaboration visible in review cycles
  • concrete delivery examples that support feedback or growth conversations

Who sets it up​

Workspace owners connect GitHub for the workspace.

How to connect GitHub​

  1. Open Workspace Settings > Integrations.
  2. Find GitHub.
  3. Choose Add to GitHub.
  4. Complete the GitHub app installation flow for the org or repositories you want connected.

Once connected, ClarityLoop can add its pull request action to new PRs if the workspace keeps PR Quick Action enabled.

How people use it​

The best use of GitHub in ClarityLoop is selective:

  • attach important PRs to feedback or growth conversations
  • use real code work as context in 1:1s and goals
  • refer to specific delivery examples instead of relying on vague summaries

You do not need every PR in ClarityLoop. A few strong examples are usually more useful than a noisy stream of activity.

How ClarityLoop uses GitHub data​

  • Automatic context: supported GitHub flows can bring PR details and review collaboration into ClarityLoop context so recent work, feedback opportunities, and growth signals are grounded in shared engineering work.
  • Manual linking: people can also attach a PR explicitly when writing feedback, preparing a 1:1, responding to a request, or linking work to a goal.

Set it up well​

  • install the GitHub app where the relevant repositories actually live
  • keep PR Quick Action enabled if you want the Add to ClarityLoop entry point on new PRs
  • keep GitHub and ClarityLoop identity details aligned where possible for cleaner attribution

FAQs​

Who can install GitHub?

Only workspace owners can connect it for the workspace.

Can it work with private repositories?

Yes, as long as the GitHub app is installed with access to the repositories you want connected.

What happens if we disable PR Quick Action?

GitHub can stay connected, but the Add to ClarityLoop action will no longer be shown on new pull requests.

Should we attach every PR?

No. Use GitHub context when it adds evidence, clarity, or useful examples.

Next steps​