Skip to content

Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.

docs: describe product behavior directly (#370)

Ruben Lütke2498a7fb106d
diff --git a/AGENTS.md b/AGENTS.md
index ab04e7465b..1f35438980 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -91,6 +91,14 @@ the install base, and "works on my machine" is the defect. (AP-23)
German in files you touch. Runtime output language is decided ONCE per turn by
`jarvis/core/turn_language.py`; no layer re-derives it, all locales are equal.
+**Public product descriptions.** Treat tracked documentation, source comments,
+docstrings, test descriptions, video copy, and commit/PR/release text as public.
+Describe our features and interactions directly. Do not present another product
+as a design reference or say our UI or behavior is inspired by, modeled on,
+copied from, or made to match it. Preserve required copyright, license and
+attribution notices and factual dependency, integration and compatibility
+references; this rule never authorizes concealing code provenance.
+
**Proportionality.** The agent owns the validation plan and chooses the smallest
set of checks that can detect a plausible regression from the diff. State the
scope, what was run, and what remains unverified in the PR. Use these tiers as
diff --git a/docs/appshots.md b/docs/appshots.md
index da0cd46039..a01ae4f930 100644
--- a/docs/appshots.md
+++ b/docs/appshots.md
@@ -23,8 +23,7 @@ window there, it takes the whole screen instead.
The area picker is a short-lived PySide6 process (`python -m
jarvis.appshot.picker`) that starts on the shortcut and exits after one
-selection, so nothing stays resident. Its look follows ShareX's region
-capture:
+selection, so nothing stays resident. The picker provides:
- every screen is frozen and dimmed the moment the picker opens, so nothing
moves under the selection (where a frozen frame cannot be grabbed, a dim
diff --git a/docs/authoring/PUBLIC-DOCS-STYLE.md b/docs/authoring/PUBLIC-DOCS-STYLE.md
index f0db72f9d1..5ef32077bc 100644
--- a/docs/authoring/PUBLIC-DOCS-STYLE.md
+++ b/docs/authoring/PUBLIC-DOCS-STYLE.md
@@ -15,9 +15,10 @@ tags: [docs, writing, accessibility, privacy]
---
This is the binding writing standard for reader-facing pages in
-`docs/product/`. It is inspired by the progressive, task-focused structure of
-the [Claude Platform documentation](https://platform.claude.com/docs/en/home),
-but it uses Personal Jarvis terminology, behavior, and renderer capabilities.
+`docs/product/`. Use a progressive, task-focused structure with Personal Jarvis
+terminology, behavior, and renderer capabilities. Describe features directly,
+without naming other products as design references. Preserve required license
+and attribution notices and factual integration or compatibility information.
The reader should understand what a feature does, why it matters, how to use
it, how it connects to the rest of Jarvis, and what to do when it does not
diff --git a/docs/superpowers/specs/2026-06-20-team-proxy-api-keys-design.md b/docs/superpowers/specs/2026-06-20-team-proxy-api-keys-design.md
index 900fc20bc5..0889f9db00 100644
--- a/docs/superpowers/specs/2026-06-20-team-proxy-api-keys-design.md
+++ b/docs/superpowers/specs/2026-06-20-team-proxy-api-keys-design.md
@@ -13,9 +13,9 @@ Today every Jarvis install holds its own provider credentials per machine
(`get_secret`: Windows Credential Manager → ENV → `.env`). That is the
"solo / local key" model.
-This feature adds a **second, team-shareable mode** modelled on the
-"Serverlink" pattern: one set of real vendor keys lives **server-side** on a
-small hosted proxy; each Jarvis client stores only a **proxy URL + a per-user
+This feature adds a **second, team-shareable mode**: one set of real vendor
+keys lives **server-side** on a small hosted proxy; each Jarvis client stores
+only a **proxy URL + a per-user
token** and never sees a real vendor key. The proxy swaps the per-user token
for the real key, forwards to the vendor, and records usage.
diff --git a/jarvis/appshot/picker/renderer.py b/jarvis/appshot/picker/renderer.py
index 48d99c6d2d..a604f5bd62 100644
--- a/jarvis/appshot/picker/renderer.py
+++ b/jarvis/appshot/picker/renderer.py
@@ -1,4 +1,4 @@
-"""PySide6 area picker for region appshots, modelled on ShareX's region capture.
+"""PySide6 area picker for region appshots.
Runs ONLY inside ``python -m jarvis.appshot.picker``; the main process never
imports this module (AP-26). One frameless, always-on-top window per screen:
diff --git a/jarvis/ui/web/frontend/src/views/AppshotEditor.tsx b/jarvis/ui/web/frontend/src/views/AppshotEditor.tsx
index cbd9b6f923..5853a4dc13 100644
--- a/jarvis/ui/web/frontend/src/views/AppshotEditor.tsx
+++ b/jarvis/ui/web/frontend/src/views/AppshotEditor.tsx
@@ -38,8 +38,8 @@ import { cn } from "@/lib/utils";
import { useEventStore } from "@/store/events";
/**
- * The appshot editor — annotate the last appshot the way ShareX's image
- * editor does: arrow, rectangle, ellipse, pen, highlighter, text, pixelate and
+ * The appshot editor — annotate the last appshot with arrow, rectangle,
+ * ellipse, pen, highlighter, text, pixelate and
* crop, with undo/redo. The result can be copied, saved, or put back in place
* of the appshot so the next message carries the edited picture.
*