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

Relationships

#4818 Swampify: a Preview badge on the swamp start card, and the opt-in env var goes

Opened by skunk-ape · 11/16/2026· Shipped 11/18/2026

Part of Swampify. Follows #4728, which made Swampify in swamp start opt-in behind SWAMP_EXPERIMENTAL_SWAMPIFY=1, and #4713, which put "Start from your past sessions" as a card at the top of the workspace screen. Ship after #4807 and #4808.

Repo: swamp (swamp start, its start page, and the design docs).

Problem

Swampify is ready for more people than the testers who know the env var, but it's still a preview. Today the card is either hidden (no env var) or shown with nothing to say it's early.

Decision

Swampify in swamp start is on for everyone, labelled as a preview. The SWAMP_EXPERIMENTAL_SWAMPIFY gate from #4728 goes.

Proposed change

  • Add a "Preview" badge to the "Start from your past sessions" card at the top of the swamp start workspace screen. It's a small label next to the card's title, in the dashboard's existing badge or pill style, with accessible text (not colour alone). A short tooltip or line can say it's new and may change.
  • Remove the SWAMP_EXPERIMENTAL_SWAMPIFY gate: the env read in src/cli/commands/start.ts, the signal it sets, the start server's refusal of a swampify launch when it's off, and their tests. The card shows under the same conditions as before #4728: when Claude Code or Codex history is found (showPastSessions).
  • Anyone who still sets the variable sees no difference and no warning.
  • Update design/surfaces/start.md and design/surfaces/swampify.md: drop the opt-in text, and say the entry point is a preview with a badge.

Done when

  • With no env var, swamp start on a machine with Claude Code or Codex history shows the card with the Preview badge, and the kick-off launches.
  • A machine with no such history shows no card, as before.
  • SWAMP_EXPERIMENTAL_SWAMPIFY appears nowhere in code, tests or design docs.
  • Unit tests cover the badge and the card's visibility. The start server tests no longer expect a refusal.
  • Screenshots of the card with the badge, in light and dark if the dashboard has both.

Out of scope

  • Badges elsewhere, such as the dashboard's Swampify page or sidebar entry.
  • Changes to the kick-off or the skill.
02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 3 MOREFINDINGS+ 6 MOREPR_LINKED+ 2 MORESESSION_SUMMARIZED

Shipped

11/18/2026, 3:48:46 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
skunk-ape assigned skunk-ape11/17/2026, 1:38:10 PM

Sign in to post a ripple.