Skip to content

feat(cli): first-run guide + guided wallet migration#45

Merged
frahlg merged 1 commit into
mainfrom
cli-onboarding
Jun 13, 2026
Merged

feat(cli): first-run guide + guided wallet migration#45
frahlg merged 1 commit into
mainfrom
cli-onboarding

Conversation

@frahlg

@frahlg frahlg commented Jun 13, 2026

Copy link
Copy Markdown
Member

Addresses the "first run is sparse" feedback + the confusing legacy-attach experience.

Changes

  • First-run guide. mir with no args prints a friendly getting-started walkthrough
    (serve with mir up/mir pair; reach with mir pair <code>/mir attach; identity &
    backup; LAN-direct note), with a one-time welcome banner when there's no config yet.
  • Identity intro. The first time a client command creates the owner identity, it prints
    a one-line intro — your wallet address + "back it up with mir wallet export-phrase".
  • Guided wallet migration. A legacy (pre-wallet) identity running mir attach / run /
    pair now gets a clear message: mir keygen --wallet mints a new identity, so each
    machine must be re-paired — instead of a cryptic handshake/usage failure.

Tests

TestNoArgsShowsGuide, TestAttachLegacyIdentityGuidesToKeygen; full suite + go vet /
gofmt green. Eyeballed all four paths (fresh guide, non-fresh guide, identity intro,
legacy migration) on real binaries.

Ships in the v0.5.1 patch (with the already-merged SPA pbkdf2 fix).

🤖 Generated with Claude Code

…tion

Running `mir` with no args now prints a getting-started walkthrough (serve a
machine / reach your machines / identity & backup / LAN-direct), with a one-time
welcome banner when there's no config yet — instead of a single terse usage line.

The first time a client command creates the owner identity it prints a one-line
intro (your wallet address + how to back it up with the 24-word phrase). And a
legacy (pre-wallet) identity running `mir attach`/`run`/`pair` now gets a clear,
guided migration message — `mir keygen --wallet` mints a NEW identity so each
machine must be re-paired — rather than a cryptic failure.

Adds client.IdentityExists; tests for the guide and the migration hint.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@frahlg frahlg merged commit b73df2e into main Jun 13, 2026
2 checks passed
@frahlg frahlg deleted the cli-onboarding branch June 13, 2026 14:32
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.

1 participant