Skip to content

feat(setup): ask only what has no default in the first-run wizard - #376

Merged
adeelahmad merged 2 commits into
mainfrom
claude/project-thread-ws42o4
Oct 15, 2026
Merged

adeelahmad merged 2 commits into
mainfrom
claude/project-thread-ws42o4

Conversation

@adeelahmad

Copy link
Copy Markdown
Owner

Requested by Adeel · project thread

Description

Before: after the first sign-in, the setup wizard walked through every step (namespace, storage, model provider, budget, apps, telemetry), each already defaulted, even when the installer had set the model provider.

After: the wizard asks only for what has no answer: a model provider, and a budget when that model is a paid cloud one (a model on this machine or this network needs none). Namespace, storage, apps and telemetry are one click away under "With defaults, if you'd like to choose" and stay in Settings. When the installer or .env already set the model, setup finishes at startup and the wizard never opens. GET /api/v1/setup and the lens_status tool say what's left (todo), so an agent knows too.

How: setup.todo() decides from the effective settings (llm without base URL or model → llm; a cloud model with no overall budget that the installer didn't seed → budget); setup.finish_if_ready() runs in prepare(). The wizard builds its flow from todo once. The clicks journey for the wizard is now one click ("Save and continue"); the Clicks baseline comes from this PR's CI artifact.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change; ! in the title)

Checklist:

  • The title is a Conventional Commit.
  • My code follows the code style of this project (make hooks checks it on commit).
  • I added or updated tests. (4 backend in tests/api/test_setup.py; wizard jest tests)
  • My change requires documentation updates, and I have updated docs/ accordingly. (configuration.md First-run setup, get-started.md, storage.md, telemetry.md)
  • Users need more than the title to understand it, so I wrote it under ## Unreleased in CHANGELOG.md. (n/a)

Done questions (AGENTS.md)

  • Goal: the wizard asks only what's required; merged on green CI.
  • Agents: todo in GET /setup and lens_status.
  • Zero setup: an install that set the model skips the wizard entirely.
  • Fewest clicks: the wizard journey goes from a click per step to one click.
  • Configurable: every skipped step keeps its default and stays in Settings.
  • Light: n/a.
  • Private and secure: n/a, no new surface.
  • Cost: a paid cloud model still asks for a budget before anything runs.
  • User decides: defaults unchanged; optional steps remain one click away.
  • Upgrades: an install that already finished setup is untouched; one mid-setup with a model set finishes at the next start.
  • Honest: docs describe what the wizard asks now.
  • Tests, docs and generated files (make openapi) updated.
  • Open: n/a.
  • Reported in the thread; refine later: none.

🤖 Generated with Claude Code

https://claude.ai/code/session_014Y4mUBxDN6pTR2fykqrfYV


Generated by Claude Code

The setup wizard walked through every step (namespace, storage, model, budget, apps, telemetry)
even when each had a default. It now asks only for a model provider, and a budget for a paid
cloud model; the rest is one click away and in Settings. When the installer or .env already set
the model, setup finishes at startup and the wizard doesn't open. GET /setup and lens_status
say what's left (todo), so an agent knows too.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014Y4mUBxDN6pTR2fykqrfYV
@adeelahmad adeelahmad self-assigned this Oct 15, 2026
Baselines from this PR's own Clicks run (artifact clicks).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014Y4mUBxDN6pTR2fykqrfYV
@adeelahmad
adeelahmad merged commit f7d3590 into main Oct 15, 2026
10 checks passed
@adeelahmad
adeelahmad deleted the claude/project-thread-ws42o4 branch October 15, 2026 01:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants