Skip to content

Utterform 0.14.0 Set up in a minute - #54

Merged
jli-software merged 2 commits into
mainfrom
work/utterform-0.14.0-assistant
Nov 8, 2026
Merged

jli-software merged 2 commits into
mainfrom
work/utterform-0.14.0-assistant

Conversation

@jli-software

Copy link
Copy Markdown
Owner

Stage 0.14.0 of the 1.0 roadmap: the first-run assistant. Mock-up accepted by Jonas on 2026-11-08.

What

  • Four steps for a new installation: Cloud or on this device · OpenAI key (with Create key ↗) or local model (Base recommended) · language code (system language suggested) and optional words · ChatGPT for text actions (experimental, only with a Codex login), dictation key, start at login.
  • Skip setup on every step: one click, persistent, applies nothing.
  • Nothing before Finish; then in order: settings (still incomplete), key, model download, hotkey, autostart (read back), completion. A failing stage returns to its step; retries do not repeat finished work.
  • onboarding_completed in settings: new installs false, legacy files without the field read as true (no assistant on upgrade).
  • Native gate cli::Intent::route: while setting up, launch intent, second instance and global hotkey reveal the window and are never forwarded or kept.
  • open_openai_api_keys: fixed URL, no argument, no WebView opener permission.

Adapted from the contract in Draft PR #39: no Live choice and no recording topic in the assistant (Settings keeps them); issue #40 stays with 1.0.

Validation

  • npm run check · npm test (174) · npm run build · npx playwright test (43, incl. assistant at 920×720 and 360×400, Skip in light theme)
  • cargo fmt --check · cargo clippy --all-targets -D warnings · dbus-run-session -- cargo test (231)
  • Not exercised live: installed app on a clean profile, real download/keyring from the assistant, upgrade from real 0.8.0 settings — listed in TESTING.md for 1.0.

No version bump, tag or release (ships with 1.0).

🤖 Generated with Claude Code

https://claude.ai/code/session_014LfoKbq3S36AiYRW7j8QLK

jli-software and others added 2 commits November 8, 2026 21:44
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014LfoKbq3S36AiYRW7j8QLK
A new installation opens on four short steps: where to transcribe, the
OpenAI key or the local model, the language and optional words, then
ChatGPT for text actions, the dictation key and start at login. Skip on
every step ends it for good and applies nothing; nothing is stored,
downloaded or registered before Finish. Settings files from before the
assistant count as set up, so upgrades never see it. While it is open,
every intent reveals it and none records.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014LfoKbq3S36AiYRW7j8QLK
@jli-software
jli-software merged commit fc40e15 into main Nov 8, 2026
2 checks passed
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