Omniscio

GitHub Commit Linking

GitHub Commit Linking watches the commits of your connected repositories and attaches each commit that mentions a Mission Control item to that item. The item's Links tab shows the short SHA, the commit message and an author marker, so you can see what code moved for a piece of work.

On this page

What it is

GitHub Commit Linking is the commit-side sibling of PR linking. Every five minutes Omniscio asks GitHub for the newest commits of each connected repository, reads each commit message for item references such as MC-42, and records a link from the matching item to the commit.

The link carries the commit's short SHA, its message and an author marker. Author names are pseudonymized before they reach the database — a deterministic first-initial-plus-suffix form — so the item shows that two commits came from the same person without storing that person's real name.

The feature is a GitHub switch in Settings → Lab (githubCommitLinkingEnabled) and, like PR linking, follows the Mission Control checklist's GitHub answer.

Where to find it

  • Settings → Lab → GitHub Commit Linking turns the scanner on and off.
  • A Mission Control item's Links tab lists linked commits under "Commits"; each row opens the commit on GitHub.
  • Settings → GitHub holds the account the scanner reads with, and the connected projects provide the repositories it watches.

How it behaves

What it scans

The scanner reads each repository's commit list through the shared GitHub client, 100 commits at a time, and remembers the newest commit date it has seen per repository so the next poll only walks new history. Commit messages are capped at 10,000 characters and each commit can contribute at most 20 item references, so one noisy commit cannot flood a board.

A reference only becomes a link when its number resolves to a live item on a board you can see. Re-reading a commit updates the existing row rather than creating a second one.

What an item shows

A linked commit contributes a row to the item's Links tab:

  • the short SHA (seven characters) as the clickable label,
  • the commit message as the summary line,
  • an author marker built from the pseudonymized name.

Links arrive through IPC.PM_ITEM_LINKS_CHANGED, so an open board updates without a reload.

Privacy and limits

The commit author is stored only as the pseudonymized form (J. (ab12) style), with the raw git name dropped at the boundary. The scanner uses the same deadline, burst cap and rate-limit reporting as every other GitHub read; a rate-limited or failed tick is logged and skipped rather than retried in a loop.

How boards, items and sharing work is described in mission-control.md and mission-control-part-2.md. The pull-request half of the same bridge is github-pr-linking.md. Every other page in this library is listed in INDEX.md.

Last verified 2026-11-10