verify-on-mac.md

docs/verify-on-mac.md

1. # Checking Cortex on a Mac with a real key
3. Everything in this repository runs against a local stand-in server in CI.
4. A few things can only be checked on a Mac with a real DeepInfra key, because
5. they depend on the provider's live behavior or on macOS itself. This takes
6. about five minutes. Each step says what you should see.
8. ## 1. Build and open it
10. ```bash
11. npm ci
12. npm run tauri build -- --bundles app
13. open target/release/bundle/macos/Cortex.app
14. ```
16. Or install the `.dmg` from the `macos` workflow's artifact. It is ad-hoc
17. signed, so macOS asks once: System Settings, Privacy & Security, "Open Anyway".
19. - [ ] The window opens with frosted, translucent panels over the desktop (vibrancy).
20. - [ ] Settings, Appearance: switching "Window material" changes the frost at once,
21. and lowering "Panel tint" lets more of the desktop color through. macOS
22. fixes the blur strength per material, so these are the two dials there are.
23. - [ ] The sidebar sits clear of the red/yellow/green window buttons.
25. ## 2. The key goes to the Keychain
27. Settings, DeepInfra, paste the key, Save. Cortex checks the key with
28. DeepInfra before storing it.
30. - [ ] A good key: one message, "Key saved. DeepInfra accepted it."
31. - [ ] A wrong key (change one character): "DeepInfra rejected this key, so it was not saved", and nothing is stored.
32. - [ ] macOS may ask Cortex to use the Keychain: choose Always Allow.
33. - [ ] Keychain Access shows an item named `com.mattrguerra.cortex`, account `provider:deepinfra`.
34. - [ ] Quit and reopen: the key field says "Saved in your keychain", and the app asks the Keychain at most once per launch.
36. ## 3. Live prices
38. Open the model picker.
40. - [ ] The footer says "Prices from DeepInfra, updated ..." (not "offline copy").
41. - [ ] A model you know shows its current price per million tokens.
43. ## 4. A real reply is billed correctly
45. Send a short message to a cheap model (say `google/gemma-3-12b-it`).
47. - [ ] The reply streams in word by word.
48. - [ ] The line under it reads like `NN in, NN out, $0.0000x` with **no** "est." badge. That confirms DeepInfra sent its usage block, and that Cortex found it.
49. - [ ] The number matches the arithmetic: in x input price + out x output price, per million.
50. - [ ] DeepInfra's dashboard shows the same request (its total may differ slightly if it bills cached tokens).
52. ## 5. Stop, reasoning and images
54. - [ ] Ask something long, press Stop (or Esc): the partial reply stays, marked "Stopped", with an "est." cost.
55. - [ ] Pick a reasoning model (tagged `reasoning`) and ask a puzzle: a collapsed "Reasoning" section appears above the answer.
56. - [ ] Pick a vision model, paste a screenshot into the composer: it attaches as a chip, and the answer describes the image.
58. ## 6. The quick prompt
60. - [ ] Press Cmd+Shift+Space anywhere: the small frosted prompt appears, centered on the screen under the pointer.
61. - [ ] Ask something: the window grows to fit the answer, with its cost.
62. - [ ] Cmd+Enter opens the same chat in the main window. Esc hides the prompt.
63. - [ ] Clicking elsewhere hides it.
64. - [ ] Settings, Quick prompt, record another shortcut: the new one works and the old one no longer does.
66. ## 7. Tray, closing and export
68. - [ ] The menu bar icon's menu shows "This month: $X.XX of $10.00".
69. - [ ] Closing the main window hides it; Cortex keeps running in the menu bar. Cmd+Q quits.
70. - [ ] Settings, Export, choose your vault folder. Then, in a chat, ... menu, "Export to vault": a note appears with frontmatter (tokens, cost, models) and any images in `attachments/`.
72. ## If something is off
74. - **Costs marked "est." on DeepInfra.** The final usage block did not arrive or was not recognized. Run cortex-core's parser tests (`cargo test -p cortex-core openai`) against a captured chunk, and add that chunk as a fixture.
75. - **"Rejected this key" for a key that works elsewhere.** Paste it into a terminal: `curl -H "Authorization: Bearer $KEY" https://api.deepinfra.com/v1/openai/models -o /dev/null -w "%{http_code}"`. A 401 there means DeepInfra refuses it too; make a new key.
76. - **No vibrancy.** Check that `macOSPrivateApi` is still true in `src-tauri/tauri.conf.json`.
77. - **The shortcut does nothing.** Another app may own it; macOS does not always report the conflict. Record a different one.