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

Relationships

#4713 Swampify: start page card at the top, Swampify page refreshes on return, and briefs link to the page

Opened by skunk-ape · 11/13/2026· Shipped 11/13/2026

Part of Swampify onboarding. Follows #4705 ("Start from your past sessions" on swamp start) and #4643 (the Swampify page), from a first run.

Repo: swamp (swamp start page, the Swampify page, and the start briefs only).

Goal

Three changes from a first run of the start-to-build flow:

  1. The "Start from your past sessions" option is easier to find.
  2. The Swampify page shows new results without a hard refresh.
  3. The agent can send the user to the Swampify page by its address.

No new CLI command or flag.

1. The start page option

  • Placement. Put "Start from your past sessions" at the top of the workspace screen, above the workspace list and the create form. Today it sits collapsed below them and is easy to miss.
  • Shape. Collapsed, it is a single-line card: the Swampify icon, then one line of copy. Opening it shows the panel as it is now (disclosure, window, excluded paths, agent, workspace name).
  • Icon. Reuse the Swampify icon from the dashboard sidebar (swampify in components/Sidebar.tsx). Share it rather than copy the SVG.
  • Copy and design. Expect to iterate on the wording and the look during the session.

2. The Swampify page refreshes

The page loads its items once and refetches only when an error is retried. A build happens in the agent's session, so the page never learns about it: after a build, Built stayed empty until a hard refresh.

  • Refetch the page's queries (candidate set, offer, comparisons) when the tab becomes visible again, using the visibility pattern in client/run_activity.ts.
  • Optionally, refetch on an interval while the tab is visible and the offer is picked (a build is under way).

The Swampify page already has its own route, but the agent doesn't know the dashboard's address, so the skill can only say "open the dashboard and go to Swampify".

  • When swamp start writes a swampify brief (the kick-off and the build brief), add the Swampify page's address for this workspace on the running start server, outside the kick-off text so the marker and the text #4705 pinned stay as they are.
  • No token in the brief: briefs are files in the repo. Check that the start page's own browser session authorises the link. If it doesn't, write no link and the skill falls back to naming the page.
  • Agree the line's wording with the skill change in swamp-extensions, which prints it.

Out of scope

  • The skill's hand-off to the page (swamp-extensions).
  • Any change to the kick-off text, its marker or the task kind.

Done when

  • Unit tests cover the card's position and its collapsed and open states, and the shared icon.
  • A unit test shows the Swampify page refetches when the tab becomes visible.
  • Unit tests cover the page link in kick-off and build briefs, with no token, and its absence when no address is known.
  • An integration test through the start server writes a kick-off brief that carries the link, and the pinned kick-off text is unchanged.
  • A manual run: start page → card → kick-off → build, with Built appearing on the Swampify page without a hard refresh.
02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 12 MOREPR_LINKED+ 2 MORESESSION_SUMMARIZED

Shipped

11/13/2026, 6:26:20 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
skunk-ape assigned skunk-ape11/13/2026, 3:08:24 PM

Sign in to post a ripple.