prototype: one-keypress onboarding review screen (mocked) by gtrrz-victor · Pull Request #1903 · entireio/cli

gtrrz-victor · 2026-08-05T12:29:57Z

What

A throwaway, fully-mocked prototype of a "one-keypress" entire enable onboarding UX, for iterating on flow + wording. Not wired to entire-cli — every side effect (login, mirror, hooks, git) is faked.

Demo: screen-recorded and attached below.

The idea

A single inline review screen where every value is pre-decided and editable, and Enter builds the folder — instead of today's ~5 sequential prompts.

Folder-state aware (see below), or real auto-detect.
Mirror is a first-class decision (Mirror to Entire row / Publish row for no-origin), defaulting on where mirrorable so one keypress lands you connected.
Copy pitches what mirroring unlocks in entire.io (code, commits, search, transcripts) and links the mirrors docs.

Folder states (`--state`)

`--state`	Simulates	Onboarding shape
`auto` (default)	Real detection of the current folder	resolves to one of the below
`repo-gh`	Git repo with a GitHub origin	Mirror to Entire row, defaults Yes → lands connected
`repo-no-origin`	Git repo, no/again non-GitHub origin	local-only; opt-in Publish (off by default) → publishes to GitHub + mirrors
`empty`	Empty / non-git folder	Repository row (`local` / `+ GitHub` / `bare`); `+ GitHub` publishes + mirrors

Run

cd prototypes/onboarding
go run . --state repo-gh          # or repo-no-origin | empty | auto
go run . --state repo-gh --yes    # non-interactive

↑↓ move · ←→/space change · enter accept · esc cancel. See the README for all flags.

Isolation

Its own nested Go module under prototypes/onboarding/, so the main module's build/lint/CI skip it — no production-lint friction while iterating. Shares only cobra/bubbletea/lipgloss so the look transfers to a real implementation.

Status

Draft / for discussion. Explores the UX only; the real implementation would back these rows with the existing resolvers (detectOrSelectAgent, resolveFirstRunCheckpointBackend, the mirror offer, …).

🤖 Generated with Claude Code

A throwaway prototype of the "one-keypress" entire enable UX: a single inline Bubble Tea review screen where every value is pre-decided and editable, and Enter builds the folder. Every side effect (login, mirror, hooks, git) is mocked so we can iterate on flow and wording fast. Folder-state aware (repo-gh / repo-no-origin / empty via --state, or real auto-detect), with the mirror decision surfaced as a first-class row and copy that pitches what mirroring unlocks in entire.io (code, commits, search, transcripts) linking the mirrors docs. Isolated as its own nested Go module under prototypes/onboarding so the main module's build, lint, and CI skip it entirely. Imports nothing from cmd/entire/cli — shares only cobra/bubbletea/lipgloss so the look transfers. Includes a VHS demo.tape for recording a GIF and a README. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

cursor

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 3ca4ad0. Configure here.}

cursor · 2026-08-05T12:31:54Z

+			m.showMore = !m.showMore
+			return m, nil
+		}
+		f := fs[m.focus]


Focus invalid after collapsing options

High Severity

Toggling showMore off leaves focus at the old moreIdx, which is then past the end of fields(). The next ←/→/space indexes fs[m.focus] and panics. Collapsing "Fewer options" is the normal way to leave that row, so this is easy to hit.

^{Reviewed by Cursor Bugbot for commit 3ca4ad0. Configure here.}

cursor · 2026-08-05T12:31:54Z

+	if slug := githubSlug(strings.TrimSpace(string(out))); slug != "" {
+		return StateRepoGitHub, slug, nil
+	}
+	return StateRepoNoOrigin, "", nil


Empty slug on auto no-origin

Medium Severity

detectState returns an empty Slug for no-origin (and non-GitHub) repos, while --state repo-no-origin and empty-folder detection seed a mock slug. Enabling Publish then prints a blank created-repo name and a broken entire.io/gh/ URL — and demo.tape exercises exactly this auto-detect publish path.

Additional Locations (2)

prototypes/onboarding/main.go#L97-L103

prototypes/onboarding/demo.tape#L13-L29

^{Reviewed by Cursor Bugbot for commit 3ca4ad0. Configure here.}

Recording will be done natively; remove demo.tape, the README recording section, and the *.gif ignore. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Copilot

Pull request overview

Adds a standalone, fully-mocked onboarding prototype under prototypes/onboarding/ to iterate on a single-screen “one-keypress” entire enable flow (Bubble Tea inline review UI + mocked execution plan), intentionally isolated as its own Go module so it doesn’t affect the production CLI build/lint/CI.

Changes:

Introduces an inline Bubble Tea review screen that edits a resolved Config and generates an ordered Plan to execute.
Implements mocked plan execution output (simulated delays, fake login/mirror/publish steps) for demo realism.
Adds prototype module scaffolding + docs + VHS script to record a demo GIF.

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
prototypes/onboarding/tui.go	Bubble Tea inline review screen for editing onboarding decisions and confirming/canceling.
prototypes/onboarding/run.go	Mocked plan execution + outcome messaging with simulated delays.
prototypes/onboarding/model.go	Core state/config model and pure `planFromConfig` mapping.
prototypes/onboarding/main.go	Cobra entry point, flags, state resolution (auto-detect + simulated states), and wiring review→plan→run.
prototypes/onboarding/README.md	Usage and demo instructions for the prototype.
prototypes/onboarding/go.mod	Nested Go module definition and direct dependencies for the prototype.
prototypes/onboarding/go.sum	Dependency checksums for the prototype module.
prototypes/onboarding/demo.tape	VHS script to record a demo run as a GIF.
prototypes/onboarding/.gitignore	Ignores built binary and generated GIF artifacts.

+func detectState() (FolderState, string, error) {
+	if err := exec.Command("git", "rev-parse", "--git-dir").Run(); err != nil {
+		return StateEmpty, "github.com/acme/new-project", nil
+	}
+	out, err := exec.Command("git", "remote", "get-url", "origin").Output()
+	if err != nil {
+		return StateRepoNoOrigin, "", nil
+	}
+	if slug := githubSlug(strings.TrimSpace(string(out))); slug != "" {
+		return StateRepoGitHub, slug, nil
+	}
+	return StateRepoNoOrigin, "", nil
+}


+	// StateRepoNoOrigin: git repo, no/again non-GitHub origin. Local tracking;
+	// no mirror row (nothing to mirror to).


Copilot AI lite review requested due to automatic review settings August 5, 2026 12:29

Copilot started reviewing on behalf of gtrrz-victor August 5, 2026 12:30 View session

cursor Bot reviewed Aug 5, 2026

View reviewed changes

chore(prototype): drop VHS recording tape/docs

19e6bfb

Recording will be done natively; remove demo.tape, the README recording section, and the *.gif ignore. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Copilot AI reviewed Aug 5, 2026

View reviewed changes

Navigation Menu

Uh oh!

prototype: one-keypress onboarding review screen (mocked) - #1903

prototype: one-keypress onboarding review screen (mocked)#1903
gtrrz-victor wants to merge 2 commits into
mainfrom
worktree-onboarding-proto

gtrrz-victor commented Aug 5, 2026 •

edited

Loading

Uh oh!

cursor Bot left a comment

Uh oh!

cursor Bot Aug 5, 2026

Uh oh!

cursor Bot Aug 5, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

2 participants

		// StateRepoNoOrigin: git repo, no/again non-GitHub origin. Local tracking;
		// no mirror row (nothing to mirror to).

Uh oh!

Conversation

gtrrz-victor commented Aug 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What

The idea

Folder states (--state)

Run

Isolation

Status

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Aug 5, 2026

Choose a reason for hiding this comment

Focus invalid after collapsing options

Uh oh!

cursor Bot Aug 5, 2026

Choose a reason for hiding this comment

Empty slug on auto no-origin

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

2 participants

gtrrz-victor commented Aug 5, 2026 •

edited

Loading

Folder states (`--state`)