Using Engram

Desktop app

A floating bubble that answers from your organization's approved memory over any application — summoned with a global shortcut, signed in as you, fenced by exactly your permissions. Windows beta today; macOS is coming soon.

Install & sign in

  1. Download the installer

    Grab the Windows build from the download page. It installs per-user — no admin rights needed. The beta installer is unsigned, so Windows may show a SmartScreen prompt: choose More info → Run anyway.

  2. Mint a personal token

    In the web app, open Settings → Account → My personal token and generate a token (name it something like Desktop on my PC). The secret is shown once — copy it.

  3. Point the bubble at your deployment

    On first launch the app asks for your Engram URL and the token. Paste both, connect, and the window disappears into the tray — from then on it's shortcut-only.

Using the bubble

  • Alt + Space — summon the bubble over whatever you're doing and ask in plain language. Answers cite the approved memories they came from, or refuse if nothing accessible covers the question.
  • Alt + Shift + Space — grab a region screenshot and ask about it (an error dialog, a chart, a form) — the capture is attached to your question.
  • The tray icon offers Change token… (re-run sign-in) and quit.

Permissions & security

The desktop app is an ordinary API caller — there is no privileged desktop path. Every request carries your personal token, so retrieval is trimmed to your grants in SQL, the same fence as the web app, ⌘K omnibar, and MCP. Ask about something outside your access and you get a governed refusal, not a leak. Revoking the token in Settings instantly signs the desktop app out.

One token per device is good hygiene

Mint a separate token for each machine (the name is yours to choose). If a laptop is lost, revoke just that token in Settings → Account — nothing else is affected.

Platform support

  • Windows 10/11 (x64) — available now, in beta. The release channel is rolling: reinstalling from the download page always gives you the newest build.
  • macOS — coming soon.