Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLIPublic
Assigneesstack72

Relationships

#2144 Show first-login guidance after swamp auth login

Opened by stack72 · 9/14/2026· Shipped 9/14/2026

Problem

After a successful swamp auth login, users see only a confirmation card (authenticated identity, server URL, masked API key) and the command exits. There is no guidance on what to do next — no mention of swamp repo init or swamp quest.

For first-time users this is a missed opportunity to guide them into the product.

Proposed Solution

Detect first-time logins by checking AuthRepository.load() before the login flow starts — if it returns null, no prior credentials exist and this is a first login. Pass an isFirstLogin flag to the renderer and append a "next steps" block after the success card suggesting:

  • swamp repo init — to set up their first project
  • swamp quest — to see their progress pass

Key findings from investigation

  • Quest does not require a repo. Once authenticated, swamp quest fetches the genesis pass from the server API. It works from anywhere.
  • Repo init does not mention quest. They are independent — quest is gamification/progress, repo init is project setup.
  • Purely a presentation-layer change. No domain or libswamp changes needed. The CLI command detects first login, passes a boolean to the renderer.
  • JSON mode should include a nextSteps field, mirroring what JsonRepoInitRenderer already does.
  • Edge case: swamp auth logout deletes auth.json, so logout + re-login looks like a first login. This is fine — the guidance is still relevant.

Natural first-time user flow

  1. swamp auth login → success card + suggests repo init and quest
  2. swamp repo init → project setup + tool-specific getting-started guidance
  3. swamp quest → shows progress pass
02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 7 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

9/14/2026, 11:10:37 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack729/14/2026, 10:23:31 PM

Sign in to post a ripple.