01
Get started
macOS download is coming soon. When it ships: menu bar capture, on-device Whisper, and Wi‑Fi sharing to your phone.
Install
- Download is coming soon — a macOS installer isn’t published yet.
- Open the disk image and drag Jarvis to Applications.
- Launch Jarvis — it appears in the menu bar for quick capture.
First launch
- Jarvis downloads the speech model once (~150 MB) — allow a minute on slow connections.
- Grant microphone access when prompted for voice capture.
- Allow notifications when prompted — Jarvis alerts you when a thought finishes processing (toggle anytime in Settings).
- Optional: add an LLM API key in Settings for graph extraction and Ask Jarvis — capture works without one.
Want Jarvis on your phone? Pair over Wi‑Fi — see Phone & sync below.
02
Capture every day
Three surfaces, seven input modes, one vault. Fire off bursts quickly — transcription and linking happen in the background.
| Where | What to do |
|---|
| Floating orb | Tap to speak. Tap + or press ⌘N / c for text, links, and files. Press v to start voice from the keyboard. |
| Menu bar panel | Click the tray icon. Voice tab for bursts; Dump tab for text, link, tab, PDF, photo, and screenshot. |
| Home | Daily feed by default (switch day / week / month in the header). On your plate sits under Ask Jarvis — one Up next follow-up, then a short queue. Capture from the floating bar. |
While listening, the orb animates and a waveform appears. Tap again or wait ~2.5s of silence to finish. You can capture burst after burst without waiting for transcription.
| Input | How |
|---|
| Voice | Orb, menu bar, or tray → Voice capture |
| Text | Bar +, ⌘N, or Dump tab |
| Link / tab | Paste a URL; use tab mode for address-bar URLs |
| File | Drag, drop, or attach PDFs, images, audio |
| Screenshot | Paste ⌘V into the capture area |
03
Hi Jarvis
Always-on wake with Whisper. Say Hi Jarvis or press J to start a session. The mic stays open for follow-ups.
| You say | Jarvis does |
|---|
| “Hi Jarvis” alone | Opens Home and reads your period briefing aloud |
| “Brief me” / “What's on my board” | Spoken briefing of your week |
| “Take a note” / “Capture” | Starts voice capture immediately |
| Anything else to Jarvis | Searches your vault and answers with citations |
| “Tell me more” / “Go deeper” | Expands on the notes it just cited |
| “That's all” / “Stop” | Ends the session |
Hover the capture orb when wake is armed for Say Hi Jarvis. Mute wake from the mic button on the bar — preference is remembered. Wake needs Whisper (local or cloud) and an LLM key for intent routing.
04
Explore your vault
Four main views plus search. Capture first — browse and curate when you have a moment.
Home
Time greeting, On your plate (Up next + queue), today’s captures as a day-grouped stream, archive below. Listen reads a briefing aloud. Mark Done or Later on follow-ups.
Graph
Interactive map of concepts and links. Filter by type. Click nodes to inspect notes and neighbors.
Review
Suggested links the LLM wasn't sure about. Accept or reject — high-confidence links apply automatically.
Concepts
Library of every extracted topic, person, project, and idea. Open one to see related thoughts.
Set your name in Settings so AI summaries say “Nick decided…” instead of generic “you”. On desktop, toggle Desktop notifications in Settings — Jarvis alerts you when processing finishes (skipped while the window is focused). Check off plate actions on Home — Done, Later (snooze until tomorrow), or undo from Cleared anytime.
05
Ask & search
Don't search folders — ask in plain language. Jarvis hybrid-searches your vault and cites source dumps.
- Open Hi Jarvis (J) or the Ask bar on Home.
- Type or speak a question — “What did I say about the demo?”
- Read the answer and tap source chips to jump to original notes.
- Follow up naturally — pronouns and “tell me more” carry over for a few turns.
Press ⌘K for the command palette — search thoughts and concepts, then navigate straight there.
| Shortcut | Action |
|---|
| ⌘K | Search |
| ⌘N | New text capture |
| v | Start voice capture |
| j | Hi Jarvis |
| c | Open text capture |
| ⌘1–⌘4 | Home, Graph, Review, Concepts |
06
Phone on Wi‑Fi
Your phone is a live window onto your Mac's vault — not a second copy. Whisper and LLM still run on the desktop.
- On Mac: Settings → Share on Wi‑Fi → Start sharing.
- On phone (same network): scan the QR code or open the URL.
- Enter the 6-digit PIN. Accept the self-signed certificate warning — expected for local HTTPS.
- Use the full app on your phone. Keep the Mac awake and Jarvis running.
Join desktop merges two Macs' SQLite copies over LAN (last-write-wins, tombstone-aware deletes). Open Wi‑Fi & sync on both machines — no cloud relay.
07
Your data
Everything lives under ~/.jarvis/ on desktop. Back it up, rsync it, or delete it — your call.
| Path | Contents |
|---|
data/jarvis.sqlite | Thoughts, concepts, edges, embeddings |
data/blobs/ | Voice audio, PDFs, photos |
models/ | Whisper model files |
hub/ | TLS cert for Wi‑Fi sharing |
- Capture first, organize later — processing is async; desktop notifies when a thought is ready.
- Skim Review when the sidebar badge appears.
- Check Settings for LLM status, transcription backend, and desktop notifications.
- Optional LLM API key in Settings — capture never requires it.