Skip to content

Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.

fix(web): unblock OpenCode Go onboarding and allow skipping setup (#170)

Leobbb5ceff4a0b
diff --git a/apps/web/src/components/onboarding/DesktopOnboarding.tsx b/apps/web/src/components/onboarding/DesktopOnboarding.tsx
index 3571467ca..7f21f02a5 100644
--- a/apps/web/src/components/onboarding/DesktopOnboarding.tsx
+++ b/apps/web/src/components/onboarding/DesktopOnboarding.tsx
@@ -29,6 +29,15 @@ import { useEnvironmentQuery } from "../../state/query";
import { primaryServerProvidersAtom, serverEnvironment } from "../../state/server";
import { environmentShell } from "../../state/shell";
import { useAtomCommand } from "../../state/use-atom-command";
+import {
+ AlertDialog,
+ AlertDialogClose,
+ AlertDialogDescription,
+ AlertDialogFooter,
+ AlertDialogHeader,
+ AlertDialogPopup,
+ AlertDialogTitle,
+} from "../ui/alert-dialog";
import { Button } from "../ui/button";
import { Input } from "../ui/input";
import { BotAvatarView } from "../roster/BotAvatarView";
@@ -46,6 +55,7 @@ import {
DESKTOP_ONBOARDING_USE_CASES,
type DesktopOnboardingDraft,
desktopOnboardingModelSelection,
+ markDesktopOnboardingCompleted,
parseDesktopOnboardingDraft,
recoverDisappearedDesktopOnboardingBot,
recoverMissingDesktopOnboardingBot,
@@ -183,6 +193,7 @@ function SubscriptionStep({
setBusy(false);
return;
}
+ setBusy(false);
setActiveLogin({ flow: result.value, error: null });
window.open(result.value.url, "_blank", "noopener,noreferrer");
};
@@ -664,6 +675,8 @@ function OnboardingSurface({
const [createError, setCreateError] = useState<string | null>(null);
const [message, setMessage] = useState<string | null>(null);
const [finishing, setFinishing] = useState(false);
+ const [skipConfirmOpen, setSkipConfirmOpen] = useState(false);
+ const surfaceRef = useRef<HTMLDivElement>(null);
const readyBotIdRef = useRef<string | null>(null);
const rosterBot = useRosterStore((state) =>
draft.botId ? state.bots.find((bot) => bot.id === draft.botId) : undefined,
@@ -730,8 +743,7 @@ function OnboardingSurface({
const finish = (firstMessage: string) => {
setMessage(firstMessage);
setFinishing(true);
- window.localStorage.removeItem(DESKTOP_ONBOARDING_STORAGE_KEY);
- window.localStorage.setItem(DESKTOP_ONBOARDING_COMPLETED_STORAGE_KEY, "1");
+ markDesktopOnboardingCompleted(window.localStorage);
const delay = reducedMotion ? 0 : 560;
window.setTimeout(() => {
if (draft.botId) {
@@ -742,9 +754,16 @@ function OnboardingSurface({
}, delay);
};
+ const skip = () => {
+ setSkipConfirmOpen(false);
+ markDesktopOnboardingCompleted(window.localStorage);
+ onFinished();
+ };
+
const step = stepNumber(draft.step);
return (
<motion.div
+ ref={surfaceRef}
data-testid="desktop-onboarding"
className="fixed inset-0 z-[10000] flex overflow-hidden bg-background text-foreground"
initial={reducedMotion ? false : { opacity: 0 }}
@@ -822,7 +841,17 @@ function OnboardingSurface({
</motion.div>
</AnimatePresence>
</div>
- <p className="text-[11px] text-muted-foreground/65">Step {step} of 4</p>
+ <div className="flex items-center justify-between gap-3">
+ <p className="text-[11px] text-muted-foreground/65">Step {step} of 4</p>
+ <Button
+ size="xs"
+ variant="ghost-muted"
+ disabled={creating || finishing}
+ onClick={() => setSkipConfirmOpen(true)}
+ >
+ Skip setup
+ </Button>
+ </div>
</motion.aside>
<motion.div
className="flex min-w-0 flex-1"
@@ -837,6 +866,20 @@ function OnboardingSurface({
onMessageSent={finish}
/>
</motion.div>
+ <AlertDialog open={skipConfirmOpen} onOpenChange={setSkipConfirmOpen}>
+ <AlertDialogPopup portalContainer={surfaceRef}>
+ <AlertDialogHeader>
+ <AlertDialogTitle>Skip setup?</AlertDialogTitle>
+ <AlertDialogDescription>
+ You can connect a subscription and create a bot later.
+ </AlertDialogDescription>
+ </AlertDialogHeader>
+ <AlertDialogFooter>
+ <AlertDialogClose render={<Button variant="outline" />}>Cancel</AlertDialogClose>
+ <Button onClick={skip}>Skip setup</Button>
+ </AlertDialogFooter>
+ </AlertDialogPopup>
+ </AlertDialog>
</motion.div>
);
}
diff --git a/apps/web/src/components/onboarding/desktopOnboarding.logic.test.ts b/apps/web/src/components/onboarding/desktopOnboarding.logic.test.ts
index f34df8b0c..fa40a6d92 100644
--- a/apps/web/src/components/onboarding/desktopOnboarding.logic.test.ts
+++ b/apps/web/src/components/onboarding/desktopOnboarding.logic.test.ts
@@ -3,6 +3,7 @@ import { describe, expect, it } from "vite-plus/test";
import {
DEFAULT_DESKTOP_ONBOARDING_DRAFT,
desktopOnboardingModelSelection,
+ markDesktopOnboardingCompleted,
parseDesktopOnboardingDraft,
recoverDisappearedDesktopOnboardingBot,
recoverMissingDesktopOnboardingBot,
@@ -126,6 +127,19 @@ describe("desktop onboarding", () => {
});
});
+ it("marks skipped onboarding complete and removes its draft", () => {
+ const values = new Map<string, string>([["akeru:desktop-onboarding:v1", "draft"]]);
+ const storage = {
+ removeItem: (key: string) => values.delete(key),
+ setItem: (key: string, value: string) => values.set(key, value),
+ };
+
+ markDesktopOnboardingCompleted(storage);
+
+ expect(values.get("akeru:desktop-onboarding:v1")).toBeUndefined();
+ expect(values.get("akeru:desktop-onboarding-completed:v1")).toBe("1");
+ });
+
it("does not restart after the completed user deletes every bot", () => {
expect(
shouldShowDesktopOnboarding({
@@ -200,15 +214,66 @@ describe("desktop onboarding", () => {
availability: "available" as const,
models: [{ slug: "claude-old" }, { slug: "claude-default", isDefault: true }],
},
+ {
+ instanceId: "opencodeGo",
+ driver: "opencodeGo",
+ enabled: true,
+ installed: true,
+ availability: "available" as const,
+ models: [{ slug: "gpt-5.6-luna", isDefault: true }],
+ },
];
expect(resolveDesktopOnboardingEngine("anthropic", providers)).toEqual({
provider: "claudeAgent",
model: "claude-default",
});
+ expect(resolveDesktopOnboardingEngine("opencode-go", providers)).toEqual({
+ provider: "opencodeGo",
+ model: "gpt-5.6-luna",
+ });
expect(resolveDesktopOnboardingEngine("xai", providers)).toBeNull();
expect(
desktopOnboardingModelSelection({ provider: "claudeAgent", model: "claude-default" }),
).toEqual({ instanceId: "claudeAgent", model: "claude-default" });
});
+
+ it.each([
+ ["openai-codex", "codex"],
+ ["anthropic", "claudeAgent"],
+ ["xai", "grok"],
+ ["kimi-for-coding", "kimi"],
+ ["opencode-go", "opencodeGo"],
+ ] as const)("restores and resolves the %s subscription", (providerId, driver) => {
+ const draft = { ...DEFAULT_DESKTOP_ONBOARDING_DRAFT, providerId };
+ const provider = {
+ instanceId: `${driver}-custom`,
+ driver,
+ enabled: true,
+ installed: true,
+ models: [{ slug: "first" }, { slug: "default", isDefault: true }],
+ };
+
+ expect(parseDesktopOnboardingDraft(JSON.stringify(draft))).toEqual(draft);
+ expect(resolveDesktopOnboardingEngine(providerId, [provider])).toEqual({
+ provider: provider.instanceId,
+ model: "default",
+ });
+ expect(
+ resolveDesktopOnboardingEngine(providerId, [{ ...provider, enabled: false }]),
+ ).toBeNull();
+ expect(
+ resolveDesktopOnboardingEngine(providerId, [{ ...provider, installed: false }]),
+ ).toBeNull();
+ expect(
+ resolveDesktopOnboardingEngine(providerId, [{ ...provider, availability: "unavailable" }]),
+ ).toBeNull();
+ expect(resolveDesktopOnboardingEngine(providerId, [{ ...provider, models: [] }])).toBeNull();
+ });
+
+ it("restores an OpenCode Go onboarding draft", () => {
+ const draft = { ...DEFAULT_DESKTOP_ONBOARDING_DRAFT, providerId: "opencode-go" as const };
+
+ expect(parseDesktopOnboardingDraft(JSON.stringify(draft))).toEqual(draft);
+ });
});
diff --git a/apps/web/src/components/onboarding/desktopOnboarding.logic.ts b/apps/web/src/components/onboarding/desktopOnboarding.logic.ts
index 9109500f0..fa8005d01 100644
--- a/apps/web/src/components/onboarding/desktopOnboarding.logic.ts
+++ b/apps/web/src/components/onboarding/desktopOnboarding.logic.ts
@@ -11,6 +11,13 @@ import { BLOB_COLORS, BLOB_SHAPES } from "../roster/roster.logic";
export const DESKTOP_ONBOARDING_STORAGE_KEY = "akeru:desktop-onboarding:v1";
export const DESKTOP_ONBOARDING_COMPLETED_STORAGE_KEY = "akeru:desktop-onboarding-completed:v1";
+export function markDesktopOnboardingCompleted(
+ storage: Pick<Storage, "removeItem" | "setItem">,
+): void {
+ storage.removeItem(DESKTOP_ONBOARDING_STORAGE_KEY);
+ storage.setItem(DESKTOP_ONBOARDING_COMPLETED_STORAGE_KEY, "1");
+}
+
export type DesktopOnboardingStep = "subscription" | "use-case" | "identity" | "message";
export type DesktopOnboardingUseCaseId =
| "inbox"
@@ -97,6 +104,7 @@ const providerIds: readonly SubscriptionProviderId[] = [
"anthropic",
"xai",
"kimi-for-coding",
+ "opencode-go",
];
const useCaseIds: readonly DesktopOnboardingUseCaseId[] = [
@@ -147,6 +155,7 @@ const subscriptionDriver: Readonly<Partial<Record<SubscriptionProviderId, string
anthropic: "claudeAgent",
xai: "grok",
"kimi-for-coding": "kimi",
+ "opencode-go": "opencodeGo",
};
export function resolveDesktopOnboardingEngine(
diff --git a/docs/user/bots.md b/docs/user/bots.md
index 6fe61dfbd..29f26ed86 100644
--- a/docs/user/bots.md
+++ b/docs/user/bots.md
@@ -2,6 +2,14 @@
Open a bot, then use the panel beside the conversation to edit it.
+## Skip initial setup
+
+Select **Skip setup** on any setup step, then confirm **Skip setup** in the dialog.
+Select **Cancel** to stay in setup. Skipping keeps any connected subscriptions and bots you already
+created. Setup will not open again after a restart.
+
+You can connect a subscription in Settings and use **Create** to add a bot later.
+
## Profile
You can change the bot's avatar, name, label, description, model, voice access, and enabled tools.