Skip to main content
← Back to list
01Issue
FeatureShippedSwamp ClubPublicEnterprise
Assigneesskunk-ape

Relationships

#4202 Swamp Club collective GUI: show the swamp serve instances currently connected to a collective

Opened by tagur · 10/30/2026· Shipped 11/10/2026

Problem

A collective's page in the swamp.club GUI shows members, but not which swamp serve instances are running or connected under that collective. Operators can't tell from the GUI which serve instances are online, who started them, or when they last checked in. They have to ask teammates or SSH into hosts.

Proposed solution

If serve instances already register or heartbeat with swamp.club (for example for auth, collective admission, or the inbox check), surface that in the collective view with a "Serve instances" tab or panel. Per instance it would show:

  • Instance name or ID, hostname, and swamp version
  • Owner or identity that started it
  • Connection state (connected / last seen timestamp)
  • Optionally: repo or datastore identity, bound address, and connected worker count

If serve doesn't report to swamp.club today, add an opt-in lightweight registration/heartbeat (authenticated, collective-scoped, expiring after a missed heartbeat). It would need to be clear in the manual's outbound requests section, and could be turned off with a flag. Visibility should be limited to collective members, ideally with admin-only detail.

Alternatives considered

  • A CLI-only command such as swamp serve list --collective <name>. It helps scripting but doesn't give the at-a-glance GUI view.
  • Querying each serve instance directly. This requires knowing its address and having network reach, which defeats the purpose.

Open questions

  • Does swamp.club currently have any per-instance signal from serve to build on?
  • Privacy: which fields (hostname, address) should be exposed, and to whom?
02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 12 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

11/10/2026, 6:08:05 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
tagur moved this from a private collective to public10/31/2026, 1:17:00 PM
skunk-ape assigned skunk-ape11/10/2026, 1:42:02 PM
Editable. Press Enter to edit.

system commented 10/30/2026, 8:28:14 PM

Classified automatically when this issue was filed.

  • Source: Swamp Club

If you feel this classification is incorrect, add a ripple to tell us so.

tagur commented 11/7/2026, 2:42:36 PM

@stack72 - did you say this one was completed already?

skunk-ape commented 11/10/2026, 7:11:14 PM

Thanks @tagur for reporting this! We shipped: List serve instances to every collective member, one row per serve process keyed by oauthClientId plus instanceId, with who started it (OAuth client pattern), the OAuth client name, and an always-visible Serve tab with a self-documenting empty state. Heartbeats match on instanceId when sent (swamp-club#4587) and fall back to the newest row for the client; register removes the client's legacy row. No out-of-band migration.. The fix has been merged and a release is on its way. We appreciate your contribution to swamp.

Sign in to post a ripple.