Simple Hellodocs
Open app

GitHub integration

The GitHub integration lets you:

  • Browse pull requests and issues from linked repos on a project page.
  • Link a flow node to a specific PR or issue so the diagram reflects real-world work.

Phase 1 is read-only — no writes back to GitHub from Simple Hello.

What you need

  • A GitHub account with access to the repos you want to link.
  • A personal access token (classic) with the repo scope.

Create one at github.com/settings/tokens — repo is needed even for public repos because the PR listing API uses it.

Step 1 — Connect the team

The PAT lives on the team, so do this once and every project on the team inherits it.

  1. Open the team page from the sidebar (Teams → [your team]) and switch to the Integrations tab.
  2. On the GitHub card, click Connect.
  3. Paste your personal access token.
  4. Hit Continue.
Screenshot pending
Connect GitHub dialog — token input + 'Create one at github.com/settings/tokens' helper link.

The dialog verifies the token by listing your repos. If it fails, double- check the repo scope and try regenerating the token.

Step 2 — Link repos to a project

Each project on the team picks which repos to surface. You can link multiple repos to the same project.

  1. Open the project and switch to the GitHub tab.
  2. Click Link repos.
  3. Search the list (it shows every repo your token can access), tick the ones you want, and hit Link repos.
Screenshot pending
Link repos dialog — search box + scrollable checkbox list. Private repos show a small lock icon.

Already-linked repos appear pre-checked and disabled, with an "already linked" label so you don't accidentally re-link them.

What you'll see

On the project page

The GitHub tab lists every PR across the linked repos, with state (draft / open / merged / closed) colour-coded.

Screenshot pending
Project → GitHub tab. PR list grouped by repo, each row showing title, author, state badge.

There's a separate Issues view at the same level for repository issues.

Inside a flow node

Open any node in the editor and the right-hand inspector includes Issue and PR pickers (visible once the project has at least one GitHub repo linked).

Pick one, and the node renders a tiny status-coloured badge next to its title — green for open, purple for merged, etc.

Screenshot pending
Flow editor with one node selected. Inspector shows PR picker (dropdown listing PRs from linked repos). Node on canvas shows a merged-PR badge.

Click the badge to open the PR on GitHub in a new tab.

Managing the connection

  • Reconnect — rotate the PAT by clicking Reconnect on the team's GitHub card. The repo links you've already set up stay in place; only the credentials change.
  • Unlink a repo — on the project's GitHub tab, remove individual repos without disconnecting the team-level integration.
  • Disconnect the team — disconnecting on the team removes the PAT and unlinks all repos from every project on the team. You'll need to redo the project-level linking after reconnecting.

Roadmap

The current build uses a per-team PAT, which means the connection is tied to whoever generated the token. A future phase will swap PATs for a GitHub App so the team can install it once and survive token rotations.