First-run guided setup, explorer open buttons, and notes streaming fix - #19
Merged
Merged
Conversation
Deltas now accumulate off-thread and a dispatcher timer repaints at most ten times a second, so a fast model can no longer starve the UI thread. Streaming also stays off the UI dispatcher entirely (ConfigureAwait), and closing or switching notes cancels the in-flight request instead of leaving it generating into a hidden reply strip.
Folders open in Windows File Explorer, files in their default app. Double-click still opens files but no longer tries to open folders, where it fought the expand/collapse toggle.
A fresh install now gets the full walkthrough in the chat: reach the daemon, install Ollama via winget if it's missing, start it, and pick a starter model from a curated list with hardware hints (cloud or local) — instead of landing on the raw Settings page. Settings gains a Run guided setup button so the wizard stays discoverable after first run.
README gains an end-user Install section up top: download the self-contained zip (no .NET needed), run it, and let the first-run wizard handle Ollama and a starter model. CHANGELOG documents the first-run setup, explorer open buttons, and the notes streaming fix.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Release-prep work: a guided first-run experience for brand-new users, a smoother file explorer, and a fix for the app freezing during notes-assistant replies.
What's new (plain language)
1. First launch now sets itself up. Someone who downloads the release zip and runs it for the first time gets a step-by-step walkthrough right in the chat: the app checks for Ollama, offers to install it (one click, via winget) if it's missing, starts it, and helps pick a first AI model from a short list with plain-language size guidance ("~1 GB, fast on any laptop" up to "best local quality, 8 GB+ VRAM"), or the recommended cloud option. Before this, a new user landed on a settings page with an empty URL box and no guidance. The wizard remains available afterward via /setup or a new "Run guided setup" button in Settings.
2. File explorer rows have an open button. Folders open in Windows File Explorer, files in their default app. (Double-clicking a folder couldn't do this reliably — it conflicts with expanding/collapsing the folder.)
3. Fixed: the app froze while the notes assistant was replying. Fast models could produce text quicker than the screen repainted, locking the whole app until the reply finished. Replies now paint on a fixed 10-per-second schedule regardless of model speed, and closing a note properly stops its in-flight request.
4. Docs refreshed for release. README now opens with an end-user install section (download zip, run, no .NET required); CHANGELOG covers all of the above.
Why it matters
This is the last UX gap before v1: the release zip is fully self-contained, so first-run setup was the only place a newcomer could get stuck. With the wizard, the path from download to first AI reply requires zero prior knowledge of Ollama, models, or endpoints.
Scope / risk
Verification