JARVIS setup — скилл

---
name: jarvis-setup
description: Use when helping someone install, configure, or debug a fresh clone of JARVIS (this repo) — especially "the mic doesn't work", "JARVIS says his language systems are down", any Firefox/browser question, login/auth failures, or Accessibility permission prompts. Carries facts about this project that were only learned by hitting them live; check it before guessing.
---

# Setting up JARVIS

Everything below was learned the hard way, in a real setup or a real live
session, not guessed. Check a claim against the code cited before repeating
it to a user — if something here stops being true, the citation is exactly
what lets you find out.

## The microphone only works in Google Chrome

This is a hard constraint, not a preference. The frontend uses the
`SpeechRecognition` / `webkitSpeechRecognition` Web Speech API
(`frontend/src/voice.ts`) to transcribe the user's voice in the browser.
Firefox has never implemented that API at all — there is no flag, no
polyfill, no workaround. Safari's support is too inconsistent to rely on.
If someone asks to use Firefox (or anything but Chrome) for the mic, tell
them directly that it will not work, rather than letting them debug a
"broken" mic for an hour. `README.md` already states this requirement; don't
let a setup walkthrough contradict it.

## Chrome's microphone permission is scoped per origin — INCLUDING THE PORT

`http://localhost:5173` and `http://localhost:5174` are different origins as
far as the mic grant is concerned. Moving the frontend to a different port —
restarting Vite after a port conflict, following an old bookmark, `--port`
on the backend changing the URL you open — silently loses the grant, and
Chrome does **not** re-prompt once a permission has been dismissed; it just
stays denied with no visible error. This has cost a live session before.
If the mic stops working after everything
else looks fine, the first question is "did the URL's port change" — check
`chrome://settings/content/microphone` for the exact origin in use, not just
"is the mic allowed somewhere."

## JARVIS runs on the Claude Code subscription — never an API key

The voice brain (`brain.py`) is one long-lived `claude -p` process