← 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 startworkspace 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_SWAMPIFYgate: the env read insrc/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.mdanddesign/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 starton 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_SWAMPIFYappears 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
Shipped
Click a lifecycle step above to view its details.
03Sludge Pulse
Sign in to post a ripple.