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.

fix(onboarding): clearer key and subscription steps, skip-all, one progress counter

rubenluetke10-beep5a5ce20493fc
diff --git a/jarvis/ui/web/frontend/src/components/JarvisAgentSection.tsx b/jarvis/ui/web/frontend/src/components/JarvisAgentSection.tsx
index 578f7cfcca..3899cf1fa1 100644
--- a/jarvis/ui/web/frontend/src/components/JarvisAgentSection.tsx
+++ b/jarvis/ui/web/frontend/src/components/JarvisAgentSection.tsx
@@ -384,6 +384,7 @@ export function JarvisAgentSection({
title="Coding CLIs"
hint="sign in with a subscription — no key"
testId="agent-group-clis"
+ tourId="apikeys-subscriptions"
>
{codexRow && (
<CodexConnectionCard
@@ -638,16 +639,19 @@ function AgentGroup({
title,
hint,
testId,
+ tourId,
children,
}: {
icon: LucideIcon;
title: string;
hint: string;
testId?: string;
+ /** A stable hook for the first-run guide (`data-tour`). */
+ tourId?: string;
children: React.ReactNode;
}) {
return (
- <div data-testid={testId} className="space-y-2">
+ <div data-testid={testId} data-tour={tourId} className="space-y-2">
<div className="flex min-w-0 items-center gap-2 px-0.5 text-xs">
<Icon aria-hidden="true" className="h-3.5 w-3.5 shrink-0 text-primary" />
<span className="font-display text-meta font-semibold tracking-tight">{title}</span>
diff --git a/jarvis/ui/web/frontend/src/components/onboarding/OnboardingGate.test.tsx b/jarvis/ui/web/frontend/src/components/onboarding/OnboardingGate.test.tsx
index 2cd5298c6f..d3a0d41e4c 100644
--- a/jarvis/ui/web/frontend/src/components/onboarding/OnboardingGate.test.tsx
+++ b/jarvis/ui/web/frontend/src/components/onboarding/OnboardingGate.test.tsx
@@ -2,10 +2,25 @@ import { act, cleanup, render, screen, waitFor } from "@testing-library/react";
import { afterEach, expect, it, vi } from "vitest";
vi.mock("./setup/SetupTour", () => ({
- SetupTour: ({ preview, startAt, onFinished }: { preview: boolean; startAt?: string; onFinished: () => void }) => (
- <button type="button" data-testid="guide" data-preview={String(preview)} data-start={startAt ?? ""} onClick={onFinished}>
- guide
- </button>
+ SetupTour: ({
+ preview,
+ startAt,
+ onFinished,
+ onSkipAll,
+ }: {
+ preview: boolean;
+ startAt?: string;
+ onFinished: () => void;
+ onSkipAll?: () => void;
+ }) => (
+ <>
+ <button type="button" data-testid="guide" data-preview={String(preview)} data-start={startAt ?? ""} onClick={onFinished}>
+ guide
+ </button>
+ <button type="button" data-testid="guide-skip-all" onClick={onSkipAll}>
+ skip
+ </button>
+ </>
),
}));
vi.mock("./tour/GuidedTour", () => ({
@@ -230,3 +245,29 @@ it("starts the first-steps guide on request from Settings", async () => {
});
await waitFor(() => expect(screen.getByTestId("first-steps")).toBeDefined());
});
+
+it("skips the whole first run: tour recorded, onboarding completed, no guide left", async () => {
+ const fetchMock = stub({ ...base, completed: false, tour_completed: false });
+ render(<OnboardingGate activeSection="chats" />);
+ const skip = await screen.findByTestId("guide-skip-all");
+ act(() => skip.click());
+ const urls = () => fetchMock.mock.calls.map((c) => String(c[0]));
+ await waitFor(() => expect(urls()).toContain("/api/onboarding/complete"));
+ expect(urls()).toContain("/api/onboarding/tour-complete");
+ expect(screen.queryByTestId("guide")).toBeNull();
+ expect(screen.queryByTestId("tour")).toBeNull();
+});
+
+it("starts the first-steps guide fresh at the end of a real first run, even if an old one was closed", async () => {
+ window.localStorage.setItem(
+ "jarvis.firstSteps.v1",
+ JSON.stringify({ status: "dismissed", done: [], skipped: [], current: "wake", collapsed: false }),
+ );
+ stub({ ...base, completed: false, tour_completed: false });
+ render(<OnboardingGate activeSection="chats" />);
+ const guide = await screen.findByTestId("guide");
+ act(() => guide.click());
+ const tour = await screen.findByTestId("tour");
+ act(() => tour.click());
+ await waitFor(() => expect(screen.getByTestId("first-steps")).toBeDefined());
+});
diff --git a/jarvis/ui/web/frontend/src/components/onboarding/OnboardingGate.tsx b/jarvis/ui/web/frontend/src/components/onboarding/OnboardingGate.tsx
index 031bb3b124..49bf2e6999 100644
--- a/jarvis/ui/web/frontend/src/components/onboarding/OnboardingGate.tsx
+++ b/jarvis/ui/web/frontend/src/components/onboarding/OnboardingGate.tsx
@@ -119,6 +119,22 @@ export function OnboardingGate({ activeSection }: { activeSection?: string } = {
onb={onb}
preview={asked && onb.state.completed}
startAt={replaying && onb.state.completed ? "how" : undefined}
+ onSkipAll={() => {
+ // A replay just closes; a real first run is recorded as done
+ // (tour included) and gets its one completion restart.
+ setSetupReplay(0);
+ setDismissed(true);
+ if (asked && onb.state?.completed) return;
+ void (async () => {
+ await onb.completeTour();
+ try {
+ await onb.complete();
+ } catch (e) {
+ // The next start offers the setup again, so nothing is lost.
+ console.warn("onboarding: skipping setup failed", e);
+ }
+ })();
+ }}
onFinished={() => {
if (!(asked && onb.state?.completed)) setCompleteAfterTour(true);
setSetupReplay(0);
@@ -143,7 +159,10 @@ export function OnboardingGate({ activeSection }: { activeSection?: string } = {
setTourRequested(false);
// The first tour hands over to the first-steps guide. Written
// before the completion restart, so the guide is there after it.
- if (readFirstSteps() === null) {
+ // A real first run always starts it fresh (an install that was
+ // reset to a new user gets it again); a later tour replay only
+ // when the guide was never met.
+ if (completeAfterTour || readFirstSteps() === null) {
const fresh = freshState();
writeFirstSteps(fresh);
setFirstSteps(fresh);
diff --git a/jarvis/ui/web/frontend/src/components/onboarding/firstSteps/FirstStepsGuide.tsx b/jarvis/ui/web/frontend/src/components/onboarding/firstSteps/FirstStepsGuide.tsx
index 44b0017932..b62a172f48 100644
--- a/jarvis/ui/web/frontend/src/components/onboarding/firstSteps/FirstStepsGuide.tsx
+++ b/jarvis/ui/web/frontend/src/components/onboarding/firstSteps/FirstStepsGuide.tsx
@@ -173,7 +173,7 @@ export function FirstStepsGuide({
FOCUS_RING,
)}
>
- <GuidePetFigure state="idle" px={32} />
+ <GuidePetFigure state="idle" px={48} />
<span className="font-medium">{t("first_steps.title")}</span>
<span className="text-xs text-muted-foreground">{progress}</span>
<ChevronUp aria-hidden className="h-3.5 w-3.5 text-muted-foreground" />
@@ -222,7 +222,7 @@ export function FirstStepsGuide({
text={line}
state={finished || isDone ? "success" : PET[quest.id]}
heading={heading}
- px={88}
+ px={96}
testId="first-steps-say"
>
{!finished && !isDone && quest.action.kind === "send" && (
diff --git a/jarvis/ui/web/frontend/src/components/onboarding/setup/HowWalk.tsx b/jarvis/ui/web/frontend/src/components/onboarding/setup/HowWalk.tsx
index aa392c697f..de37ef9bda 100644
--- a/jarvis/ui/web/frontend/src/components/onboarding/setup/HowWalk.tsx
+++ b/jarvis/ui/web/frontend/src/components/onboarding/setup/HowWalk.tsx
@@ -52,11 +52,38 @@ export const HOW_BEATS: readonly HowBeat[] = [
];
const BUBBLE_W = 500;
+const BEAT_KEY = "jarvis.setup.howBeat";
+
+/** The beat to resume on: a remount (a reload, a late locale load) keeps the place. */
+function readBeat(): number {
+ try {
+ const n = Number(window.sessionStorage.getItem(BEAT_KEY));
+ return Number.isInteger(n) && n > 0 && n < HOW_BEATS.length ? n : 0;
+ } catch {
+ return 0;
+ }
+}
+
+function saveBeat(n: number | null): void {
+ try {
+ if (n === null) window.sessionStorage.removeItem(BEAT_KEY);
+ else window.sessionStorage.setItem(BEAT_KEY, String(n));
+ } catch {
+ // Storage may be blocked; the walk then starts over after a reload.
+ }
+}
export function HowWalk({ onDone }: { onDone: () => void }) {
const t = useT();
const pet = useGuidePet();
- const [index, setIndex] = useState(0);
+ const [index, setIndexRaw] = useState(readBeat);
+ const setIndex = useCallback((update: (i: number) => number) => {
+ setIndexRaw((i) => {
+ const n = update(i);
+ saveBeat(n);
+ return n;
+ });
+ }, []);
const beat = HOW_BEATS[index];
const last = index === HOW_BEATS.length - 1;
@@ -72,10 +99,15 @@ export function HowWalk({ onDone }: { onDone: () => void }) {
const rect = useAnchorRect(beat.anchor, false, beat.id);
+ const done = useCallback(() => {
+ saveBeat(null);
+ onDone();
+ }, [onDone]);
+
const next = useCallback(() => {
- if (last) onDone();
- else setIndex((i) => i + 1);
- }, [last, onDone]);
+ if (last) done();
+ else setIndex((i) => Math.min(HOW_BEATS.length - 1, i + 1));
+ }, [last, done, setIndex]);
// Arrow keys move through the walk.
useEffect(() => {
@@ -85,7 +117,7 @@ export function HowWalk({ onDone }: { onDone: () => void }) {
};
window.addEventListener("keydown", onKey);
return () => window.removeEventListener("keydown", onKey);
- }, [next]);
+ }, [next, setIndex]);
const text = fill(t(`first_run.how.beats.${beat.id}`), { pet: pet?.name ?? "Gigi" });
@@ -122,11 +154,26 @@ export function HowWalk({ onDone }: { onDone: () => void }) {
{t("first_run.how.prev")}
</QuietAction>
)}
- <span className="ml-auto text-xs text-muted-foreground">
- {fill(t("first_run.how.beat_of"), { current: index + 1, total: HOW_BEATS.length })}
+ {/* Progress inside this one setup step: dots, no second number
+ next to the setup's own "2 of 6". */}
+ <span
+ className="ml-auto flex items-center gap-1"
+ role="img"
+ aria-label={fill(t("first_run.how.beat_of"), { current: index + 1, total: HOW_BEATS.length })}
+ data-testid="how-progress"
+ >
+ {HOW_BEATS.map((b, i) => (
+ <span
+ key={b.id}
+ className={cn(
+ "h-1.5 rounded-full transition-all duration-200",
+ i === index ? "w-4 bg-accent" : i < index ? "w-1.5 bg-foreground/50" : "w-1.5 bg-border-strong",
+ )}
+ />
+ ))}
</span>
{!last && (
- <QuietAction onClick={onDone} className="text-xs" testId="how-skip">
+ <QuietAction onClick={done} className="text-xs" testId="how-skip">
{t("first_run.how.skip")}
</QuietAction>
)}
diff --git a/jarvis/ui/web/frontend/src/components/onboarding/setup/SetupTour.test.tsx b/jarvis/ui/web/frontend/src/components/onboarding/setup/SetupTour.test.tsx
index 9b69917fe5..6509aacd95 100644
--- a/jarvis/ui/web/frontend/src/components/onboarding/setup/SetupTour.test.tsx
+++ b/jarvis/ui/web/frontend/src/components/onboarding/setup/SetupTour.test.tsx
@@ -285,3 +285,17 @@ it("starts a replay from Settings at the explainer", async () => {
await waitFor(() => expect(screen.getByTestId("setup-card").dataset.step).toBe("how"));
expect(screen.queryByTestId("setup-back")).toBeNull();
});
+
+it("lets the welcome skip the whole setup", async () => {
+ const onSkipAll = vi.fn();
+ render(<SetupTour onb={fakeOnb()} preview={false} onFinished={vi.fn()} onSkipAll={onSkipAll} />);
+ fireEvent.click(await screen.findByTestId("setup-skip-all"));
+ expect(onSkipAll).toHaveBeenCalled();
+});
+
+it("says what a key is for: live voice needs OpenAI or Gemini", async () => {
+ providers = [{ ...openai, configured: true, secrets_set: { openai_api_key: true } }];
+ render(<SetupTour onb={fakeOnb({ ...accepted, current_step: "keys" })} preview={false} onFinished={vi.fn()} />);
+ const live = await screen.findByTestId("setup-keys-live");
+ await waitFor(() => expect(live.dataset.tone).toBe("ok"));
+});
diff --git a/jarvis/ui/web/frontend/src/components/onboarding/setup/SetupTour.tsx b/jarvis/ui/web/frontend/src/components/onboarding/setup/SetupTour.tsx
index 33743274d6..5039dfc182 100644
--- a/jarvis/ui/web/frontend/src/components/onboarding/setup/SetupTour.tsx
+++ b/jarvis/ui/web/frontend/src/components/onboarding/setup/SetupTour.tsx
@@ -56,11 +56,14 @@ export function SetupTour({
onb,
preview,
onFinished,
+ onSkipAll,
startAt,
}: {
onb: Onb;
preview: boolean;
onFinished: () => void;
+ /** "Skip setup" on the welcome: ends the whole first-run guide. */
+ onSkipAll?: () => void;
startAt?: SetupStepId;
}) {
const t = useT();
@@ -194,7 +197,7 @@ export function SetupTour({
</div>
</div>
<div className="mt-4">
- {stepId === "welcome" && <WelcomeStep onStart={() => { cheer(); next(); }} />}
+ {stepId === "welcome" && <WelcomeStep onStart={() => { cheer(); next(); }} onSkipAll={onSkipAll} />}
{stepId === "keys" && <KeysStep next={next} later={later} cheer={cheer} />}
{stepId === "subscriptions" && <SubscriptionsStep next={next} later={later} />}
{stepId === "voice" && <VoiceStep next={next} later={later} />}
@@ -209,7 +212,7 @@ export function SetupTour({
/* ------------------------------------------------------------------ steps */
-function WelcomeStep({ onStart }: { onStart: () => void }) {
+function WelcomeStep({ onStart, onSkipAll }: { onStart: () => void; onSkipAll?: () => void }) {
const t = useT();
const lang = useUiLanguage();
return (
@@ -233,6 +236,13 @@ function WelcomeStep({ onStart }: { onStart: () => void }) {
))}
</div>
<PrimaryAction onClick={onStart}>{t("first_run.welcome.start")}</PrimaryAction>
+ {onSkipAll && (
+ <div className="text-center">
+ <QuietAction onClick={onSkipAll} testId="setup-skip-all" className="text-xs">
+ {t("first_run.welcome.skip_all")}
+ </QuietAction>
+ </div>
+ )}
</div>
);
}
@@ -274,6 +284,11 @@ function KeysStep({ next, later, cheer }: { next: () => void; later: () => void;
}, []);
const withKey = providers.filter((p) => (p.secret_keys?.length ?? 0) > 0 && slotEffective(p));
+ // Live voice (talk and get an instant answer) needs a key one of the
+ // realtime starter plans runs on; any other key still runs chat and the
+ // classic voice (speech to text, answer read aloud).
+ const startableNow = startableProviders(providers);
+ const liveVoice = plans.some((p) => p.mode === "realtime" && planKeysComplete(p, startableNow));
const localBrain = providers.some((p) => p.tier === "brain" && p.active && (p.secret_keys?.length ?? 0) === 0);
const hasKey = withKey.length > 0 || localBrain;
@@ -325,6 +340,19 @@ function KeysStep({ next, later, cheer }: { next: () => void; later: () => void;
<Status tone="muted" testId="setup-keys-waiting">{t("first_run.keys.waiting")}</Status>
)}
{partial && <Status tone="warning">{fill(t("first_run.keys.partial"), { parts: partial })}</Status>}
+ {hasKey && !connecting && (
+ <Status tone={liveVoice ? "ok" : "muted"} testId="setup-keys-live">
+ {liveVoice ? t("first_run.keys.live_ready") : t("first_run.keys.live_missing")}
+ </Status>
+ )}
+ {!hasKey && (
+ <p className="text-xs leading-relaxed text-muted-foreground" data-testid="setup-keys-nokey">
+ {t("first_run.keys.no_key")}
+ </p>
+ )}
+ {hasKey && !connecting && (
+ <p className="text-xs leading-relaxed text-muted-foreground">{t("first_run.keys.next_hint")}</p>
+ )}
<p className="flex items-start gap-1.5 text-xs leading-relaxed text-muted-foreground">
<Lock aria-hidden className="mt-0.5 h-3 w-3 shrink-0" />
{t("first_run.keys.security")}
diff --git a/jarvis/ui/web/frontend/src/components/onboarding/setup/setupSteps.test.ts b/jarvis/ui/web/frontend/src/components/onboarding/setup/setupSteps.test.ts
index e6644a989d..8620ddb985 100644
--- a/jarvis/ui/web/frontend/src/components/onboarding/setup/setupSteps.test.ts
+++ b/jarvis/ui/web/frontend/src/components/onboarding/setup/setupSteps.test.ts
@@ -45,7 +45,8 @@ describe("setup steps", () => {
for (const id of SETUP_STEP_IDS) {
const anchor = SETUP_STEPS[id].anchor;
if (!anchor) continue;
- const literal = code.includes(`data-tour="${anchor}"`);
+ // A literal hook, or one handed to a component as its `tourId`.
+ const literal = code.includes(`data-tour="${anchor}"`) || code.includes(`tourId="${anchor}"`);
// Settings groups get theirs from a template: data-tour={`settings-${section.id}`}.
const group = anchor.startsWith("settings-") && code.includes("data-tour={`settings-${section.id}`}");
expect(literal || group, anchor).toBe(true);
@@ -56,8 +57,7 @@ describe("setup steps", () => {
const code = sources(SRC)
.filter((f) => !f.includes(join("components", "onboarding")))
.map((f) => readFileSync(f, "utf8"))
- .join("
-");
+ .join("\n");
for (const beat of HOW_BEATS) {
if (!beat.anchor) continue;
const literal = code.includes(`data-tour="${beat.anchor}"`);
diff --git a/jarvis/ui/web/frontend/src/components/onboarding/setup/setupSteps.ts b/jarvis/ui/web/frontend/src/components/onboarding/setup/setupSteps.ts
index 159b7dc472..0e454de337 100644
--- a/jarvis/ui/web/frontend/src/components/onboarding/setup/setupSteps.ts
+++ b/jarvis/ui/web/frontend/src/components/onboarding/setup/setupSteps.ts
@@ -39,7 +39,10 @@ export const SETUP_STEPS: Record<SetupStepId, SetupStep> = {
id: "subscriptions",
section: "apikeys",
apiKeysTab: "subagents",
- anchor: "apikeys-page",
+ // The subscription rows themselves (Connect buttons), scrolled into view —
+ // the tab opens on model settings further up.
+ anchor: "apikeys-subscriptions",
+ scrollTo: true,
placement: "left",
width: 340,
},
diff --git a/jarvis/ui/web/frontend/src/components/onboarding/tour/GuidedTour.tsx b/jarvis/ui/web/frontend/src/components/onboarding/tour/GuidedTour.tsx
index 28329143d9..20bc96d2a8 100644
--- a/jarvis/ui/web/frontend/src/components/onboarding/tour/GuidedTour.tsx
+++ b/jarvis/ui/web/frontend/src/components/onboarding/tour/GuidedTour.tsx
@@ -216,7 +216,7 @@ export function GuidedTour({ onDone }: { onDone: () => void }) {
return (
<Spotlight rect={rect} placement={step.placement} cardWidth={460}>
<div role="dialog" aria-live="polite" aria-label={t("app_tour.label")} data-testid="tour-card" data-step={step.id}>
- <PetSays key={step.id} text={t(`app_tour.steps.${step.id}`)} state={step.pet} px={80} testId="tour-text">
+ <PetSays key={step.id} text={t(`app_tour.steps.${step.id}`)} state={step.pet} px={96} testId="tour-text">
<div className="mt-3 flex items-center gap-3">
<button
ref={nextButton}
diff --git a/jarvis/ui/web/frontend/src/components/onboarding/tour/Spotlight.tsx b/jarvis/ui/web/frontend/src/components/onboarding/tour/Spotlight.tsx
index 9018fa185f..6fc80f79e4 100644
--- a/jarvis/ui/web/frontend/src/components/onboarding/tour/Spotlight.tsx
+++ b/jarvis/ui/web/frontend/src/components/onboarding/tour/Spotlight.tsx
@@ -6,6 +6,8 @@ import { EASE_OUT } from "../ui";
import { cutout, fitToView, padded, placeCard, type Rect, type TourPlacement } from "./tourSteps";
const CARD_W = 320;
+/** Narrowest a card may shrink to so it fits beside its element. */
+const MIN_SIDE_CARD_W = 240;
function useViewport(): { w: number; h: number } {
const [view, setView] = useState(() => ({ w: window.innerWidth, h: window.innerHeight }));
@@ -83,7 +85,14 @@ export function Spotlight({
// so the same clip-path shape still animates.
const point: Rect = { x: view.w / 2, y: view.h / 2, w: 0, h: 0 };
const clip = cutout(!settled ? whole : hole ?? point);
- const width = Math.min(cardWidth, view.w - 24);
+ // A card beside a big element (a whole settings page) must not lie over
+ // the part being set up: when the side it goes on is narrower than the
+ // card but still readable, the card narrows to fit there instead.
+ let width = Math.min(cardWidth, view.w - 24);
+ if (hole && (placement === "left" || placement === "right")) {
+ const room = placement === "left" ? hole.x - 14 - 12 : view.w - (hole.x + hole.w) - 14 - 12;
+ if (room < width && room >= MIN_SIDE_CARD_W) width = room;
+ }
const pos = placeCard(hole, placement, { w: width, h: cardH }, view);
const glide = reduced ? "none" : "clip-path 320ms cubic-bezier(0.22,1,0.36,1)";
const ringGlide = reduced
@@ -91,7 +100,15 @@ export function Spotlight({
: "transform 320ms cubic-bezier(0.22,1,0.36,1), width 320ms cubic-bezier(0.22,1,0.36,1), height 320ms cubic-bezier(0.22,1,0.36,1)";
return createPortal(
- <div className="pointer-events-none fixed inset-0 z-[110]" data-testid="tour-layer" {...{ [TOUR_LAYER_ATTR]: "" }}>
+ // aria-live keeps the guide reachable for assistive tech while a modal it
+ // points into (the Settings dialog) hides everything else from it — the
+ // modal's aria-hidden pass spares live regions.
+ <div
+ className="pointer-events-none fixed inset-0 z-[110]"
+ data-testid="tour-layer"
+ aria-live="polite"
+ {...{ [TOUR_LAYER_ATTR]: "" }}
+ >
<div
aria-hidden
className={blocking ? "pointer-events-auto absolute inset-0 bg-scrim/70" : "absolute inset-0 bg-scrim/60"}
diff --git a/jarvis/ui/web/frontend/src/i18n/locales/onboarding/de.json b/jarvis/ui/web/frontend/src/i18n/locales/onboarding/de.json
index 47ddb280e4..0139b46c7e 100644
--- a/jarvis/ui/web/frontend/src/i18n/locales/onboarding/de.json
+++ b/jarvis/ui/web/frontend/src/i18n/locales/onboarding/de.json
@@ -4,6 +4,7 @@
"continue": "Weiter",
"step_of": "{current} von {total}",
"welcome": {
+ "skip_all": "Einrichtung überspringen, ich kenne mich aus",
"title": "Willkommen",
"lede": "Zuerst ein kurzer Blick darauf, was {name} ist und wie es funktioniert. Danach richten wir es direkt hier in der App ein: einen API-Schlüssel, ein Abo für deine Agents und dein Weckwort.",
"language": "Sprache",
@@ -19,7 +20,7 @@
"prev": "Zurück",
"skip": "Überspringen",
"finish": "Jetzt einrichten",
- "beat_of": "{current} / {total}",
+ "beat_of": "Erklärung {current} von {total}",
"beats": {
"hello": "Hi, ich bin {pet}! Bevor wir etwas einrichten, zeig ich dir, wie {name} funktioniert. Geht schnell, und du siehst dabei die echte App.",
"talk": "Hier fängt alles an. Du sprichst mit einem einzigen Assistenten: {name}. Tipp hier oder drück den runden Knopf und sprich einfach. Du wählst nie selbst ein Werkzeug oder Modell; {name} entscheidet, was gebraucht wird.",
@@ -30,12 +31,16 @@
"results": "Was dabei herauskommt, also Seiten, Berichte oder Bilder, landet in Artifacts. Kurze Antworten kommen direkt im Chat oder laut gesprochen zurück.",
"memory": "{name} merkt sich auch Dinge. Was du erzählst, landet in seinen Notizen und deinem Profil, gespeichert auf deinem Computer. So musst du dich nie wiederholen.",
"safety": "Und du behältst die Kontrolle. Harmloses passiert einfach. Alles, was etwas sendet, löscht oder Geld kostet, wartet zuerst auf dein Ja.",
- "done": "Das ist die ganze Idee: Du sprichst, {name} denkt nach, nutzt Werkzeuge, holt Agents dazu und bringt dir das Ergebnis. Jetzt geben wir ihm ein Gehirn."
+ "done": "Das ist die ganze Idee: Du sprichst, {name} denkt nach, nutzt Werkzeuge, holt Agents dazu und bringt dir das Ergebnis. Später nicht weiter? Frag einfach {name}. Jetzt geben wir ihm ein Gehirn."
}
},
"keys": {
+ "next_hint": "Als Nächstes: Verbinde die Abos, die du schon bezahlst, damit deine Agents arbeiten können.",
+ "no_key": "Noch kein Schlüssel? Ein kostenloses lokales Modell geht auch (Einstellungen → Lokale Modelle), oder überspring es und füg später einen hinzu. Ganz ohne bleiben Chat und Stimme aus.",
+ "live_missing": "Der Chat läuft. Für die Live-Stimme brauchst du einen OpenAI- oder Gemini-Schlüssel; bis dahin spricht {name} auf die klassische Art, etwas langsamer.",
+ "live_ready": "Die Live-Stimme ist an: Du sprichst, und {name} antwortet sofort.",
"title": "Einen API-Schlüssel eintragen",
- "lede": "Dein Assistent braucht einen KI-Schlüssel, um zu denken und zu sprechen; ohne ihn bleiben Chat und Sprache aus. Das ist die Seite API-Keys: Füge einen Schlüssel in eine Anbieter-Karte ein und speichere ihn. Mit OpenAI oder Gemini reicht ein einziger Schlüssel für Live-Sprache.",
+ "lede": "Das ist die Seite API-Schlüssel. Füg einen Schlüssel in eine Anbieter-Karte ein und speichere ihn; mehr braucht {name} nicht, um zu denken und zu sprechen. Ein OpenAI- (ChatGPT) oder Google-Gemini-Schlüssel bringt zusätzlich die Live-Stimme.",
"waiting": "Warte auf einen Schlüssel…",
"connecting": "Alles wird eingeschaltet…",
"connected": "Verbunden: {provider}.",
@@ -46,10 +51,10 @@
},
"subscriptions": {
"title": "Verbinde ein Abo für deine Agents",
- "lede": "Das ist der Agents-Tab. Melde dich mit einem Abo an, das du schon bezahlst. Wir empfehlen Claude (Pro oder Max) oder ChatGPT (Codex). Klick in der Zeile auf Connect; dein Browser öffnet sich einmal.",
+ "lede": "Das ist der Tab Agents. Agents laufen am besten mit einem Abo, das du schon bezahlst; wir empfehlen Claude (Pro oder Max) oder ChatGPT (Codex). Klick in seiner Zeile auf Verbinden, dein Browser öffnet sich einmal.",
"waiting": "Noch kein Abo verbunden…",
"connected": "Verbunden: {names}.",
- "why": "Ein Abo kostet einen festen Monatspreis. So rechnen die größeren Aufgaben deiner Agents nicht pro Aufruf über deinen API-Schlüssel ab.",
+ "why": "Ein Abo ist ein fester Monatspreis. Ohne Abo nutzen die Agents deinen API-Schlüssel, und jeder Auftrag wird einzeln abgerechnet.",
"later": "Ich verbinde später eins"
},
"permissions": {
@@ -86,7 +91,7 @@
"finish": "Fertig",
"skip": "Tour überspringen",
"step_of": "{current} von {total}",
- "replay_title": "Einrichtung und App-Tour",
+ "replay_title": "Onboarding nochmal machen",
"replay_body": "Erklärt noch einmal, wie {name} funktioniert, führt dich durch die Einrichtung (API-Schlüssel, Abos für Agents, Weckwort) und danach durch den kurzen Rundgang. Nichts startet neu.",
"replay": "Wiederholen",
"steps": {
@@ -95,7 +100,7 @@
"agents_world": "Das ist das Verse, deine Agenten bei der Arbeit. Klick einen an, um mit ihm zu chatten oder ihm eine Aufgabe zu geben. Weiter bringt dich zurück.",
"voice_hub": "Unter Stimme findest du Diktat in jede App, deine eigene Wortliste und gesprochene Kürzel.",
"settings": "Hier findest du Einstellungen, API-Schlüssel, Kosten und dein Profil. Die Tour kannst du jederzeit unter Einstellungen → App wiederholen.",
- "done": "Das war die Tour. Du bist startklar: Sprich mit {name}, wann immer du willst."
+ "done": "Das war der Rundgang. Sprich mit {name}, wann immer du willst, und wenn du mal nicht weiterweißt, frag einfach {name}. Unter Einstellungen → App kannst du das Onboarding nochmal machen."
}
},
"first_steps": {
@@ -124,7 +129,7 @@
"replay_body": "Zehn kleine, echte Dinge zum Ausprobieren mit {name}: sprechen, Werkzeuge nutzen, sich etwas merken, etwas bauen, an Agents abgeben. Jedes wird erklärt, nachdem es passiert ist.",
"finished": {
"title": "Du kennst jetzt die Grundlagen!",
- "body": "Du hast {done} von {total} ersten Schritten geschafft. Ab jetzt sprichst du einfach mit {name}: Es entscheidet selbst, ob es antwortet, ein Werkzeug nutzt oder einen Agent dazuholt.",
+ "body": "Du hast {done} von {total} ersten Schritten geschafft. Ab jetzt sprichst du einfach mit {name}: Es entscheidet selbst, ob es antwortet, ein Werkzeug nutzt oder einen Agent dazuholt. Nicht weiter? Frag {name}.",
"close": "Schließen"
},
"quests": {
diff --git a/jarvis/ui/web/frontend/src/i18n/locales/onboarding/en.json b/jarvis/ui/web/frontend/src/i18n/locales/onboarding/en.json
index 27e391cb28..dadc8a0dcb 100644
--- a/jarvis/ui/web/frontend/src/i18n/locales/onboarding/en.json
+++ b/jarvis/ui/web/frontend/src/i18n/locales/onboarding/en.json
@@ -4,6 +4,7 @@
"continue": "Continue",
"step_of": "{current} of {total}",
"welcome": {
+ "skip_all": "Skip setup, I know my way around",
"title": "Welcome",
"lede": "First a short look at what {name} is and how it works. Then we set it up right here in the app: an API key, a subscription for your agents and your wake word.",
"language": "Language",
@@ -19,7 +20,7 @@
"prev": "Back",
"skip": "Skip",
"finish": "Let's set it up",
- "beat_of": "{current} / {total}",
+ "beat_of": "Explanation {current} of {total}",
"beats": {
"hello": "Hi, I'm {pet}! Before we set anything up, let me show you how {name} works. It's quick, and you'll see the real app while I explain.",
"talk": "Everything starts here. You talk to one assistant: {name}. Type here, or press the round button and just speak. You never pick a tool or a model yourself; {name} decides what's needed.",
@@ -30,12 +31,16 @@
"results": "Whatever comes out, like pages, reports or images, lands in Artifacts. Short answers come straight back in the chat or spoken aloud.",
"memory": "{name} also remembers. What you tell it goes into its notes and your profile, stored on your computer, so you never have to repeat yourself.",
"safety": "And you stay in control. Harmless things just happen. Anything that sends, deletes or costs money waits for your yes first.",
- "done": "That's the whole idea: you talk, {name} thinks, uses tools, brings in agents and hands you the result. Now let's give it a brain."
+ "done": "That's the whole idea: you talk, {name} thinks, uses tools, brings in agents and hands you the result. Stuck later? Just ask {name}. Now let's give it a brain."
}
},
"keys": {
+ "next_hint": "Next: connect the subscriptions you already pay for, so your agents can work.",
+ "no_key": "No key yet? A free local model works too (Settings → Local models), or skip and add one later. Without any, chat and voice stay off.",
+ "live_missing": "Chat works. Live voice needs an OpenAI or Gemini key; until then {name} speaks the classic way, a little slower.",
+ "live_ready": "Live voice is on: talk, and {name} answers right away.",
"title": "Add one API key",
- "lede": "Your assistant needs one AI key to think and talk; without it, chat and voice stay off. This is the API Keys page: paste one key into a provider card and save it. OpenAI or Gemini gives you live voice with a single key.",
+ "lede": "This is the API Keys page. Paste one key into a provider card and save it; that is all {name} needs to think and talk. An OpenAI (ChatGPT) or Google Gemini key also gives you live voice.",
"waiting": "Waiting for a key…",
"connecting": "Switching everything on…",
"connected": "Connected: {provider}.",
@@ -46,10 +51,10 @@
},
"subscriptions": {
"title": "Connect a subscription for your agents",
- "lede": "This is the Agents tab. Sign in with a subscription you already pay for. We recommend Claude (Pro or Max) or ChatGPT (Codex). Click Connect on its row; your browser opens once.",
+ "lede": "This is the Agents tab. Agents run best on a subscription you already pay for; we recommend Claude (Pro or Max) or ChatGPT (Codex). Click Connect on its row, and your browser opens once.",
"waiting": "No subscription connected yet…",
"connected": "Connected: {names}.",
- "why": "A subscription is a flat monthly price, so your agents' bigger jobs do not bill your API key per call.",
+ "why": "A subscription is a flat monthly price. Without one, agents use your API key and each job is billed per use.",
"later": "I'll connect one later"
},
"permissions": {
@@ -86,7 +91,7 @@
"finish": "Finish",
"skip": "Skip tour",
"step_of": "{current} of {total}",
- "replay_title": "Setup and app tour",
+ "replay_title": "Do the onboarding again",
"replay_body": "Explains again how {name} works, walks you through setup (API keys, agent subscriptions, wake word), then the short tour of the app. Nothing restarts.",
"replay": "Replay",
"steps": {
@@ -95,7 +100,7 @@
"agents_world": "This is the Verse, your agents at work. Click one to chat with it or hand it a job. Next brings you back.",
"voice_hub": "Voice holds dictation into any app, your own word list and spoken shortcuts.",
"settings": "Settings, API keys, costs and your profile live here. You can replay this tour anytime from Settings → App.",
- "done": "That's the tour. You're ready: talk to {name} whenever you like."
+ "done": "That's the tour. Talk to {name} whenever you like, and if you're ever stuck, just ask {name}. Settings → App runs the onboarding again."
}
},
"first_steps": {
@@ -124,7 +129,7 @@
"replay_body": "Ten small, real things to try with {name}: talk, use tools, remember, build, hand off to agents. Each one is explained after it happened.",
"finished": {
"title": "You've got the basics!",
- "body": "You completed {done} of {total} first steps. From now on, just talk to {name}: it decides whether to answer, use a tool or bring in an agent.",
+ "body": "You completed {done} of {total} first steps. From now on, just talk to {name}: it decides whether to answer, use a tool or bring in an agent. Stuck? Ask {name}.",
"close": "Close"
},
"quests": {
diff --git a/jarvis/ui/web/frontend/src/i18n/locales/onboarding/es.json b/jarvis/ui/web/frontend/src/i18n/locales/onboarding/es.json
index 43cfb04b9e..fd6603ebd5 100644
--- a/jarvis/ui/web/frontend/src/i18n/locales/onboarding/es.json
+++ b/jarvis/ui/web/frontend/src/i18n/locales/onboarding/es.json
@@ -4,6 +4,7 @@
"continue": "Continuar",
"step_of": "{current} de {total}",
"welcome": {
+ "skip_all": "Saltar la configuración, ya me oriento",
"title": "Bienvenido",
"lede": "Primero, un vistazo rápido a qué es {name} y cómo funciona. Después lo configuramos aquí mismo, en la aplicación: una clave de API, una suscripción para tus agentes y tu palabra de activación.",
"language": "Idioma",
@@ -19,7 +20,7 @@
"prev": "Atrás",
"skip": "Saltar",
"finish": "A configurarlo",
- "beat_of": "{current} / {total}",
+ "beat_of": "Explicación {current} de {total}",
"beats": {
"hello": "¡Hola, soy {pet}! Antes de configurar nada, te enseño cómo funciona {name}. Es rápido, y verás la aplicación real mientras te lo explico.",
"talk": "Todo empieza aquí. Hablas con un solo asistente: {name}. Escribe aquí, o pulsa el botón redondo y habla. Nunca eliges tú una herramienta o un modelo; {name} decide lo que hace falta.",
@@ -30,12 +31,16 @@
"results": "Lo que salga, como páginas, informes o imágenes, va a Artifacts. Las respuestas cortas vuelven directamente al chat o en voz alta.",
"memory": "{name} también recuerda. Lo que le cuentas va a sus notas y a tu perfil, guardados en tu ordenador, para que nunca tengas que repetirte.",
"safety": "Y tú mantienes el control. Lo inofensivo simplemente ocurre. Todo lo que envía, borra o cuesta dinero espera primero tu sí.",
- "done": "Esa es toda la idea: hablas, {name} piensa, usa herramientas, llama a agentes y te entrega el resultado. Ahora démosle un cerebro."
+ "done": "Esa es toda la idea: hablas, {name} piensa, usa herramientas, llama a agentes y te entrega el resultado. ¿Te atascas luego? Pregúntale a {name}. Ahora démosle un cerebro."
}
},
"keys": {
+ "next_hint": "Siguiente: conecta las suscripciones que ya pagas para que tus agentes puedan trabajar.",
+ "no_key": "¿Aún sin clave? También sirve un modelo local gratuito (Ajustes → Modelos locales), o sáltalo y añade una más tarde. Sin ninguna, el chat y la voz quedan apagados.",
+ "live_missing": "El chat funciona. La voz en directo necesita una clave de OpenAI o Gemini; mientras tanto {name} habla de la forma clásica, algo más lenta.",
+ "live_ready": "La voz en directo está activa: hablas y {name} responde al instante.",
"title": "Añade una clave de API",
- "lede": "Tu asistente necesita una clave de IA para pensar y hablar; sin ella, el chat y la voz siguen apagados. Esta es la página Claves API: pega una clave en la tarjeta de un proveedor y guárdala. Con OpenAI o Gemini basta una sola clave para la voz en directo.",
+ "lede": "Esta es la página de claves de API. Pega una clave en la tarjeta de un proveedor y guárdala; es todo lo que {name} necesita para pensar y hablar. Una clave de OpenAI (ChatGPT) o de Google Gemini también te da la voz en directo.",
"waiting": "Esperando una clave…",
"connecting": "Activando todo…",
"connected": "Conectado: {provider}.",
@@ -46,10 +51,10 @@
},
"subscriptions": {
"title": "Conecta una suscripción para tus agentes",
- "lede": "Esta es la pestaña Agentes. Inicia sesión con una suscripción que ya pagas. Te recomendamos Claude (Pro o Max) o ChatGPT (Codex). Pulsa Connect en su fila; tu navegador se abre una vez.",
+ "lede": "Esta es la pestaña Agentes. Los agentes funcionan mejor con una suscripción que ya pagas; recomendamos Claude (Pro o Max) o ChatGPT (Codex). Pulsa Conectar en su fila y tu navegador se abre una vez.",
"waiting": "Aún no hay ninguna suscripción conectada…",
"connected": "Conectado: {names}.",
- "why": "Una suscripción tiene un precio mensual fijo, así las tareas grandes de tus agentes no se cobran por llamada a tu clave de API.",
+ "why": "Una suscripción es un precio mensual fijo. Sin ella, los agentes usan tu clave de API y cada encargo se cobra por uso.",
"later": "Conectaré una más tarde"
},
"permissions": {
@@ -86,7 +91,7 @@
"finish": "Terminar",
"skip": "Saltar visita",
"step_of": "{current} de {total}",
- "replay_title": "Configuración y visita guiada",
+ "replay_title": "Hacer el onboarding de nuevo",
"replay_body": "Vuelve a explicar cómo funciona {name}, te guía por la configuración (claves de API, suscripciones de agentes, palabra de activación) y luego por la visita breve de la aplicación. Nada se reinicia.",
"replay": "Repetir",
"steps": {
@@ -95,7 +100,7 @@
"agents_world": "Este es el Verse, tus agentes trabajando. Haz clic en uno para chatear con él o darle una tarea. Siguiente te lleva de vuelta.",
"voice_hub": "En Voz tienes el dictado en cualquier aplicación, tu propia lista de palabras y atajos hablados.",
"settings": "Aquí están los ajustes, las claves de API, los costes y tu perfil. Puedes repetir esta visita cuando quieras en Ajustes → Aplicación.",
- "done": "Esa es la visita. Ya está todo listo: habla con {name} cuando quieras."
+ "done": "Esa fue la visita. Habla con {name} cuando quieras, y si alguna vez te atascas, pregúntale a {name}. En Ajustes → Aplicación puedes repetir el onboarding."
}
},
"first_steps": {
@@ -124,7 +129,7 @@
"replay_body": "Diez cosas pequeñas y reales para probar con {name}: hablar, usar herramientas, recordar, construir, pasar trabajo a agentes. Cada una se explica después de ocurrir.",
"finished": {
"title": "¡Ya dominas lo básico!",
- "body": "Completaste {done} de {total} primeros pasos. A partir de ahora, simplemente habla con {name}: decide si responde, usa una herramienta o llama a un agente.",
+ "body": "Completaste {done} de {total} primeros pasos. A partir de ahora, simplemente habla con {name}: decide si responde, usa una herramienta o llama a un agente. ¿Atascado? Pregúntale a {name}.",
"close": "Cerrar"
},
"quests": {