From 2b59b4723ab6f6dec7cb3bad778b73594db990f1 Mon Sep 17 00:00:00 2001
From: Andrew Anderson
Date: Thu, 29 Oct 2026 22:54:08 -0400
Subject: [PATCH 1/7] =?UTF-8?q?=F0=9F=93=96=20community:=20list=20the=20Tw?=
=?UTF-8?q?itch=20live=20stream=20everywhere=20community=20links=20live?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Adds https://www.twitch.tv/hivecommons (with a shields.io status badge in
the README) next to the Discord link in the README, CONTRIBUTING, community
and getting-started docs, issue-template contact links, dashboard sidebar
Help group / FAQ / Getting Started modal, the /contribute portal and the
default contribute.help_links, and the hub page navs and footers.
Fixes #15635
Signed-off-by: Andrew Anderson
---
.github/ISSUE_TEMPLATE/config.yml | 3 +++
CONTRIBUTING.md | 2 +-
README.md | 6 ++++-
changelog.d/added-twitch-community-links.md | 1 +
docs/getting-started-contributing.md | 1 +
src/README.md | 3 ++-
src/docs/community.md | 5 ++++
src/docs/getting-started.md | 2 +-
src/docs/operator-reference.md | 2 +-
src/docs/security-self-assessment.md | 2 +-
src/docs/streaming-the-activity-monitor.md | 3 ++-
src/pkg/config/contribute_help_links.go | 1 +
src/pkg/config/contribute_help_links_test.go | 9 +++++++
src/pkg/dashboard/contribute_landing.go | 2 +-
src/pkg/dashboard/static-src/html/faq.html | 2 +-
.../dashboard/static-src/html/sidebar.html | 1 +
src/pkg/dashboard/static-src/js/config-hub.js | 2 +-
src/pkg/dashboard/static-src/js/welcome.js | 2 +-
src/pkg/dashboard/static/index.html | 7 +++---
src/pkg/dashboard/twitch_link_test.go | 24 +++++++++++++++++++
src/pkg/hub/server.go | 1 +
src/pkg/hub/static/api-docs.html | 1 +
.../cncf-reference-architecture-bluefin.html | 2 +-
.../cncf-reference-architecture-console.html | 2 +-
.../static/cncf-reference-architecture.html | 2 +-
src/pkg/hub/static/get-started.html | 1 +
src/pkg/hub/static/index.html | 2 ++
src/pkg/hub/static/learn.html | 1 +
src/pkg/hub/static/my-hives.html | 1 +
src/pkg/hub/static/reading.html | 1 +
30 files changed, 77 insertions(+), 17 deletions(-)
create mode 100644 changelog.d/added-twitch-community-links.md
create mode 100644 src/pkg/dashboard/twitch_link_test.go
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index a8afa99dd5..74c8817679 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -9,6 +9,9 @@ contact_links:
- name: Join our Discord
url: https://hivecommons.dev/discord
about: Ask setup, contributor, and community questions in the Hive Commons Discord.
+ - name: Watch the hive live on Twitch
+ url: https://www.twitch.tv/hivecommons
+ about: Live stream of the hosted hive's Activity Monitor — see issues and PRs move through the pipeline in real time.
- name: Propose a project to join Hive Commons
url: https://github.com/hivecommons/.github/issues/new?template=join-hive-commons.yml
about: Project proposals for the Hive Commons family are handled in the hivecommons/.github repository.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index fda1207856..395c2ebdfe 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -2,7 +2,7 @@
Thank you for helping improve Hive. This guide is for contributing code and documentation to this repository. If you want to donate compute to a running hive, see [Contribute to a Hive](src/docs/what-is-hive.md#contribute-to-a-hive) instead.
-**New here?** Start with the [getting-started guide for first-time contributors](docs/getting-started-contributing.md) — it walks the end-to-end journey (finding an issue, local setup, testing without a cluster, key concepts, and what the review/CI process looks like) and links back into this guide for the mechanics. For live community help, [Join our Discord](https://hivecommons.dev/discord).
+**New here?** Start with the [getting-started guide for first-time contributors](docs/getting-started-contributing.md) — it walks the end-to-end journey (finding an issue, local setup, testing without a cluster, key concepts, and what the review/CI process looks like) and links back into this guide for the mechanics. For live community help, [Join our Discord](https://hivecommons.dev/discord). To see a hive at work, [watch the hive live on Twitch](https://www.twitch.tv/hivecommons).
## Where to work
diff --git a/README.md b/README.md
index 8f4a3f6fe6..e531e43189 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,10 @@
Community
+
+
+
+
---
Hive helps people and AI agents work together across their projects.
@@ -134,7 +138,7 @@ Use official images from `ghcr.io/hivecommons/hive`.
## Community
-[First contribution](docs/getting-started-contributing.md) · [Contributing](CONTRIBUTING.md) · [Contribute compute](src/docs/contributor-relay.md) · [Discord](https://hivecommons.dev/discord) · [Discussions](https://github.com/orgs/hivecommons/discussions).
+[First contribution](docs/getting-started-contributing.md) · [Contributing](CONTRIBUTING.md) · [Contribute compute](src/docs/contributor-relay.md) · [Discord](https://hivecommons.dev/discord) · [Live stream (Twitch)](https://www.twitch.tv/hivecommons) · [Discussions](https://github.com/orgs/hivecommons/discussions).
[Code of Conduct](CODE_OF_CONDUCT.md) · [Project governance](GOVERNANCE.md) · [Report a vulnerability](SECURITY.md) · [Telemetry](src/docs/telemetry.md).
diff --git a/changelog.d/added-twitch-community-links.md b/changelog.d/added-twitch-community-links.md
new file mode 100644
index 0000000000..a733d52ff9
--- /dev/null
+++ b/changelog.d/added-twitch-community-links.md
@@ -0,0 +1 @@
+Twitch live stream (https://www.twitch.tv/hivecommons) listed in every community-link cluster: README badge and Community section, CONTRIBUTING, community/getting-started docs, issue-template contact links, dashboard sidebar Help / FAQ / Getting Started modal, the `/contribute` portal and default `contribute.help_links`, and hub landing/status page navs and footers. (#15635)
diff --git a/docs/getting-started-contributing.md b/docs/getting-started-contributing.md
index 8adfdca749..91453f4b79 100644
--- a/docs/getting-started-contributing.md
+++ b/docs/getting-started-contributing.md
@@ -16,6 +16,7 @@ build/test commands, see [`docs/development.md`](development.md).
- Comment on the issue before starting anything non-trivial so work isn't
duplicated.
- Need a quick human answer? [Join our Discord](https://hivecommons.dev/discord).
+- Curious what a running hive looks like? [Watch the hive live on Twitch](https://www.twitch.tv/hivecommons).
## 2. Set up a local environment
diff --git a/src/README.md b/src/README.md
index d8c88ee31d..5deabe53b7 100644
--- a/src/README.md
+++ b/src/README.md
@@ -220,7 +220,8 @@ contributors to act as selected spoke roles with `HIVE_AGENT_ROLE` /
See [docs/contributor-relay.md](docs/contributor-relay.md),
[docs/contributor-trust-and-roles.md](docs/contributor-trust-and-roles.md), and
-[Join our Discord](https://hivecommons.dev/discord) for newcomer questions.
+[Join our Discord](https://hivecommons.dev/discord) for newcomer questions, or
+[watch the hive live on Twitch](https://www.twitch.tv/hivecommons).
## Governor
diff --git a/src/docs/community.md b/src/docs/community.md
index ffa6956e8b..f5a22e1132 100644
--- a/src/docs/community.md
+++ b/src/docs/community.md
@@ -6,8 +6,13 @@ Hive Commons is the open community around Hive, ClankeR contributor relay, and t
For setup help, contributor relay questions, first-run guidance, and community discussion, [Join our Discord](https://hivecommons.dev/discord). The redirect points to the permanent Hive Commons invite and lets us rotate the underlying invite in one place if that ever changes.
+## Watch the hive live on Twitch
+
+Hive's own hosted hive streams its Activity Monitor 24/7 at [twitch.tv/hivecommons](https://www.twitch.tv/hivecommons) — every tracked issue and PR walking from open to merged. See [Streaming the Activity Monitor](streaming-the-activity-monitor.md) for how the stream is run.
+
## Other community entry points
+- [Live stream (Twitch)](https://www.twitch.tv/hivecommons)
- [Hive Commons website](https://hivecommons.dev)
- [Hosted Hive Hub](https://hive.hivecommons.dev)
- [Contributor portal](https://hive.hivecommons.dev/contribute)
diff --git a/src/docs/getting-started.md b/src/docs/getting-started.md
index 2714a1a03e..34d57b5263 100644
--- a/src/docs/getting-started.md
+++ b/src/docs/getting-started.md
@@ -90,7 +90,7 @@ For the following weeks, review findings and improve tests before considering mo
## Community help
-If you get stuck, [Join our Discord](https://hivecommons.dev/discord). The invite is permanent, and the Hive Commons community can help with setup, first-run questions, contributor relay, and choosing a safe next ACMM step.
+If you get stuck, [Join our Discord](https://hivecommons.dev/discord). The invite is permanent, and the Hive Commons community can help with setup, first-run questions, contributor relay, and choosing a safe next ACMM step. To see what a running hive looks like, [watch the hive live on Twitch](https://www.twitch.tv/hivecommons).
## Common gotchas (so you don't panic)
diff --git a/src/docs/operator-reference.md b/src/docs/operator-reference.md
index c0f9c92a27..ab5ac52b25 100644
--- a/src/docs/operator-reference.md
+++ b/src/docs/operator-reference.md
@@ -186,7 +186,7 @@ Top-level YAML keys accepted by `config.Config`:
| `issues.hard_suppress_reconcile_interval` | `30m`. | Minimum time between hard-suppress reconcile passes. |
| `issues.rfc_existing_check.enabled` | `false`. | Triage existing-coverage check (#13575): new open issues labelled `rfc`, `enhancement` or `kind/feature` get one comment that lists the existing settings that may already cover the request. Each setting links to Settings with the search set to its key. The comment carries `` and is never posted twice. The check never labels or closes issues. Tuning keys are `post_when_nothing_found`, `labels`, `max_matches` and `max_age`; see [Triage: does this RFC already exist?](settings.md#triage-does-this-rfc-already-exist). |
| `runs.triage.prior_art.enabled` | `true`. | Prior-art gate (#13575): before any agent claims a feature / RFC / epic issue, the scheduler searches knowledge beads, the Settings index, merged PRs (12 months), closed issues, docs and code for the issue's key terms. A human-filed issue whose best finding reaches `runs.triage.prior_art.threshold` (default `70`) is parked at `stage/017-possible-existing` with one `` comment quoting up to `max_findings` (default `5`) findings and the two replies (`/hive decision proceed — ` / `/hive decision exists`); a clanker-filed one is parked the same way and closed `already-exists` after `bot_close_ttl` (default `72h`) with no reply; a hive-filed one is never parked (findings note only). `kinds` (default `feature, rfc, epic, enhancement`) picks the gated kinds; `max_parks_per_cycle` (default `5`) bounds one cycle. See [Prior-art gate](spektacular.md#prior-art-gate). |
-| `contribute.help_links` | Defaults to Hive contributor docs and the Hive issue tracker. | Up to 5 `{label, url}` links shown on `/contribute` Onboarding, Operations, and printed once by relays on connect. URLs must be absolute `http://` or `https://`; labels are plain text and length-capped. Prefer the Hive Commons Discord redirect (`https://hivecommons.dev/discord`) over channel URLs for contributors who may not already be server members. |
+| `contribute.help_links` | Defaults to Hive contributor docs, the Hive issue tracker, and the Twitch live stream. | Up to 5 `{label, url}` links shown on `/contribute` Onboarding, Operations, and printed once by relays on connect. URLs must be absolute `http://` or `https://`; labels are plain text and length-capped. Prefer the Hive Commons Discord redirect (`https://hivecommons.dev/discord`) over channel URLs for contributors who may not already be server members. |
| `contribute.max_parallel_fixes` | `2`. | Ceiling on how many stage-072 `fix-pr` sub-sessions one contributor's relay may run beside its primary session ([#12436](https://github.com/hivecommons/hive/issues/12436)). The relay advertises its own count (`max_parallel_fixes`, from `HIVE_MAX_PARALLEL_FIXES`); the hub clamps it to this. A relay that advertises no `parallel_sessions` always has capacity 1 (preempt mode). Fixes beyond capacity queue server-side and are served before new work. Settings → Hub → Fix budget. |
| `contribute.min_focus_window` | `30m`. | Preempt mode only: after a preempted primary task resumes, the hub does not preempt that contributor again until it has run uninterrupted for this long. Settings → Hub → Fix budget. |
| `variables` | Trusted variable resolver definitions. | Env-only substitution works without this block. |
diff --git a/src/docs/security-self-assessment.md b/src/docs/security-self-assessment.md
index d2769f8963..f8019216b0 100644
--- a/src/docs/security-self-assessment.md
+++ b/src/docs/security-self-assessment.md
@@ -146,7 +146,7 @@ Hive holds no formal certification (SOC 2, ISO 27001, FIPS). It holds the [OpenS
### Communication channels
-* **Internal.** GitHub issues and pull requests on `hivecommons/hive`. Decisions are made in those public threads. Day-to-day discussion happens on the project [Discord](https://hivecommons.dev/discord) and the [hivecommons-dev Google Group](https://groups.google.com/g/hivecommons-dev), which also announces the community meeting.
+* **Internal.** GitHub issues and pull requests on `hivecommons/hive`. Decisions are made in those public threads. Day-to-day discussion happens on the project [Discord](https://hivecommons.dev/discord) and the [hivecommons-dev Google Group](https://groups.google.com/g/hivecommons-dev), which also announces the community meeting. The hosted hive's Activity Monitor is also streamed publicly on [Twitch](https://www.twitch.tv/hivecommons).
* **Inbound.** Public GitHub issues; private vulnerability reports through GitHub's "Report a vulnerability" form.
* **Outbound.** GitHub releases and `CHANGELOG.md`.
diff --git a/src/docs/streaming-the-activity-monitor.md b/src/docs/streaming-the-activity-monitor.md
index 6dc84828ad..c59c775c9d 100644
--- a/src/docs/streaming-the-activity-monitor.md
+++ b/src/docs/streaming-the-activity-monitor.md
@@ -4,7 +4,8 @@ An unattended, 24/7 Twitch stream of the hive dashboard's **Activity Monitor**
(the stage tracker: every tracked issue and PR walking Open → Actionable →
Claimed → PR in progress → CI / Review → Merge queue). The first stream is
hive's own hosted spoke on `hive-oke`, channel
-[`twitch.tv/hivecommons`](https://www.twitch.tv/hivecommons).
+[`twitch.tv/hivecommons`](https://www.twitch.tv/hivecommons). The stream is
+listed alongside the other community links in [Community and support](community.md).
Everything lives in [`src/deploy/stream/`](../deploy/stream/README.md): a
container that renders the dashboard in a virtual display and pushes it to
diff --git a/src/pkg/config/contribute_help_links.go b/src/pkg/config/contribute_help_links.go
index f13057ad08..f9d4b30edb 100644
--- a/src/pkg/config/contribute_help_links.go
+++ b/src/pkg/config/contribute_help_links.go
@@ -15,6 +15,7 @@ const (
var DefaultContributeHelpLinks = []ContributeHelpLink{
{Label: "Contributor docs", URL: "https://github.com/hivecommons/hive/blob/v5/src/docs/contributor-relay.md"},
{Label: "Open a Hive issue", URL: "https://github.com/hivecommons/hive/issues"},
+ {Label: "Watch the hive live on Twitch", URL: "https://www.twitch.tv/hivecommons"},
}
func NormalizeContributeHelpLinks(in []ContributeHelpLink) ([]ContributeHelpLink, error) {
diff --git a/src/pkg/config/contribute_help_links_test.go b/src/pkg/config/contribute_help_links_test.go
index cde3849d8c..264ebbcf63 100644
--- a/src/pkg/config/contribute_help_links_test.go
+++ b/src/pkg/config/contribute_help_links_test.go
@@ -37,4 +37,13 @@ func TestContributeHelpLinksDefault(t *testing.T) {
if !strings.Contains(links[0].URL, "src/docs/contributor-relay.md") {
t.Fatalf("default docs link = %#v", links[0])
}
+ found := false
+ for _, l := range links {
+ if l.URL == "https://www.twitch.tv/hivecommons" && strings.Contains(l.Label, "Twitch") {
+ found = true
+ }
+ }
+ if !found {
+ t.Fatalf("default links = %#v, want Twitch live stream link", links)
+ }
}
diff --git a/src/pkg/dashboard/contribute_landing.go b/src/pkg/dashboard/contribute_landing.go
index 2a5887570d..e810c5f254 100644
--- a/src/pkg/dashboard/contribute_landing.go
+++ b/src/pkg/dashboard/contribute_landing.go
@@ -1579,7 +1579,7 @@ select.admin-act{min-width:0;max-width:100%%}
Donate your CLI + API tokens to help this project's AI agent swarm.
Powered by ClankeR, the contributor relay — it hands tasks from this hive's backlog to the agent running on your machine. Your compute, their backlog. Bring your own inference — how you want to contribute is up to you.
-Questions? Join our Discord and we'll help you get to your first PR.
+Questions? Join our Discord and we'll help you get to your first PR. Or watch the hive live on Twitch.
%s
diff --git a/src/pkg/dashboard/static-src/html/faq.html b/src/pkg/dashboard/static-src/html/faq.html
index 10ba03a980..675267a0a0 100644
--- a/src/pkg/dashboard/static-src/html/faq.html
+++ b/src/pkg/dashboard/static-src/html/faq.html
@@ -6,7 +6,7 @@
Need help from humans? Join our Discord; the Hive Commons community can help you pick the right next step.
+
Need help from humans? Join our Discord; the Hive Commons community can help you pick the right next step. Want to see a hive at work? Watch the hive live on Twitch.