Using the app

Search, inspect sources and manage your library. Learn which view to use and how to interpret its data.

Windows desktop preview#

The test branch adds a Tauri 2 desktop app and a shared React workbench. Configure chat and embeddings independently, test both, then confirm indexing. Keyword search works without keys. Original browser bookmarks are read-only.

Download unsigned preview builds

Windows desktop preview

Download facetmark-windows-x64-preview from the latest successful run. The installer includes the Python backend and offline WebView2, without large models. This is an unsigned test package, may trigger SmartScreen, and is not a production release.

Open and pair#

shell
facetmark serve

Visit http://127.0.0.1:8787/app on the service machine for automatic pairing. From another device or hostname, enter the token printed by facetmark token on the server.

Server and SSH administration steps

First run#

  1. Import an HTML or JSON copy, or explicitly discover and select a local Chromium source.
  2. Configure chat and embeddings independently, test both, check measured dimensions, then save and apply. Keyless access is limited to explicitly configured loopback services.
  3. Confirm what is sent before indexing. You can skip AI and search by keyword. Tasks show stages and actual failures, with cancellation and retry.

Choose a task#

ViewPurpose
All bookmarksPaginated browsing with folder, tag and site filters; search with words or query syntax.
Reading previewPage text, AI summary and related pages. Originals open externally; preview preserves your query.
Answer from this libraryAbove search results. Confirmation sends the question and up to 8 source excerpts; answers carry numbered citations and evidence limits.
Saving sessionsSelect a saving session and search within it.
Tasks and settingsIndexing, cancellation, diagnostics, independent models, extension pairing and manual update checks.

Read a search result#

React workbench with results beside reading preview. Synthetic bookmarks.React workbench with results beside reading preview. Synthetic bookmarks.
Keep your search context while reading · Synthetic demo library

Open an article from the collection while keeping your query and list position. Expand focused reading on desktop; narrow windows use full-screen reading with a “Back to collection” action. Expand “Saved details & search context” for source information; ranking is not fact checking.

Shortcuts and reading preferences#

ActionResult
Ctrl+KFocus search; IME composition is preserved.
↑ / ↓Select adjacent bookmarks in the result list.
EscapeClose preview or mobile navigation, restore focus and retain the query.
Language / themeSwitch Chinese/English and light/dark; preferences persist on this device.

No results or unavailable settings#

Clear filters or try another title word when nothing matches. Keyword search works without keys. Connection, related-page and session failures have retry actions. Remote access does not expose administration; use loopback or SSH forwarding.