Remove the Upgrading page and the troubleshooting pointers to it Nobody but the owner has an install from before the rename or the plugins, so the upgrade steps have no reader. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Remove the worked-example pages They walked through the plugins' own code. What a user needs from them is now in the plugins section of docs/tools.md, and writing a tool of your own is on Custom Tools. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sharing custom tools: offer a tool upstream as a plugin docs/tools.md no longer has a section on adding a built-in tool. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Home: say what the name Keryx means, and that Lyra is the default Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Data and retention: American spelling of canceled Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Worked example cluster_stats: shorter sentences, numbered guard steps, no CLAUDE.md footer Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Worked example check_billing: shorter sentences, lists, no CLAUDE.md footer Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Custom tools, Sharing custom tools: contractions, descriptive link text Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Approval bridge: plainer prose, effects instead of internal names Replaces classify(), policy.py, answer_approval and ApprovalBroker.digit with what they do, splits the long bullets, and drops the CLAUDE.md footer. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Google Workspace MCP, Command Line Reference: numbered sign-in steps, plainer prose Drops the note on the email settings' names before plugins; that history belongs on the Upgrading page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Assumptions, Running as a Service, Restarting Keryx: plainer prose Contractions, American spelling, one idea per sentence, numbered ngrok setup, and effects instead of internal names. Restarting Keryx no longer defers to CLAUDE.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Data and retention: lists instead of run-on paragraphs, plainer wording Also links SECURITY.md's section on secrets instead of CLAUDE.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Troubleshooting: contractions, conditions first, shorter sentences Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Home and footer: point readers at SECURITY.md and docs/, not CLAUDE.md CLAUDE.md is instructions for coding agents. Home no longer says the README has a guide to writing tools (that is docs/tools.md and Custom Tools), shrinks the "Before you begin" list, and links the Upgrading page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Security model: plainer prose, effects instead of internal names Cuts the page's description of itself, splits long sentences, puts the tunnel's routes in a table, and names what each rule does rather than the function that enforces it. Points at SECURITY.md, not CLAUDE.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Upgrading: one page for the steps an existing install must take Collects the Jarvis-to-Keryx migration, the assistant's new default name, the move of the optional tools to plugins, and re-running the installers. Troubleshooting keeps a one-line pointer for each error people search for. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Setup: numbered install steps, prerequisites in a list, plainer prose The per-directory table moves to Data and Retention, which already lists every file; Setup keeps a one-paragraph summary and a link. The wake-word paragraph goes (Home names the branch), and the plugins upgrade note moves to the Upgrading page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Drop the leading H1 from every page; GitHub already shows the page name Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Command line: `keryx serve --demo`, and what it is for Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Data and retention: drop the note on transcripts from before redaction Nobody has any: redaction predates every install. That a call without the PIN is kept out of memory and recall is in SECURITY.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Say what we mean: spoofed caller id, canned responses in tests Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Keryx the service, Lyra the assistant: the wiki follows the rename Every page says Keryx for the service and the assistant (Lyra by default) for the voice; links point at wak31415/keryx and src/keryx; Restarting-Jarvis is Restarting-Keryx. The wake word is still "hey jarvis", the pretrained model's name. Troubleshooting covers serve refusing until `keryx migrate` has run. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Setup: most tested with Claude Code on a subscription; other agents may lack parity
docs: plugins, custom tools, and what landed on main since the last edit New pages: Custom Tools (writing and checking your own voice tools) and Sharing Custom Tools (a suggested convention for publishing them; there is no registry). The two worked examples are rewritten as plugins. Every other page is checked against main: plugins in place of the retired settings, jarvis plugins / jarvis tools, CLAUDE_CONFIG_DIR, a failed restart that rings, TRANSCRIPTION_LANGUAGE and CLOCK_FORMAT.
docs: drop the upgrade-from-~/.jarvis notes; nobody outside has an old install Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
docs: polish wiki prose
docs: rulings live in CLAUDE.md and SECURITY.md, not a design spec The spec left the repository; every page that cited it now names the section of CLAUDE.md or SECURITY.md that holds the same ruling. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs: a Setup page, moved from the README What jarvis setup asks, the phone, the PIN, Google, settings, where Jarvis keeps its files, upgrading from ~/.jarvis, and costs. Linked from Home and the sidebar. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs: point the remaining paths at the XDG directories Home, Assumptions, Google, Restarting and the Approval Bridge now name ~/.config/jarvis, JARVIS_HOME for the Google client file, and STATE_DIR for logs, running-version and the approval socket. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
docs: Security Model puts the secrets and the PIN in ~/.config/jarvis Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>