GitHub

Features

Sidebar panel (administrators only)#

• Repositories: every repository of your GitHub account (and your starred ones, if you choose), followed or not by the GitHub integration. Each followed one shows its stars, open issues, open pull requests and latest release on its row, and unfolds the same details as the GitHub Card (counters, latest release, commit, pull request, issue…). The head gives the totals of the followed repositories, and your GitHub account (followers, following, public repositories and gists) closes the list. Follow or Stop following one, tick several and Follow selected, or Follow all at once: the whole change reloads the GitHub integration a single time
• Issues and Pull requests: the open ones of all the followed repositories, most recently updated first, with their repository, number, author, age, comments and labels, and the review state of pull requests (approved, changes requested, review required, draft); filter by repository; each opens on GitHub
• Settings: the repositories offered (name patterns such as juju35/ha-*, starred repositories, archived repositories ignored), and a Home Assistant notification for each new issue, pull request or release
• Tabs in the address (/github-config/issues), so a link or a reload opens the same tab

Cards#

• A full GitHub Card and a compact GitHub Mini Card, loaded on every dashboard by the integration (no resource to add)
• One foldable section per repository, with its stars, open issues and open pull requests at a glance: one unfolded at a time, folded again on a click elsewhere (a single repository is always unfolded)
• Stars, forks, watchers, open issues, open pull requests, merged pull requests, discussions and downloads of the latest release
• Latest release, tag, commit, pull request, issue and discussion, each with a link to its page on GitHub
• The account: followers, following, public repositories and gists
• Status pill: the open issues and pull requests of the repositories shown, or "Nothing open"; while the integration follows no repository, the cards say so, with a button to the GitHub integration
• Zoom on the mini card: a button at the top right switches it to the full card and back; a click on a repository opens the full card on it
• Choose the repositories and their order, or sort them by name, stars or open issues and pull requests
• Visual editor in the dashboard UI for every card (no YAML needed)

Everywhere#

• Light and dark mode, English, French, German, Spanish, Serbian (Cyrillic and Latin), Italian, Dutch, European Portuguese, Polish, Romanian, Danish, Swedish, Bulgarian, Russian, Ukrainian, Hungarian, Slovak, Czech, Slovenian, Latvian and Greek
• No dependency: vanilla JavaScript, and Python with Home Assistant only

Supported integrations

Prerequisites

Home Assistant 2026.11 or later, and the GitHub integration added with your GitHub account (Settings → Devices & services → Add integration → GitHub). Repositories can then be followed from the panel. The account sensors (followers, following, public repositories and gists) are disabled by default: enable them on the device of your GitHub account to show the Account section of the cards.

Panel

The GitHub entry of the sidebar, for administrators only.

Repositories#

The list comes from the GitHub integration's own Add repository form: your repositories and your starred ones, read with its token. By default only the repositories of your account are offered; Settings can add your starred ones, keep only names matching patterns (juju35/ha-*, home-assistant/*) and, with Ignore archived repositories, leave out the archived ones (read from the GitHub API with the GitHub integration's token, kept 10 minutes; if GitHub cannot be queried, nothing is hidden). Followed repositories are always listed.

The list is sorted with the menu next to the search field: followed first (default), by name, or the followed repositories by stars, open issues or open pull requests (the choice is remembered in the browser). Each followed repository shows its live counters on its row (stars, open issues, open pull requests, latest release); a click on its name unfolds the GitHub Card's details of that repository under the row, one repository at a time.

Follow adds the repository to the GitHub integration exactly as its Add repository form does (a "repository" entry). The GitHub integration reloads whenever its repositories change, so the panel makes the whole change at once: Follow all with 40 repositories reloads it once, not 40 times. Its sensors are unavailable for a few seconds meanwhile. Stop following asks first: the repository's sensors and their history are removed from Home Assistant.

Issues and pull requests#

The GitHub integration only has counts and the latest issue and pull request of a repository. The full lists come from the GitHub GraphQL API, with the access token of the GitHub integration (sent to api.github.com only, never to the browser): one query for 20 followed repositories at a time, at most 50 open issues and 50 open pull requests per repository, kept for 5 minutes. Refresh asks GitHub again.

Notifications#

With Notify new issues, Notify new pull requests or Notify new releases in Settings, a Home Assistant notification shows each new issue, pull request or release of a followed repository (one per repository and kind, replaced by the next), with its link. They come from the GitHub integration's Latest issue, Latest pull request and Latest release sensors, refreshed by the GitHub integration itself: a higher number is a new issue or pull request, another tag a new release (a sensor back from unavailable says nothing new).

Cards

Visual editor#

Edit a dashboard, click Add card and search for GitHub Card or GitHub Mini Card. Set an optional title, pick the repositories, the sort order, the sections to display and the language. The preview updates live, and options left at their default are kept out of the generated YAML.

Minimal#

type: custom:github-card

type: custom:github-mini-card

Full options#

type: custom:github-card
title: My projects
repositories:
  - home-assistant/core
  - juju35/ha-parcel
sort: stars
show_latest: true
show_account: true
language: fr

type: custom:github-mini-card
title: My projects
sort: open
max_repos: 5
show_latest: true
show_account: true
zoom: true
language: fr

Options reference#

How it works

The cards read the entity and device registries of Home Assistant and keep the sensors of the github platform. The integration creates one device per repository, named after its full name (owner/repo), and one for the account, named after its login; each sensor is recognized by its translation key (stargazers_count, issues_count, latest_release…), so entity ids translated in another language and renamed entities are supported. When the registry gives no translation key, the end of the English entity id is used instead (sensor.home_assistant_core_stars).

The counts of the GitHub integration are the open issues and pull requests. The latest release, commit, pull request, issue and discussion come with the link of their page on GitHub (the arrow at the end of the row); a click elsewhere on the row opens the sensor's history.

Mini card#

The compact card shows the totals of the repositories shown (stars, forks, open issues, open pull requests), then one line per repository with its stars, open issues and open pull requests, and the overall status at the bottom. At the far right of the header, a small round button (mdi:arrow-expand) shows the full card in its place, with the same options, and turns into mdi:arrow-collapse to bring the compact view back; a click on a repository shows the full card with that repository unfolded; a click anywhere outside the card brings the compact view back too, but not a click in a dialog opened from it (more-info). zoom: false removes the button, and a click on a repository then opens the history of its stars.

Support

If you find this project useful, you can support its development:

Features

• Panel, Repositories: a checkbox on each repository not followed yet, and Follow selected (n) in the head follows the ticked ones together (one reload of the GitHub integration). The selection stays while searching, so repositories found by different searches can be followed at once.

Features

• Panel, Settings: Ignore archived repositories leaves the archived repositories out of the ones offered in the Repositories tab (and out of Follow all). Whether a repository is archived is read from the GitHub API with the GitHub integration's token, kept 10 minutes; followed repositories are always listed.

Features

• show_title and show_subtitle options (also in the visual editor) hide the header's title and its subtitle, separately, for a card placed under a section heading of its own (asked in juju35/ha-vehicle-card#72).

Performance

• Panel opens faster: the repositories offered by the GitHub integration (read from the GitHub API by its Add repository flow at each opening) are kept 10 minutes, dropped as soon as the followed repositories change, and panels opened together share one read.
• Panel: the repositories, settings and issues load alongside the GitHub Card instead of waiting for it (only the account and the unfolded repository need the card).
• Issues and pull requests: the GitHub queries (20 repositories each) run side by side instead of one after another.

Improvements

• Panel: a failed load shows a Retry button next to its error (it is tried again on its own meanwhile), without No repository matches under it.

Fixes

• Panel sometimes empty when opened: a load that failed (Home Assistant still starting after a restart or an update, the connection coming back after the app resumed) left the repositories and settings empty until the page was reloaded. It is now tried again after 2 s, 5 s, 15 s, then every 30 s while the panel is shown, and again as soon as the connection is back.