🙌 OpenHands: AI-Driven Development
feat(sidebar): add getting started checklist with settings toggle (#16182)
FraterCCCLXIII78068152d0d3
diff --git a/__tests__/components/features/sidebar/sidebar-onboarding-checklist-item-preview.test.tsx b/__tests__/components/features/sidebar/sidebar-onboarding-checklist-item-preview.test.tsxnew file mode 100644index 0000000000..2048d3cacd--- /dev/null+++ b/__tests__/components/features/sidebar/sidebar-onboarding-checklist-item-preview.test.tsx@@ -0,0 +1,90 @@+import { describe, expect, it } from "vitest";+import { render, screen } from "@testing-library/react";+import { SidebarOnboardingChecklistItemIcon } from "#/components/features/sidebar/sidebar-onboarding-checklist-item-icon";+import { SidebarOnboardingChecklistItemPreview } from "#/components/features/sidebar/sidebar-onboarding-checklist-item-preview";+import {+ NavigationProvider,+ type NavigationContextValue,+} from "#/context/navigation-context";+import { I18nKey } from "#/i18n/declaration";++const navigation: NavigationContextValue = {+ currentPath: "/",+ conversationId: null,+ isNavigating: false,+ navigate: () => undefined,+};++function renderPreview(id: Parameters<typeof SidebarOnboardingChecklistItemPreview>[0]["id"]) {+ return render(+ <NavigationProvider value={navigation}>+ <SidebarOnboardingChecklistItemPreview id={id} />+ </NavigationProvider>,+ );+}++describe("SidebarOnboardingChecklistItemIcon", () => {+ it.each([+ ["configure-llm", "sidebar-onboarding-checklist-icon-configure-llm"],+ ["start-conversation", "sidebar-onboarding-checklist-icon-start-conversation"],+ ["schedule-task", "sidebar-onboarding-checklist-icon-schedule-task"],+ ["customize-agent", "sidebar-onboarding-checklist-icon-customize-agent"],+ ["connect-mcp", "sidebar-onboarding-checklist-icon-connect-mcp"],+ ["join-slack", "sidebar-onboarding-checklist-icon-join-slack"],+ ] as const)("renders an icon for %s", (id, testId) => {+ render(<SidebarOnboardingChecklistItemIcon id={id} />);++ expect(screen.getByTestId(testId)).toBeInTheDocument();+ });+});++describe("SidebarOnboardingChecklistItemPreview", () => {+ it("renders title, icon, action button, and docs link", () => {+ renderPreview("configure-llm");++ expect(+ screen.getByTestId("sidebar-onboarding-checklist-preview-configure-llm"),+ ).toBeInTheDocument();+ expect(+ screen.getByText(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CONFIGURE_LLM),+ ).toBeInTheDocument();+ expect(+ screen.getByText(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CONFIGURE_LLM_DESC),+ ).toBeInTheDocument();+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-preview-action-configure-llm"),+ ).toHaveAttribute("href", "/settings/llm");+ expect(+ screen.getByText(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_ACTION_CONFIGURE_LLM),+ ).toBeInTheDocument();+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-preview-docs-configure-llm"),+ ).toHaveAttribute(+ "href",+ "https://docs.openhands.dev/openhands/usage/settings/llm-settings#llm-profiles",+ );+ expect(+ screen.getByText(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_DOCS_LINK),+ ).toBeInTheDocument();+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-icon-configure-llm"),+ ).toBeInTheDocument();+ });++ it("renders the Slack preview as an external invite action", () => {+ renderPreview("join-slack");++ expect(+ screen.getByTestId("sidebar-onboarding-checklist-preview-join-slack"),+ ).toBeInTheDocument();+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-preview-action-join-slack"),+ ).toHaveAttribute("href", "https://openhands.dev/joinslack");+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-preview-action-join-slack"),+ ).toHaveAttribute("target", "_blank");+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-preview-docs-join-slack"),+ ).toHaveAttribute("href", "https://docs.openhands.dev/overview/community");+ });+});diff --git a/__tests__/components/features/sidebar/sidebar-onboarding-checklist-llm-complete.test.ts b/__tests__/components/features/sidebar/sidebar-onboarding-checklist-llm-complete.test.tsnew file mode 100644index 0000000000..f2a7ba2a18--- /dev/null+++ b/__tests__/components/features/sidebar/sidebar-onboarding-checklist-llm-complete.test.ts@@ -0,0 +1,82 @@+import { describe, expect, it } from "vitest";+import { DEFAULT_SETTINGS } from "#/services/settings";+import { isConfigureLlmChecklistItemComplete } from "#/components/features/sidebar/sidebar-onboarding-checklist-llm-complete";++describe("isConfigureLlmChecklistItemComplete", () => {+ it("returns false while LLM readiness is still indeterminate", () => {+ expect(+ isConfigureLlmChecklistItemComplete(+ DEFAULT_SETTINGS,+ false,+ true,+ undefined,+ true,+ ),+ ).toBe(false);+ });++ it("returns true when useLlmConfigured reports configured", () => {+ expect(+ isConfigureLlmChecklistItemComplete(+ DEFAULT_SETTINGS,+ true,+ false,+ undefined,+ false,+ ),+ ).toBe(true);+ });++ it("returns true when any saved LLM profile has an API key", () => {+ expect(+ isConfigureLlmChecklistItemComplete(+ DEFAULT_SETTINGS,+ false,+ true,+ {+ active_profile: "work",+ profiles: [+ {+ name: "work",+ model: "openai/gpt-5.5",+ base_url: "https://api.openai.com/v1",+ api_key_set: true,+ },+ ],+ },+ false,+ ),+ ).toBe(true);+ });++ it("returns true when settings already have a model and API key", () => {+ expect(+ isConfigureLlmChecklistItemComplete(+ {+ ...DEFAULT_SETTINGS,+ llm_api_key_set: true,+ agent_settings: {+ ...(DEFAULT_SETTINGS.agent_settings ?? {}),+ llm: { model: "openai/gpt-5.5" },+ },+ },+ false,+ true,+ undefined,+ true,+ ),+ ).toBe(true);+ });++ it("returns false when no model or auth is present", () => {+ expect(+ isConfigureLlmChecklistItemComplete(+ DEFAULT_SETTINGS,+ false,+ false,+ { active_profile: null, profiles: [] },+ false,+ ),+ ).toBe(false);+ });+});diff --git a/__tests__/components/features/sidebar/sidebar-onboarding-checklist.test.tsx b/__tests__/components/features/sidebar/sidebar-onboarding-checklist.test.tsxnew file mode 100644index 0000000000..1fd438bedb--- /dev/null+++ b/__tests__/components/features/sidebar/sidebar-onboarding-checklist.test.tsx@@ -0,0 +1,288 @@+import { beforeEach, describe, expect, it, vi } from "vitest";+import { render, screen } from "@testing-library/react";+import userEvent from "@testing-library/user-event";+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";+import { ONBOARDING_COMPLETED_STORAGE_KEY } from "#/components/features/onboarding/use-onboarding-completion";+import { SidebarOnboardingChecklist } from "#/components/features/sidebar/sidebar-onboarding-checklist";+import {+ OPENHANDS_SLACK_COMMUNITY_URL,+ SIDEBAR_ONBOARDING_CHECKLIST_CUSTOMIZE_EXPLORED_STORAGE_KEY,+ SIDEBAR_ONBOARDING_CHECKLIST_MINIMIZED_STORAGE_KEY,+ SIDEBAR_ONBOARDING_CHECKLIST_SLACK_JOINED_STORAGE_KEY,+} from "#/components/features/sidebar/sidebar-onboarding-checklist.constants";+import {+ readSidebarOnboardingChecklistMinimized,+ readSidebarOnboardingChecklistSlackJoined,+} from "#/components/features/sidebar/sidebar-onboarding-checklist-storage";+import {+ NavigationProvider,+ type NavigationContextValue,+} from "#/context/navigation-context";+import { I18nKey } from "#/i18n/declaration";++const mockUsePaginatedConversations = vi.fn();+const mockUseAutomationHealth = vi.fn();+const mockUseAutomations = vi.fn();+const mockUseSettings = vi.fn();+const mockUseLlmConfigured = vi.fn();+const mockUseLlmProfiles = vi.fn();++vi.mock("#/hooks/query/use-paginated-conversations", () => ({+ usePaginatedConversations: () => mockUsePaginatedConversations(),+}));++vi.mock("#/hooks/query/use-automation-health", () => ({+ useAutomationHealth: () => mockUseAutomationHealth(),+}));++vi.mock("#/hooks/query/use-automations", () => ({+ useAutomations: () => mockUseAutomations(),+}));++vi.mock("#/hooks/query/use-settings", () => ({+ useSettings: () => mockUseSettings(),+}));++vi.mock("#/hooks/use-llm-configured", () => ({+ useLlmConfigured: () => mockUseLlmConfigured(),+}));++vi.mock("#/hooks/query/use-llm-profiles", () => ({+ useLlmProfiles: () => mockUseLlmProfiles(),+}));++function renderChecklist() {+ const queryClient = new QueryClient({+ defaultOptions: { queries: { retry: false }, mutations: { retry: false } },+ });+ const navigation: NavigationContextValue = {+ currentPath: "/",+ conversationId: null,+ isNavigating: false,+ navigate: vi.fn(),+ };++ return render(+ <QueryClientProvider client={queryClient}>+ <NavigationProvider value={navigation}>+ <SidebarOnboardingChecklist collapsed={false} />+ </NavigationProvider>+ </QueryClientProvider>,+ );+}++describe("SidebarOnboardingChecklist", () => {+ beforeEach(() => {+ window.localStorage.clear();+ window.localStorage.setItem(ONBOARDING_COMPLETED_STORAGE_KEY, "1");+ window.localStorage.removeItem(SIDEBAR_ONBOARDING_CHECKLIST_MINIMIZED_STORAGE_KEY);+ window.localStorage.removeItem(+ SIDEBAR_ONBOARDING_CHECKLIST_CUSTOMIZE_EXPLORED_STORAGE_KEY,+ );+ window.localStorage.removeItem(+ SIDEBAR_ONBOARDING_CHECKLIST_SLACK_JOINED_STORAGE_KEY,+ );++ mockUsePaginatedConversations.mockReturnValue({+ data: { pages: [{ items: [{ id: "conv-1" }] }] },+ });+ mockUseAutomationHealth.mockReturnValue({+ data: { status: "ok" },+ });+ mockUseAutomations.mockReturnValue({+ data: { total: 0, automations: [] },+ });+ mockUseSettings.mockReturnValue({+ data: {+ agent_settings: {+ mcp_config: { mcpServers: {} },+ },+ },+ });+ mockUseLlmConfigured.mockReturnValue({+ isConfigured: false,+ isLoading: false,+ });+ mockUseLlmProfiles.mockReturnValue({+ data: { active_profile: null, profiles: [] },+ isLoading: false,+ });+ });++ it("renders setup items including LLM keys, agent profiles, schedule a task, and Slack", () => {+ renderChecklist();++ expect(+ screen.getByTestId("sidebar-onboarding-checklist"),+ ).toBeInTheDocument();+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-item-configure-llm"),+ ).toHaveAttribute("href", "/settings/llm");+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-item-connect-mcp"),+ ).toHaveAttribute("href", "/mcp");+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-item-schedule-task"),+ ).toHaveAttribute("href", "/automations");+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-item-customize-agent"),+ ).toHaveAttribute("href", "/settings/agents");+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-item-join-slack"),+ ).toHaveAttribute("href", OPENHANDS_SLACK_COMMUNITY_URL);+ expect(+ screen.getByTestId("sidebar-onboarding-checklist-item-join-slack"),+ ).toHaveAttribute("target", "_blank");+ expect(+ screen.getByText(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CONFIGURE_LLM),+ ).toBeInTheDocument();+ expect(+ screen.getByText(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_JOIN_SLACK),+ ).toBeInTheDocument();+ });++ it("marks Join Slack complete after the invite link is clicked", async () => {+ const user = userEvent.setup();+ renderChecklist();++ const slackItem = screen.getByTestId(+ "sidebar-onboarding-checklist-item-join-slack",+ );+ expect(+ screen.getByText(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_JOIN_SLACK),+ ).not.toHaveClass("line-through");++ await user.click(slackItem);++ expect(readSidebarOnboardingChecklistSlackJoined()).toBe(true);+ expect(+ screen.getByText(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_JOIN_SLACK),+ ).toHaveClass("line-through");+ });++ it("crosses out Add LLM API key when LLM is configured", () => {+ mockUseLlmConfigured.mockReturnValue({+ isConfigured: true,+ isLoading: false,+ });+ mockUseLlmProfiles.mockReturnValue({+ data: {+ active_profile: "work",+ profiles: [+ {+ name: "work",+ model: "openai/gpt-5.5",+ base_url: "https://api.openai.com/v1",+ api_key_set: true,+ },+ ],+ },+ isLoading: false,+ });+ mockUseSettings.mockReturnValue({+ data: {+ llm_api_key_set: true,+ agent_settings: {+ llm: { model: "openai/gpt-5.5" },+ mcp_config: { mcpServers: {} },+ },+ },+ });++ renderChecklist();++ expect(+ screen.getByText(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CONFIGURE_LLM),+ ).toHaveClass("line-through");+ });++ it("crosses out Add LLM API key when a saved profile has an API key", () => {+ mockUseLlmConfigured.mockReturnValue({+ isConfigured: false,+ isLoading: true,+ });+ mockUseLlmProfiles.mockReturnValue({+ data: {+ active_profile: "work",+ profiles: [+ {+ name: "work",+ model: "openai/gpt-5.5",+ base_url: "https://api.openai.com/v1",+ api_key_set: true,+ },+ ],+ },+ isLoading: false,+ });+ mockUseSettings.mockReturnValue({+ data: {+ agent_settings: {+ mcp_config: { mcpServers: {} },+ },+ },+ });++ renderChecklist();++ expect(+ screen.getByText(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CONFIGURE_LLM),+ ).toHaveClass("line-through");+ });++ it("hides when the welcome onboarding flow is not complete", () => {+ window.localStorage.removeItem(ONBOARDING_COMPLETED_STORAGE_KEY);+ renderChecklist();++ expect(+ screen.queryByTestId("sidebar-onboarding-checklist"),+ ).not.toBeInTheDocument();+ });++ it("minimizes and expands with the caret toggle", async () => {+ const user = userEvent.setup();+ renderChecklist();++ expect(+ screen.getByTestId("sidebar-onboarding-checklist-item-schedule-task"),+ ).toBeInTheDocument();++ await user.click(screen.getByTestId("sidebar-onboarding-checklist-toggle"));++ expect(+ screen.queryByTestId("sidebar-onboarding-checklist-item-schedule-task"),+ ).not.toBeInTheDocument();+ expect(readSidebarOnboardingChecklistMinimized()).toBe(true);++ await user.click(screen.getByTestId("sidebar-onboarding-checklist-toggle"));++ expect(+ screen.getByTestId("sidebar-onboarding-checklist-item-schedule-task"),+ ).toBeInTheDocument();+ expect(readSidebarOnboardingChecklistMinimized()).toBe(false);+ });++ it("hides when collapsed", () => {+ const queryClient = new QueryClient({+ defaultOptions: { queries: { retry: false }, mutations: { retry: false } },+ });+ const navigation: NavigationContextValue = {+ currentPath: "/",+ conversationId: null,+ isNavigating: false,+ navigate: vi.fn(),+ };++ render(+ <QueryClientProvider client={queryClient}>+ <NavigationProvider value={navigation}>+ <SidebarOnboardingChecklist collapsed />+ </NavigationProvider>+ </QueryClientProvider>,+ );++ expect(+ screen.queryByTestId("sidebar-onboarding-checklist"),+ ).not.toBeInTheDocument();+ });+});diff --git a/__tests__/components/features/sidebar/sidebar.test.tsx b/__tests__/components/features/sidebar/sidebar.test.tsxindex 4d536cf2ad..a82a60ffa4 100644--- a/__tests__/components/features/sidebar/sidebar.test.tsx+++ b/__tests__/components/features/sidebar/sidebar.test.tsx@@ -51,16 +51,21 @@ vi.mock("#/hooks/query/use-settings", () => ({getErrorStatus: () => undefined,}));-vi.mock("#/contexts/active-backend-context", () => ({- useActiveBackendContext: () => ({- backends: [{ id: "local", name: "Local", kind: "local" }],- active: {- backend: { id: "local", name: "Local", kind: "local" },- orgId: null,- },- setActive: vi.fn(),- }),-}));+vi.mock("#/contexts/active-backend-context", () => {+ const active = {+ backend: { id: "local", name: "Local", kind: "local" },+ orgId: null,+ };++ return {+ useActiveBackendContext: () => ({+ backends: [active.backend],+ active,+ setActive: vi.fn(),+ }),+ useActiveBackend: () => active,+ };+});vi.mock("#/hooks/query/use-backends-health", () => ({useBackendsHealth: () => ({@@ -84,6 +89,12 @@ vi.mock("#/components/features/conversation-panel/conversation-panel", () => ({ConversationPanel: () => null,}));+vi.mock("#/components/features/sidebar/sidebar-onboarding-checklist", () => ({+ SidebarOnboardingChecklist: () => (+ <div data-testid="sidebar-onboarding-checklist" />+ ),+}));+vi.mock("#/components/features/conversation-panel/conversation-panel-wrapper",() => ({@@ -458,6 +469,23 @@ describe("Sidebar", () => {}});+ it("renders the Getting Started checklist above the bottom backend bar", () => {+ renderSidebar("/conversations");++ const automations = screen.getByTestId("sidebar-automations-link");+ const checklist = screen.getByTestId("sidebar-onboarding-checklist");+ const backendBar = screen.getByTestId("backend-selector");++ expect(+ automations.compareDocumentPosition(checklist) &+ Node.DOCUMENT_POSITION_FOLLOWING,+ ).toBeTruthy();+ expect(+ checklist.compareDocumentPosition(backendBar) &+ Node.DOCUMENT_POSITION_FOLLOWING,+ ).toBeTruthy();+ });+it("renders icons for every top-level nav item so they remain meaningful in the collapsed rail", () => {renderSidebar("/conversations");diff --git a/__tests__/components/onboarding/onboarding-modal.test.tsx b/__tests__/components/onboarding/onboarding-modal.test.tsxindex 007d1aad3f..b369919e64 100644--- a/__tests__/components/onboarding/onboarding-modal.test.tsx+++ b/__tests__/components/onboarding/onboarding-modal.test.tsx@@ -14,6 +14,7 @@ import {import { ActiveBackendProvider } from "#/contexts/active-backend-context";import { OnboardingModal } from "#/components/features/onboarding/onboarding-modal";import { ONBOARDING_DEFAULT_LLM_MODEL } from "#/components/features/onboarding/steps/setup-llm-step";+import { SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_STORAGE_KEY } from "#/components/features/sidebar/sidebar-onboarding-checklist.constants";import { NavigationProvider } from "#/context/navigation-context";import SettingsService from "#/api/settings-service/settings-service.api";import { SecretsService } from "#/api/secrets-service";@@ -174,7 +175,10 @@ function seedCloudBackend() {return backend;}-function renderModal(onClose = vi.fn()) {+function renderModal(+ onClose = vi.fn(),+ options?: { initialStep?: number },+) {const queryClient = new QueryClient({defaultOptions: { queries: { retry: false } },});@@ -188,7 +192,10 @@ function renderModal(onClose = vi.fn()) {<QueryClientProvider client={queryClient}><ActiveBackendProvider><NavigationProvider value={navigationValue}>- <OnboardingModal onClose={onClose} />+ <OnboardingModal+ onClose={onClose}+ initialStep={options?.initialStep}+ /></NavigationProvider></ActiveBackendProvider></QueryClientProvider>,@@ -1134,4 +1141,49 @@ describe("OnboardingModal", () => {);});});++ describe("Getting Started checklist skip", () => {+ it("renders a centered skip checkbox below the modal on Say Hello", async () => {+ renderModal(vi.fn(), { initialStep: 3 });++ await waitFor(() => {+ expect(+ screen.getByTestId("onboarding-step-say-hello"),+ ).toBeInTheDocument();+ });++ const checkbox = screen.getByTestId(+ "onboarding-skip-getting-started-checklist",+ );+ expect(checkbox).toBeInTheDocument();+ expect(checkbox).not.toBeChecked();+ expect(+ screen.getByText("ONBOARDING$SKIP_GETTING_STARTED_CHECKLIST"),+ ).toBeInTheDocument();++ const modal = screen.getByTestId("onboarding-modal");+ expect(modal.contains(checkbox)).toBe(false);+ });++ it("persists dismissal when the skip checkbox is checked", async () => {+ const user = userEvent.setup();+ renderModal(vi.fn(), { initialStep: 3 });++ await waitFor(() => {+ expect(+ screen.getByTestId("onboarding-skip-getting-started-checklist"),+ ).toBeInTheDocument();+ });++ await user.click(+ screen.getByTestId("onboarding-skip-getting-started-checklist"),+ );++ expect(+ window.localStorage.getItem(+ SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_STORAGE_KEY,+ ),+ ).toBe("true");+ });+ });});diff --git a/__tests__/components/settings/app-settings/getting-started-checklist-switch.test.tsx b/__tests__/components/settings/app-settings/getting-started-checklist-switch.test.tsxnew file mode 100644index 0000000000..cf9eb8ada0--- /dev/null+++ b/__tests__/components/settings/app-settings/getting-started-checklist-switch.test.tsx@@ -0,0 +1,48 @@+import { beforeEach, describe, expect, it } from "vitest";+import { render, screen } from "@testing-library/react";+import userEvent from "@testing-library/user-event";+import { GettingStartedChecklistSwitch } from "#/components/features/settings/app-settings/getting-started-checklist-switch";+import { SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_STORAGE_KEY } from "#/components/features/sidebar/sidebar-onboarding-checklist.constants";+import { readSidebarOnboardingChecklistDismissed } from "#/components/features/sidebar/sidebar-onboarding-checklist-storage";++describe("GettingStartedChecklistSwitch", () => {+ beforeEach(() => {+ window.localStorage.clear();+ });++ it("shows the checklist by default and hides it when toggled off", async () => {+ const user = userEvent.setup();+ render(<GettingStartedChecklistSwitch />);++ const toggle = screen.getByTestId("show-getting-started-checklist-switch");+ expect(toggle).toBeChecked();+ expect(readSidebarOnboardingChecklistDismissed()).toBe(false);++ await user.click(toggle);++ expect(toggle).not.toBeChecked();+ expect(+ window.localStorage.getItem(+ SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_STORAGE_KEY,+ ),+ ).toBe("true");+ });++ it("re-enables the checklist when toggled back on", async () => {+ window.localStorage.setItem(+ SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_STORAGE_KEY,+ "true",+ );++ const user = userEvent.setup();+ render(<GettingStartedChecklistSwitch />);++ const toggle = screen.getByTestId("show-getting-started-checklist-switch");+ expect(toggle).not.toBeChecked();++ await user.click(toggle);++ expect(toggle).toBeChecked();+ expect(readSidebarOnboardingChecklistDismissed()).toBe(false);+ });+});diff --git a/src/components/features/onboarding/onboarding-modal.tsx b/src/components/features/onboarding/onboarding-modal.tsxindex acb60a7101..a347fd30cd 100644--- a/src/components/features/onboarding/onboarding-modal.tsx+++ b/src/components/features/onboarding/onboarding-modal.tsx@@ -2,6 +2,10 @@ import React from "react";import { useTranslation } from "react-i18next";import { isNoBackend } from "#/api/backend-registry/active-store";import { getLockedCloudHost, isSameCloudHost } from "#/api/agent-server-config";+import {+ readSidebarOnboardingChecklistDismissed,+ writeSidebarOnboardingChecklistDismissed,+} from "#/components/features/sidebar/sidebar-onboarding-checklist-storage";import { ModalBackdrop } from "#/components/shared/modals/modal-backdrop";import {MODAL_MAX_WIDTH_VIEWPORT,@@ -177,6 +181,8 @@ export function OnboardingModal({);const [selectedAgentId, setSelectedAgentId] =React.useState<OnboardingAgentId>("openhands");+ const [skipGettingStartedChecklist, setSkipGettingStartedChecklist] =+ React.useState(() => readSidebarOnboardingChecklistDismissed());// When the backend slide drops out of the flow (skipBackendStep flips// true), a user still parked on "backend" must be moved forward to the@@ -191,6 +197,14 @@ export function OnboardingModal({const currentPhase = slideOrder.includes(phase) ? phase : slideOrder[0];const currentStep = slideOrder.indexOf(currentPhase);+ const handleSkipGettingStartedChange = (+ event: React.ChangeEvent<HTMLInputElement>,+ ) => {+ const skip = event.target.checked;+ setSkipGettingStartedChecklist(skip);+ writeSidebarOnboardingChecklistDismissed(skip);+ };+// Backend connectivity is "settled" once we know whether the active backend// is reachable (or no backend is selected). Until then `skipBackendStep` may// still flip true and renumber the slides, briefly showing the backend slide@@ -379,6 +393,19 @@ export function OnboardingModal({{t(I18nKey.ONBOARDING$SKIP)}</button>) : null}++ {currentPhase === "hello" ? (+ <label className="flex cursor-pointer items-center justify-center gap-2 text-sm text-[var(--oh-muted)]">+ <input+ data-testid="onboarding-skip-getting-started-checklist"+ type="checkbox"+ checked={skipGettingStartedChecklist}+ onChange={handleSkipGettingStartedChange}+ className="size-4 cursor-pointer"+ />+ {t(I18nKey.ONBOARDING$SKIP_GETTING_STARTED_CHECKLIST)}+ </label>+ ) : null}</div></ModalBackdrop>);diff --git a/src/components/features/settings/app-settings/getting-started-checklist-switch.tsx b/src/components/features/settings/app-settings/getting-started-checklist-switch.tsxnew file mode 100644index 0000000000..3c9edec3c7--- /dev/null+++ b/src/components/features/settings/app-settings/getting-started-checklist-switch.tsx@@ -0,0 +1,24 @@+import { useTranslation } from "react-i18next";+import { SettingsSwitch } from "#/components/features/settings/settings-switch";+import { useSidebarOnboardingChecklistDismissed } from "#/components/features/sidebar/use-sidebar-onboarding-checklist-dismissed";+import { writeSidebarOnboardingChecklistDismissed } from "#/components/features/sidebar/sidebar-onboarding-checklist-storage";+import { I18nKey } from "#/i18n/declaration";++export function GettingStartedChecklistSwitch() {+ const { t } = useTranslation("openhands");+ const isDismissed = useSidebarOnboardingChecklistDismissed();++ const handleToggle = (showChecklist: boolean) => {+ writeSidebarOnboardingChecklistDismissed(!showChecklist);+ };++ return (+ <SettingsSwitch+ testId="show-getting-started-checklist-switch"+ isToggled={!isDismissed}+ onToggle={handleToggle}+ >+ {t(I18nKey.SETTINGS$SHOW_GETTING_STARTED_CHECKLIST)}+ </SettingsSwitch>+ );+}diff --git a/src/components/features/sidebar/sidebar-onboarding-checklist-item-icon.tsx b/src/components/features/sidebar/sidebar-onboarding-checklist-item-icon.tsxnew file mode 100644index 0000000000..432c258229--- /dev/null+++ b/src/components/features/sidebar/sidebar-onboarding-checklist-item-icon.tsx@@ -0,0 +1,123 @@+import { Plus } from "lucide-react";+import ClockIcon from "#/icons/clock.svg?react";+import KeyIcon from "#/icons/key.svg?react";+import ServerProcessIcon from "#/icons/server-process.svg?react";+import SlackIcon from "#/icons/slack.svg?react";+import { cn } from "#/utils/utils";+import type { SidebarOnboardingChecklistItemId } from "./sidebar-onboarding-checklist.constants";++const PREVIEW_ICON_SIZE = 18;++function CustomizeAgentIcon() {+ return (+ <svg+ xmlns="http://www.w3.org/2000/svg"+ width={PREVIEW_ICON_SIZE}+ height={PREVIEW_ICON_SIZE}+ viewBox="0 0 24 24"+ fill="none"+ stroke="currentColor"+ strokeWidth="2"+ strokeLinecap="round"+ strokeLinejoin="round"+ aria-hidden="true"+ >+ <path d="M2.97 12.92A2 2 0 0 0 2 14.63v3.24a2 2 0 0 0 .97 1.71l3 1.8a2 2 0 0 0 2.06 0L12 19v-5.5l-5-3-4.03 2.42Z" />+ <path d="m7 16.5-4.74-2.85" />+ <path d="m7 16.5 5-3" />+ <path d="M7 16.5v5.17" />+ <path d="M12 13.5V19l3.97 2.38a2 2 0 0 0 2.06 0l3-1.8a2 2 0 0 0 .97-1.71v-3.24a2 2 0 0 0-.97-1.71L17 10.5l-5 3Z" />+ <path d="m17 16.5-5-3" />+ <path d="m17 16.5 4.74-2.85" />+ <path d="m17 16.5v5.17" />+ <path d="M7.97 4.42A2 2 0 0 0 7 6.13v4.37l5 3 5-3V6.13a2 2 0 0 0-.97-1.71l-3-1.8a2 2 0 0 0-2.06 0l-3 1.8Z" />+ <path d="M12 8 7.26 5.15" />+ <path d="m12 8 4.74-2.85" />+ <path d="M12 13.5V8" />+ </svg>+ );+}++interface SidebarOnboardingChecklistItemIconProps {+ id: SidebarOnboardingChecklistItemId;+ className?: string;+}++export function SidebarOnboardingChecklistItemIcon({+ id,+ className,+}: SidebarOnboardingChecklistItemIconProps) {+ const iconClassName = cn("shrink-0 text-white", className);+ const testId = `sidebar-onboarding-checklist-icon-${id}`;++ switch (id) {+ case "configure-llm":+ return (+ <span data-testid={testId} className="inline-flex shrink-0">+ <KeyIcon+ width={PREVIEW_ICON_SIZE}+ height={PREVIEW_ICON_SIZE}+ className={iconClassName}+ aria-hidden+ />+ </span>+ );+ case "start-conversation":+ return (+ <span data-testid={testId} className="inline-flex shrink-0">+ <Plus+ size={PREVIEW_ICON_SIZE}+ strokeWidth={2}+ className={iconClassName}+ aria-hidden+ />+ </span>+ );+ case "schedule-task":+ return (+ <span data-testid={testId} className="inline-flex shrink-0">+ <ClockIcon+ width={PREVIEW_ICON_SIZE}+ height={PREVIEW_ICON_SIZE}+ className={iconClassName}+ aria-hidden+ />+ </span>+ );+ case "customize-agent":+ return (+ <span+ data-testid={testId}+ className={cn("inline-flex shrink-0", iconClassName)}+ >+ <CustomizeAgentIcon />+ </span>+ );+ case "connect-mcp":+ return (+ <span data-testid={testId} className="inline-flex shrink-0">+ <ServerProcessIcon+ width={PREVIEW_ICON_SIZE}+ height={PREVIEW_ICON_SIZE}+ className={iconClassName}+ aria-hidden+ />+ </span>+ );+ case "join-slack":+ return (+ <span data-testid={testId} className="inline-flex shrink-0">+ <SlackIcon+ width={PREVIEW_ICON_SIZE}+ height={PREVIEW_ICON_SIZE}+ className={iconClassName}+ aria-hidden+ />+ </span>+ );+ default: {+ const unreachable: never = id;+ return unreachable;+ }+ }+}diff --git a/src/components/features/sidebar/sidebar-onboarding-checklist-item-preview.tsx b/src/components/features/sidebar/sidebar-onboarding-checklist-item-preview.tsxnew file mode 100644index 0000000000..047c65dc60--- /dev/null+++ b/src/components/features/sidebar/sidebar-onboarding-checklist-item-preview.tsx@@ -0,0 +1,87 @@+import { BookOpen } from "lucide-react";+import { useTranslation } from "react-i18next";+import { NavigationLink } from "#/components/shared/navigation-link";+import { I18nKey } from "#/i18n/declaration";+import { cn } from "#/utils/utils";+import {+ getSidebarOnboardingChecklistHref,+ SIDEBAR_ONBOARDING_CHECKLIST_ACTION_I18N_KEYS,+ SIDEBAR_ONBOARDING_CHECKLIST_DESCRIPTION_I18N_KEYS,+ SIDEBAR_ONBOARDING_CHECKLIST_DOCS_URLS,+ SIDEBAR_ONBOARDING_CHECKLIST_I18N_KEYS,+ type SidebarOnboardingChecklistItemId,+} from "./sidebar-onboarding-checklist.constants";+import { SidebarOnboardingChecklistItemIcon } from "./sidebar-onboarding-checklist-item-icon";++const PREVIEW_ACTION_BUTTON_CLASS = cn(+ "inline-flex shrink-0 items-center rounded-md bg-white px-2.5 py-1",+ "text-xs font-medium text-black transition-colors hover:bg-white/90",+);++interface SidebarOnboardingChecklistItemPreviewProps {+ id: SidebarOnboardingChecklistItemId;+ onActionClick?: () => void;+}++export function SidebarOnboardingChecklistItemPreview({+ id,+ onActionClick,+}: SidebarOnboardingChecklistItemPreviewProps) {+ const { t } = useTranslation("openhands");+ const titleKey = SIDEBAR_ONBOARDING_CHECKLIST_I18N_KEYS[id];+ const descriptionKey = SIDEBAR_ONBOARDING_CHECKLIST_DESCRIPTION_I18N_KEYS[id];+ const actionKey = SIDEBAR_ONBOARDING_CHECKLIST_ACTION_I18N_KEYS[id];+ const docsUrl = SIDEBAR_ONBOARDING_CHECKLIST_DOCS_URLS[id];+ const href = getSidebarOnboardingChecklistHref(id);++ return (+ <div+ className="flex w-[280px] flex-col gap-2.5 p-3"+ data-testid={`sidebar-onboarding-checklist-preview-${id}`}+ >+ <div className="flex items-start gap-2">+ <span className="mt-0.5 inline-flex shrink-0 items-center justify-center">+ <SidebarOnboardingChecklistItemIcon id={id} />+ </span>+ <span className="min-w-0 flex-1 text-sm font-medium text-white">+ {t(titleKey)}+ </span>+ </div>+ <p className="text-xs leading-relaxed text-[var(--oh-muted)]">+ {t(descriptionKey)}+ </p>+ <div className="flex items-center justify-between gap-3">+ <a+ href={docsUrl}+ target="_blank"+ rel="noreferrer"+ data-testid={`sidebar-onboarding-checklist-preview-docs-${id}`}+ className="inline-flex min-w-0 items-center gap-2 text-xs text-[var(--oh-muted)] transition-colors hover:text-white hover:underline"+ >+ <BookOpen className="size-3.5 shrink-0" aria-hidden />+ {t(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_DOCS_LINK)}+ </a>+ {href.kind === "external" ? (+ <a+ href={href.href}+ target="_blank"+ rel="noreferrer"+ data-testid={`sidebar-onboarding-checklist-preview-action-${id}`}+ className={PREVIEW_ACTION_BUTTON_CLASS}+ onClick={onActionClick}+ >+ {t(actionKey)}+ </a>+ ) : (+ <NavigationLink+ to={href.href}+ data-testid={`sidebar-onboarding-checklist-preview-action-${id}`}+ className={PREVIEW_ACTION_BUTTON_CLASS}+ >+ {t(actionKey)}+ </NavigationLink>+ )}+ </div>+ </div>+ );+}diff --git a/src/components/features/sidebar/sidebar-onboarding-checklist-llm-complete.ts b/src/components/features/sidebar/sidebar-onboarding-checklist-llm-complete.tsnew file mode 100644index 0000000000..1f71f53229--- /dev/null+++ b/src/components/features/sidebar/sidebar-onboarding-checklist-llm-complete.ts@@ -0,0 +1,50 @@+import type { ProfileListResponse } from "#/api/profiles-service/profiles-service.api";+import type { Settings } from "#/types/settings";++function hasLlmProfileWithApiKey(+ profilesData: ProfileListResponse | undefined,+): boolean {+ return (+ profilesData?.profiles.some((profile) => profile.api_key_set === true) ??+ false+ );+}++function hasConfiguredLlmInSettings(settings: Settings | undefined): boolean {+ const llm = settings?.agent_settings?.llm as+ | { model?: unknown; auth_type?: unknown }+ | undefined;+ const hasModel = typeof llm?.model === "string" && llm.model.length > 0;+ const hasAuth =+ settings?.llm_api_key_set === true ||+ settings?.llm_api_key_is_set === true ||+ llm?.auth_type === "subscription";++ return hasModel && hasAuth;+}++export function isConfigureLlmChecklistItemComplete(+ settings: Settings | undefined,+ isLlmConfigured: boolean,+ isLlmConfiguredLoading: boolean,+ profilesData: ProfileListResponse | undefined,+ isProfilesLoading: boolean,+): boolean {+ if (hasLlmProfileWithApiKey(profilesData)) {+ return true;+ }++ if (isLlmConfigured) {+ return true;+ }++ if (hasConfiguredLlmInSettings(settings)) {+ return true;+ }++ if (isLlmConfiguredLoading || (isProfilesLoading && !profilesData)) {+ return false;+ }++ return false;+}diff --git a/src/components/features/sidebar/sidebar-onboarding-checklist-storage.ts b/src/components/features/sidebar/sidebar-onboarding-checklist-storage.tsnew file mode 100644index 0000000000..fdfcc44ecb--- /dev/null+++ b/src/components/features/sidebar/sidebar-onboarding-checklist-storage.ts@@ -0,0 +1,117 @@+import {+ SIDEBAR_ONBOARDING_CHECKLIST_CUSTOMIZE_EXPLORED_STORAGE_KEY,+ SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_CHANGE_EVENT,+ SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_STORAGE_KEY,+ SIDEBAR_ONBOARDING_CHECKLIST_MINIMIZED_STORAGE_KEY,+ SIDEBAR_ONBOARDING_CHECKLIST_SLACK_JOINED_STORAGE_KEY,+} from "./sidebar-onboarding-checklist.constants";++export function readSidebarOnboardingChecklistDismissed(): boolean {+ if (typeof window === "undefined") {+ return false;+ }++ return (+ window.localStorage.getItem(+ SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_STORAGE_KEY,+ ) === "true"+ );+}++export function getSidebarOnboardingChecklistDismissedSnapshot(): boolean {+ return readSidebarOnboardingChecklistDismissed();+}++export function subscribeSidebarOnboardingChecklistDismissed(+ onStoreChange: () => void,+): () => void {+ const handleChange = () => onStoreChange();+ window.addEventListener("storage", handleChange);+ window.addEventListener(+ SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_CHANGE_EVENT,+ handleChange,+ );++ return () => {+ window.removeEventListener("storage", handleChange);+ window.removeEventListener(+ SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_CHANGE_EVENT,+ handleChange,+ );+ };+}++export function writeSidebarOnboardingChecklistDismissed(+ dismissed: boolean,+): void {+ window.localStorage.setItem(+ SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_STORAGE_KEY,+ dismissed ? "true" : "false",+ );+ window.dispatchEvent(+ new Event(SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_CHANGE_EVENT),+ );+}++export function readSidebarOnboardingChecklistMinimized(): boolean {+ if (typeof window === "undefined") {+ return false;+ }++ return (+ window.localStorage.getItem(+ SIDEBAR_ONBOARDING_CHECKLIST_MINIMIZED_STORAGE_KEY,+ ) === "true"+ );+}++export function writeSidebarOnboardingChecklistMinimized(+ minimized: boolean,+): void {+ window.localStorage.setItem(+ SIDEBAR_ONBOARDING_CHECKLIST_MINIMIZED_STORAGE_KEY,+ minimized ? "true" : "false",+ );+}++export function readSidebarOnboardingChecklistCustomizeExplored(): boolean {+ if (typeof window === "undefined") {+ return false;+ }++ return (+ window.localStorage.getItem(+ SIDEBAR_ONBOARDING_CHECKLIST_CUSTOMIZE_EXPLORED_STORAGE_KEY,+ ) === "true"+ );+}++export function writeSidebarOnboardingChecklistCustomizeExplored(+ explored: boolean,+): void {+ window.localStorage.setItem(+ SIDEBAR_ONBOARDING_CHECKLIST_CUSTOMIZE_EXPLORED_STORAGE_KEY,+ explored ? "true" : "false",+ );+}++export function readSidebarOnboardingChecklistSlackJoined(): boolean {+ if (typeof window === "undefined") {+ return false;+ }++ return (+ window.localStorage.getItem(+ SIDEBAR_ONBOARDING_CHECKLIST_SLACK_JOINED_STORAGE_KEY,+ ) === "true"+ );+}++export function writeSidebarOnboardingChecklistSlackJoined(+ joined: boolean,+): void {+ window.localStorage.setItem(+ SIDEBAR_ONBOARDING_CHECKLIST_SLACK_JOINED_STORAGE_KEY,+ joined ? "true" : "false",+ );+}diff --git a/src/components/features/sidebar/sidebar-onboarding-checklist.constants.ts b/src/components/features/sidebar/sidebar-onboarding-checklist.constants.tsnew file mode 100644index 0000000000..695b62a472--- /dev/null+++ b/src/components/features/sidebar/sidebar-onboarding-checklist.constants.ts@@ -0,0 +1,121 @@+import { I18nKey } from "#/i18n/declaration";++const SCHEDULED_TASKS_DOCS_URL =+ "https://docs.openhands.dev/openhands/usage/agent-canvas/prebuilt-automations";++/** Canonical Slack invite redirect from openhands.dev. */+export const OPENHANDS_SLACK_COMMUNITY_URL = "https://openhands.dev/joinslack";++export const SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_STORAGE_KEY =+ "openhands-sidebar-onboarding-checklist-dismissed";++export const SIDEBAR_ONBOARDING_CHECKLIST_DISMISSED_CHANGE_EVENT =+ "openhands-sidebar-onboarding-checklist-dismissed-change";++export const SIDEBAR_ONBOARDING_CHECKLIST_MINIMIZED_STORAGE_KEY =+ "openhands-sidebar-onboarding-checklist-minimized";++export const SIDEBAR_ONBOARDING_CHECKLIST_CUSTOMIZE_EXPLORED_STORAGE_KEY =+ "openhands-sidebar-onboarding-checklist-customize-explored";++export const SIDEBAR_ONBOARDING_CHECKLIST_SLACK_JOINED_STORAGE_KEY =+ "openhands-sidebar-onboarding-checklist-slack-joined";++export const SIDEBAR_ONBOARDING_CHECKLIST_ITEM_IDS = [+ "configure-llm",+ "start-conversation",+ "schedule-task",+ "customize-agent",+ "connect-mcp",+ "join-slack",+] as const;++export type SidebarOnboardingChecklistItemId =+ (typeof SIDEBAR_ONBOARDING_CHECKLIST_ITEM_IDS)[number];++export type SidebarOnboardingChecklistInternalItemId = Exclude<+ SidebarOnboardingChecklistItemId,+ "join-slack"+>;++export const SIDEBAR_ONBOARDING_CHECKLIST_ROUTES: Record<+ SidebarOnboardingChecklistInternalItemId,+ string+> = {+ "configure-llm": "/settings/llm",+ "connect-mcp": "/mcp",+ "start-conversation": "/conversations",+ "schedule-task": "/automations",+ "customize-agent": "/settings/agents",+};++export function isExternalSidebarOnboardingChecklistItem(+ id: SidebarOnboardingChecklistItemId,+): id is "join-slack" {+ return id === "join-slack";+}++export function getSidebarOnboardingChecklistHref(+ id: SidebarOnboardingChecklistItemId,+): { kind: "internal" | "external"; href: string } {+ if (isExternalSidebarOnboardingChecklistItem(id)) {+ return { kind: "external", href: OPENHANDS_SLACK_COMMUNITY_URL };+ }++ return { kind: "internal", href: SIDEBAR_ONBOARDING_CHECKLIST_ROUTES[id] };+}++export const SIDEBAR_ONBOARDING_CHECKLIST_I18N_KEYS: Record<+ SidebarOnboardingChecklistItemId,+ I18nKey+> = {+ "configure-llm": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CONFIGURE_LLM,+ "connect-mcp": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CONNECT_MCP,+ "start-conversation": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_START_CHAT,+ "schedule-task": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_SCHEDULE_TASK,+ "customize-agent": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CUSTOMIZE,+ "join-slack": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_JOIN_SLACK,+};++export const SIDEBAR_ONBOARDING_CHECKLIST_DESCRIPTION_I18N_KEYS: Record<+ SidebarOnboardingChecklistItemId,+ I18nKey+> = {+ "configure-llm": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CONFIGURE_LLM_DESC,+ "connect-mcp": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CONNECT_MCP_DESC,+ "start-conversation": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_START_CHAT_DESC,+ "schedule-task": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_SCHEDULE_TASK_DESC,+ "customize-agent": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_CUSTOMIZE_DESC,+ "join-slack": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_JOIN_SLACK_DESC,+};++export const SIDEBAR_ONBOARDING_CHECKLIST_ACTION_I18N_KEYS: Record<+ SidebarOnboardingChecklistItemId,+ I18nKey+> = {+ "configure-llm": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_ACTION_CONFIGURE_LLM,+ "connect-mcp": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_ACTION_CONNECT_MCP,+ "start-conversation": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_ACTION_START_CHAT,+ "schedule-task": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_ACTION_SCHEDULE_TASK,+ "customize-agent": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_ACTION_CUSTOMIZE,+ "join-slack": I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_ACTION_JOIN_SLACK,+};++export const SIDEBAR_ONBOARDING_CHECKLIST_DOCS_URLS: Record<+ SidebarOnboardingChecklistItemId,+ string+> = {+ "configure-llm":+ "https://docs.openhands.dev/openhands/usage/settings/llm-settings#llm-profiles",+ "start-conversation":+ "https://docs.openhands.dev/openhands/usage/agent-canvas/backends",+ "schedule-task": SCHEDULED_TASKS_DOCS_URL,+ "customize-agent":+ "https://docs.openhands.dev/openhands/usage/agent-canvas/customize-and-settings",+ "connect-mcp": "https://docs.openhands.dev/overview/model-context-protocol",+ "join-slack": "https://docs.openhands.dev/overview/community",+};++export function isCustomizeChecklistPath(path: string): boolean {+ return path === "/settings/agents" || path.startsWith("/settings/agents/");+}diff --git a/src/components/features/sidebar/sidebar-onboarding-checklist.tsx b/src/components/features/sidebar/sidebar-onboarding-checklist.tsxnew file mode 100644index 0000000000..2445e34e0d--- /dev/null+++ b/src/components/features/sidebar/sidebar-onboarding-checklist.tsx@@ -0,0 +1,208 @@+import { Tooltip } from "@heroui/react";+import { Check, ChevronDown } from "lucide-react";+import { useTranslation } from "react-i18next";+import { NavigationLink } from "#/components/shared/navigation-link";+import { I18nKey } from "#/i18n/declaration";+import { cn } from "#/utils/utils";+import {+ getSidebarOnboardingChecklistHref,+ isExternalSidebarOnboardingChecklistItem,+ SIDEBAR_ONBOARDING_CHECKLIST_I18N_KEYS,+ type SidebarOnboardingChecklistItemId,+} from "./sidebar-onboarding-checklist.constants";+import { SidebarOnboardingChecklistItemPreview } from "./sidebar-onboarding-checklist-item-preview";+import { useSidebarOnboardingChecklist } from "./use-sidebar-onboarding-checklist";++const CHECKLIST_ITEM_TOOLTIP_CLASS =+ "rounded-xl border border-[var(--oh-border)] bg-base-secondary p-0 text-white shadow-xl";++const CHECKLIST_ITEM_CLASS = cn(+ "flex min-w-0 w-full items-center gap-2.5 rounded-md px-2.5 py-1.5 text-sm",+ "transition-colors hover:bg-[var(--oh-surface)]",+);++interface SidebarOnboardingChecklistProps {+ collapsed: boolean;+}++function ChecklistStatusIcon({ isComplete }: { isComplete: boolean }) {+ return (+ <span+ aria-hidden+ className={cn(+ "inline-flex size-4 shrink-0 items-center justify-center rounded-full border",+ isComplete+ ? "border-primary bg-primary text-[var(--oh-color-base)]"+ : "border-[var(--oh-border)] bg-transparent",+ )}+ >+ {isComplete ? <Check className="size-2.5" strokeWidth={3} /> : null}+ </span>+ );+}++function ChecklistItem({+ id,+ isComplete,+ onActivate,+}: {+ id: SidebarOnboardingChecklistItemId;+ isComplete: boolean;+ onActivate?: () => void;+}) {+ const { t } = useTranslation("openhands");+ const labelKey = SIDEBAR_ONBOARDING_CHECKLIST_I18N_KEYS[id];+ const disableAnimation = import.meta.env.MODE === "test";+ const href = getSidebarOnboardingChecklistHref(id);+ const itemClassName = cn(+ CHECKLIST_ITEM_CLASS,+ isComplete ? "text-muted" : "text-content",+ );+ const label = (+ <>+ <ChecklistStatusIcon isComplete={isComplete} />+ <span+ className={cn("min-w-0 flex-1 truncate", isComplete && "line-through")}+ >+ {t(labelKey)}+ </span>+ </>+ );++ return (+ <li>+ <Tooltip+ placement="right-start"+ delay={0}+ closeDelay={100}+ disableAnimation={disableAnimation}+ className={CHECKLIST_ITEM_TOOLTIP_CLASS}+ content={+ <SidebarOnboardingChecklistItemPreview+ id={id}+ onActionClick={onActivate}+ />+ }+ >+ {href.kind === "external" ? (+ <a+ href={href.href}+ target="_blank"+ rel="noreferrer"+ data-testid={`sidebar-onboarding-checklist-item-${id}`}+ className={itemClassName}+ onClick={onActivate}+ >+ {label}+ </a>+ ) : (+ <NavigationLink+ to={href.href}+ data-testid={`sidebar-onboarding-checklist-item-${id}`}+ className={itemClassName}+ >+ {label}+ </NavigationLink>+ )}+ </Tooltip>+ </li>+ );+}++export function SidebarOnboardingChecklist({+ collapsed,+}: SidebarOnboardingChecklistProps) {+ const { t } = useTranslation("openhands");+ const {+ items,+ completedCount,+ isVisible,+ isMinimized,+ toggleMinimized,+ markJoinSlackComplete,+ } = useSidebarOnboardingChecklist();++ if (collapsed || !isVisible) {+ return null;+ }++ return (+ <div+ data-testid="sidebar-onboarding-checklist"+ data-minimized={isMinimized ? "true" : "false"}+ className={cn(+ "w-full shrink-0 overflow-hidden rounded-xl border border-[var(--oh-border)]",+ "bg-[var(--oh-surface-raised)] shadow-sm",+ )}+ >+ <div className={cn("px-1", isMinimized ? "py-1" : "pt-2 pb-1")}>+ <div+ className={cn(+ "relative flex w-full items-center gap-0.5 rounded-md px-1.5",+ "transition-colors hover:bg-[var(--oh-surface)]",+ isMinimized ? "py-1" : "py-1.5",+ )}+ >+ <button+ type="button"+ data-testid="sidebar-onboarding-checklist-toggle"+ aria-expanded={!isMinimized}+ aria-label={+ isMinimized+ ? t(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_EXPAND)+ : t(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_COLLAPSE)+ }+ onClick={toggleMinimized}+ className="absolute inset-0 z-0 cursor-pointer rounded-md"+ />++ <div className="relative z-10 min-w-0 flex-1 px-0.5 pointer-events-none">+ <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-0.5">+ <span className="text-sm font-semibold text-content">+ {t(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_TITLE)}+ </span>+ <span className="text-xs text-muted">+ {t(I18nKey.SIDEBAR$ONBOARDING_CHECKLIST_PROGRESS, {+ completed: completedCount,+ })}+ </span>+ </div>+ </div>++ <span+ data-testid="sidebar-onboarding-checklist-chevron"+ aria-hidden+ className={cn(+ "relative z-10 inline-flex size-7 shrink-0 items-center justify-center",+ "pointer-events-none text-[var(--oh-muted)]",+ )}+ >+ <ChevronDown+ className={cn(+ "size-4 transition-transform motion-reduce:transition-none",+ isMinimized && "-rotate-90",+ )}+ />+ </span>+ </div>+ </div>++ {!isMinimized ? (+ <ul className="flex flex-col gap-0.5 px-2.5 pb-2">+ {items.map((item) => (+ <ChecklistItem+ key={item.id}+ id={item.id}+ isComplete={item.isComplete}+ onActivate={+ isExternalSidebarOnboardingChecklistItem(item.id)+ ? markJoinSlackComplete+ : undefined+ }+ />+ ))}+ </ul>+ ) : null}+ </div>+ );+}diff --git a/src/components/features/sidebar/sidebar-rail-body.tsx b/src/components/features/sidebar/sidebar-rail-body.tsxindex e77fa08d6d..e1ffaa5558 100644--- a/src/components/features/sidebar/sidebar-rail-body.tsx+++ b/src/components/features/sidebar/sidebar-rail-body.tsx@@ -24,6 +24,7 @@ import { BackendStatusDot } from "#/components/features/backends/backend-status-import { CommandMenuTrigger } from "#/components/features/command-menu/command-menu-trigger";import { AgentCanvasVersionTile } from "#/components/features/settings/agent-canvas-version-tile";import { SidebarConversationList } from "./sidebar-conversation-list";+import { SidebarOnboardingChecklist } from "./sidebar-onboarding-checklist";import AutomationsIcon from "#/icons/automations.svg?react";import {SIDEBAR_COLLAPSE_TOGGLE_OVERLAY_CLASS,@@ -312,15 +313,20 @@ export function SidebarRailBody({) : null}{!collapsed ? (- <div- className={cn(- "flex flex-col items-stretch max-w-none box-border shrink-0 gap-2",- "-ml-2.5 w-[calc(100%+0.625rem)] border-t border-[var(--oh-border)] pt-2 px-2.5",- )}- >- <AgentCanvasVersionTile hideWhenUpToDate />- <BackendSelector sidebarCollapsed={collapsed} openUpward />- </div>+ <>+ <div className="mb-2 shrink-0 pr-2.5">+ <SidebarOnboardingChecklist collapsed={collapsed} />+ </div>+ <div+ className={cn(+ "flex flex-col items-stretch max-w-none box-border shrink-0 gap-2",+ "-ml-2.5 w-[calc(100%+0.625rem)] border-t border-[var(--oh-border)] pt-2 px-2.5",+ )}+ >+ <AgentCanvasVersionTile hideWhenUpToDate />+ <BackendSelector sidebarCollapsed={collapsed} openUpward />+ </div>+ </>) : null}</div>);diff --git a/src/components/features/sidebar/use-sidebar-onboarding-checklist-dismissed.ts b/src/components/features/sidebar/use-sidebar-onboarding-checklist-dismissed.tsnew file mode 100644index 0000000000..bf35363b65--- /dev/null+++ b/src/components/features/sidebar/use-sidebar-onboarding-checklist-dismissed.ts@@ -0,0 +1,13 @@+import { useSyncExternalStore } from "react";+import {+ getSidebarOnboardingChecklistDismissedSnapshot,+ subscribeSidebarOnboardingChecklistDismissed,+} from "./sidebar-onboarding-checklist-storage";++export function useSidebarOnboardingChecklistDismissed(): boolean {+ return useSyncExternalStore(+ subscribeSidebarOnboardingChecklistDismissed,+ getSidebarOnboardingChecklistDismissedSnapshot,+ () => false,+ );+}diff --git a/src/components/features/sidebar/use-sidebar-onboarding-checklist.ts b/src/components/features/sidebar/use-sidebar-onboarding-checklist.tsnew file mode 100644index 0000000000..410192d168--- /dev/null+++ b/src/components/features/sidebar/use-sidebar-onboarding-checklist.ts@@ -0,0 +1,159 @@+import { useEffect, useMemo, useState, useSyncExternalStore } from "react";+import { useOnboardingCompletion } from "#/components/features/onboarding/use-onboarding-completion";+import { useNavigation } from "#/context/navigation-context";+import { useAutomations } from "#/hooks/query/use-automations";+import { useAutomationHealth } from "#/hooks/query/use-automation-health";+import { usePaginatedConversations } from "#/hooks/query/use-paginated-conversations";+import { useSettings } from "#/hooks/query/use-settings";+import { useLlmProfiles } from "#/hooks/query/use-llm-profiles";+import { useLlmConfigured } from "#/hooks/use-llm-configured";+import { parseMcpConfig } from "#/utils/mcp-config";+import {+ isCustomizeChecklistPath,+ SIDEBAR_ONBOARDING_CHECKLIST_ITEM_IDS,+ type SidebarOnboardingChecklistItemId,+} from "./sidebar-onboarding-checklist.constants";+import { isConfigureLlmChecklistItemComplete } from "./sidebar-onboarding-checklist-llm-complete";+import {+ readSidebarOnboardingChecklistCustomizeExplored,+ readSidebarOnboardingChecklistMinimized,+ readSidebarOnboardingChecklistSlackJoined,+ subscribeSidebarOnboardingChecklistDismissed,+ getSidebarOnboardingChecklistDismissedSnapshot,+ writeSidebarOnboardingChecklistCustomizeExplored,+ writeSidebarOnboardingChecklistDismissed,+ writeSidebarOnboardingChecklistMinimized,+ writeSidebarOnboardingChecklistSlackJoined,+} from "./sidebar-onboarding-checklist-storage";++export interface SidebarOnboardingChecklistItemState {+ id: SidebarOnboardingChecklistItemId;+ isComplete: boolean;+}++function hasConfiguredMcpServers(mcpConfig: unknown): boolean {+ return Object.keys(parseMcpConfig(mcpConfig)).length > 0;+}++export function useSidebarOnboardingChecklist() {+ const { isCompleted: onboardingCompleted } = useOnboardingCompletion();+ const { currentPath } = useNavigation();+ const isDismissed = useSyncExternalStore(+ subscribeSidebarOnboardingChecklistDismissed,+ getSidebarOnboardingChecklistDismissedSnapshot,+ () => false,+ );+ const [isMinimized, setIsMinimized] = useState(+ readSidebarOnboardingChecklistMinimized,+ );+ const [hasExploredCustomize, setHasExploredCustomize] = useState(+ readSidebarOnboardingChecklistCustomizeExplored,+ );+ const [hasJoinedSlack, setHasJoinedSlack] = useState(+ readSidebarOnboardingChecklistSlackJoined,+ );++ const { data: settings } = useSettings();+ const { isConfigured: isLlmConfigured, isLoading: isLlmConfiguredLoading } =+ useLlmConfigured();+ const { data: profilesData, isLoading: isProfilesLoading } = useLlmProfiles();+ const { data: conversationPage } = usePaginatedConversations(1);+ const { data: healthData } = useAutomationHealth();+ const isAutomationBackendHealthy = healthData?.status === "ok";+ const { data: automationsData } = useAutomations({+ limit: 1,+ offset: 0,+ enabled: isAutomationBackendHealthy,+ });++ useEffect(() => {+ if (!isCustomizeChecklistPath(currentPath)) {+ return;+ }++ if (hasExploredCustomize) {+ return;+ }++ writeSidebarOnboardingChecklistCustomizeExplored(true);+ setHasExploredCustomize(true);+ }, [currentPath, hasExploredCustomize]);++ const completionById = useMemo(() => {+ const hasConversation = (conversationPage?.pages[0]?.items.length ?? 0) > 0;+ const hasAutomation = (automationsData?.total ?? 0) > 0;++ return {+ "configure-llm": isConfigureLlmChecklistItemComplete(+ settings,+ isLlmConfigured,+ isLlmConfiguredLoading,+ profilesData,+ isProfilesLoading,+ ),+ "connect-mcp": hasConfiguredMcpServers(+ settings?.agent_settings?.mcp_config,+ ),+ "start-conversation": hasConversation,+ "schedule-task": hasAutomation,+ "customize-agent": hasExploredCustomize,+ "join-slack": hasJoinedSlack,+ } satisfies Record<SidebarOnboardingChecklistItemId, boolean>;+ }, [+ automationsData?.total,+ conversationPage?.pages,+ hasExploredCustomize,+ hasJoinedSlack,+ isLlmConfigured,+ isLlmConfiguredLoading,+ isProfilesLoading,+ profilesData,+ settings,+ settings?.agent_settings?.mcp_config,+ ]);++ const items = useMemo(+ (): SidebarOnboardingChecklistItemState[] =>+ SIDEBAR_ONBOARDING_CHECKLIST_ITEM_IDS.map((id) => ({+ id,+ isComplete: completionById[id],+ })),+ [completionById],+ );++ const completedCount = items.filter((item) => item.isComplete).length;+ const isAllComplete = completedCount === items.length;++ const isVisible = onboardingCompleted && !isDismissed && !isAllComplete;++ const dismiss = () => {+ writeSidebarOnboardingChecklistDismissed(true);+ };++ const toggleMinimized = () => {+ setIsMinimized((current) => {+ const next = !current;+ writeSidebarOnboardingChecklistMinimized(next);+ return next;+ });+ };++ const markJoinSlackComplete = () => {+ if (hasJoinedSlack) {+ return;+ }+ writeSidebarOnboardingChecklistSlackJoined(true);+ setHasJoinedSlack(true);+ };++ return {+ items,+ completedCount,+ totalCount: items.length,+ isVisible,+ isMinimized,+ dismiss,+ toggleMinimized,+ markJoinSlackComplete,+ };+}diff --git a/src/i18n/translation.json b/src/i18n/translation.jsonindex da78aa2c0a..4ff27aa767 100644--- a/src/i18n/translation.json+++ b/src/i18n/translation.json@@ -37467,6 +37467,482 @@"uk": "Запитано дочірню розмову","ca": "S'ha sol·licitat una conversa filla"},+ "SIDEBAR$ONBOARDING_CHECKLIST_TITLE": {+ "en": "Getting started",+ "ja": "はじめに",+ "zh-CN": "入门指南",+ "zh-TW": "入門指南",+ "ko-KR": "시작하기",+ "no": "Kom i gang",+ "ar": "البدء",+ "de": "Erste Schritte",+ "fr": "Premiers pas",+ "it": "Per iniziare",+ "pt": "Primeiros passos",+ "es": "Primeros pasos",+ "ca": "Primers passos",+ "tr": "Başlarken",+ "uk": "Початок роботи"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_PROGRESS": {+ "en": "{{completed}} complete",+ "ja": "{{completed}} 完了",+ "zh-CN": "已完成 {{completed}} 项",+ "zh-TW": "已完成 {{completed}} 項",+ "ko-KR": "{{completed}}개 완료",+ "no": "{{completed}} fullført",+ "ar": "{{completed}} مكتمل",+ "de": "{{completed}} abgeschlossen",+ "fr": "{{completed}} terminé(s)",+ "it": "{{completed}} completati",+ "pt": "{{completed}} concluídos",+ "es": "{{completed}} completados",+ "ca": "{{completed}} completats",+ "tr": "{{completed}} tamamlandı",+ "uk": "{{completed}} виконано"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_START_CHAT": {+ "en": "Start your first chat",+ "ja": "最初のチャットを開始",+ "zh-CN": "开始第一次对话",+ "zh-TW": "開始第一次對話",+ "ko-KR": "첫 대화 시작하기",+ "no": "Start din første chat",+ "ar": "ابدأ أول محادثة",+ "de": "Starten Sie Ihren ersten Chat",+ "fr": "Démarrer votre première conversation",+ "it": "Avvia la tua prima chat",+ "pt": "Inicie seu primeiro chat",+ "es": "Inicia tu primer chat",+ "ca": "Inicia el teu primer xat",+ "tr": "İlk sohbetinizi başlatın",+ "uk": "Почніть перший чат"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_SCHEDULE_TASK": {+ "en": "Schedule a task",+ "ja": "タスクをスケジュール",+ "zh-CN": "安排计划任务",+ "zh-TW": "安排排程任務",+ "ko-KR": "작업 예약하기",+ "no": "Planlegg en oppgave",+ "ar": "جدولة مهمة",+ "de": "Eine Aufgabe planen",+ "fr": "Planifier une tâche",+ "it": "Pianifica un'attività",+ "pt": "Agende uma tarefa",+ "es": "Programa una tarea",+ "ca": "Programa una tasca",+ "tr": "Görev zamanla",+ "uk": "Заплануйте завдання"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_CUSTOMIZE": {+ "en": "Customize your agent",+ "ja": "エージェントをカスタマイズ",+ "zh-CN": "自定义你的智能体",+ "zh-TW": "自訂你的代理",+ "ko-KR": "에이전트 맞춤 설정",+ "no": "Tilpass agenten din",+ "ar": "خصص وكيلك",+ "de": "Passen Sie Ihren Agenten an",+ "fr": "Personnalisez votre agent",+ "it": "Personalizza il tuo agente",+ "pt": "Personalize seu agente",+ "es": "Personaliza tu agente",+ "ca": "Personalitza el teu agent",+ "tr": "Ajanınızı özelleştirin",+ "uk": "Налаштуйте свого агента"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_DISMISS": {+ "en": "Dismiss checklist",+ "ja": "チェックリストを閉じる",+ "zh-CN": "关闭清单",+ "zh-TW": "關閉清單",+ "ko-KR": "체크리스트 닫기",+ "no": "Lukk sjekklisten",+ "ar": "إخفاء قائمة التحقق",+ "de": "Checkliste ausblenden",+ "fr": "Masquer la liste",+ "it": "Nascondi checklist",+ "pt": "Dispensar checklist",+ "es": "Descartar lista",+ "ca": "Descarta la llista",+ "tr": "Kontrol listesini kapat",+ "uk": "Приховати контрольний список"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_MENU_LABEL": {+ "en": "Checklist options",+ "ja": "チェックリストのオプション",+ "zh-CN": "清单选项",+ "zh-TW": "清單選項",+ "ko-KR": "체크리스트 옵션",+ "no": "Alternativer for sjekkliste",+ "ar": "خيارات قائمة التحقق",+ "de": "Checklistenoptionen",+ "fr": "Options de la liste",+ "it": "Opzioni checklist",+ "pt": "Opções da checklist",+ "es": "Opciones de la lista",+ "ca": "Opcions de la llista",+ "tr": "Kontrol listesi seçenekleri",+ "uk": "Параметри контрольного списку"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_CONFIGURE_LLM": {+ "en": "Add LLM API key",+ "ja": "LLM APIキーを追加",+ "zh-CN": "添加 LLM API 密钥",+ "zh-TW": "新增 LLM API 金鑰",+ "ko-KR": "LLM API 키 추가",+ "no": "Legg til LLM API-nøkkel",+ "ar": "أضف مفتاح LLM API",+ "de": "LLM-API-Schlüssel hinzufügen",+ "fr": "Ajouter une clé API LLM",+ "it": "Aggiungi chiave API LLM",+ "pt": "Adicionar chave de API LLM",+ "es": "Añadir clave API de LLM",+ "ca": "Afegeix una clau API LLM",+ "tr": "LLM API anahtarı ekle",+ "uk": "Додайте ключ LLM API"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_CONNECT_MCP": {+ "en": "Connect an MCP integration",+ "ja": "MCP連携を接続",+ "zh-CN": "连接 MCP 集成",+ "zh-TW": "連接 MCP 整合",+ "ko-KR": "MCP 통합 연결",+ "no": "Koble til en MCP-integrasjon",+ "ar": "اربط تكامل MCP",+ "de": "MCP-Integration verbinden",+ "fr": "Connecter une intégration MCP",+ "it": "Connetti un'integrazione MCP",+ "pt": "Conectar uma integração MCP",+ "es": "Conectar una integración MCP",+ "ca": "Connecta una integració MCP",+ "tr": "Bir MCP entegrasyonu bağla",+ "uk": "Підключіть інтеграцію MCP"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_EXPAND": {+ "en": "Expand checklist",+ "ja": "チェックリストを展開",+ "zh-CN": "展开清单",+ "zh-TW": "展開清單",+ "ko-KR": "체크리스트 펼치기",+ "no": "Utvid sjekklisten",+ "ar": "توسيع قائمة التحقق",+ "de": "Checkliste erweitern",+ "fr": "Développer la liste",+ "it": "Espandi checklist",+ "pt": "Expandir checklist",+ "es": "Expandir lista",+ "ca": "Expandeix la llista",+ "tr": "Kontrol listesini genişlet",+ "uk": "Розгорнути контрольний список"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_COLLAPSE": {+ "en": "Minimize checklist",+ "ja": "チェックリストを最小化",+ "zh-CN": "最小化清单",+ "zh-TW": "最小化清單",+ "ko-KR": "체크리스트 최소화",+ "no": "Minimer sjekklisten",+ "ar": "تصغير قائمة التحقق",+ "de": "Checkliste minimieren",+ "fr": "Réduire la liste",+ "it": "Minimizza checklist",+ "pt": "Minimizar checklist",+ "es": "Minimizar lista",+ "ca": "Minimitza la llista",+ "tr": "Kontrol listesini küçült",+ "uk": "Згорнути контрольний список"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_CONFIGURE_LLM_DESC": {+ "en": "Connect your LLM provider and API key so the agent can reason and respond. Open LLM Settings to add or edit a profile.",+ "ja": "LLMプロバイダーとAPIキーを接続して、エージェントが推論・応答できるようにします。LLM設定でプロファイルを追加または編集してください。",+ "zh-CN": "连接 LLM 提供商和 API 密钥,让智能体能够推理和回复。打开 LLM 设置以添加或编辑配置文件。",+ "zh-TW": "連接 LLM 供應商和 API 金鑰,讓代理能夠推理和回覆。開啟 LLM 設定以新增或編輯設定檔。",+ "ko-KR": "LLM 제공업체와 API 키를 연결해 에이전트가 추론하고 응답할 수 있게 하세요. LLM 설정에서 프로필을 추가하거나 편집하세요.",+ "no": "Koble til LLM-leverandør og API-nøkkel slik at agenten kan resonere og svare. Åpne LLM-innstillinger for å legge til eller redigere en profil.",+ "ar": "اربط مزود LLM ومفتاح API حتى يتمكن الوكيل من التفكير والرد. افتح إعدادات LLM لإضافة ملف تعريف أو تعديله.",+ "de": "Verbinden Sie Ihren LLM-Anbieter und API-Schlüssel, damit der Agent denken und antworten kann. Öffnen Sie die LLM-Einstellungen, um ein Profil hinzuzufügen oder zu bearbeiten.",+ "fr": "Connectez votre fournisseur LLM et votre clé API pour que l'agent puisse raisonner et répondre. Ouvrez les paramètres LLM pour ajouter ou modifier un profil.",+ "it": "Connetti il provider LLM e la chiave API così l'agente può ragionare e rispondere. Apri Impostazioni LLM per aggiungere o modificare un profilo.",+ "pt": "Conecte seu provedor LLM e chave de API para o agente raciocinar e responder. Abra Configurações de LLM para adicionar ou editar um perfil.",+ "es": "Conecta tu proveedor LLM y clave API para que el agente pueda razonar y responder. Abre Configuración de LLM para añadir o editar un perfil.",+ "ca": "Connecta el teu proveïdor LLM i la clau API perquè l'agent pugui raonar i respondre. Obre Configuració LLM per afegir o editar un perfil.",+ "tr": "Ajanın akıl yürütüp yanıt verebilmesi için LLM sağlayıcınızı ve API anahtarınızı bağlayın. Profil eklemek veya düzenlemek için LLM Ayarlarını açın.",+ "uk": "Підключіть постачальника LLM і ключ API, щоб агент міг міркувати та відповідати. Відкрийте налаштування LLM, щоб додати або змінити профіль."+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_CONNECT_MCP_DESC": {+ "en": "MCP servers give your agent access to external tools like GitHub, Slack, or search. Browse the MCP marketplace or add a custom server.",+ "ja": "MCPサーバーにより、GitHub、Slack、検索などの外部ツールにエージェントがアクセスできます。MCPマーケットプレイスを閲覧するか、カスタムサーバーを追加してください。",+ "zh-CN": "MCP 服务器让智能体访问 GitHub、Slack 或搜索等外部工具。浏览 MCP 市场或添加自定义服务器。",+ "zh-TW": "MCP 伺服器讓代理存取 GitHub、Slack 或搜尋等外部工具。瀏覽 MCP 市集或新增自訂伺服器。",+ "ko-KR": "MCP 서버는 GitHub, Slack, 검색 등 외부 도구에 대한 에이전트 접근을 제공합니다. MCP 마켓플레이스를 둘러보거나 사용자 정의 서버를 추가하세요.",+ "no": "MCP-servere gir agenten tilgang til eksterne verktøy som GitHub, Slack eller søk. Bla gjennom MCP-markedsplassen eller legg til en egendefinert server.",+ "ar": "تمنح خوادم MCP وكيلك الوصول إلى أدوات خارجية مثل GitHub أو Slack أو البحث. تصفح سوق MCP أو أضف خادمًا مخصصًا.",+ "de": "MCP-Server geben Ihrem Agenten Zugriff auf externe Tools wie GitHub, Slack oder Suche. Durchsuchen Sie den MCP-Marktplatz oder fügen Sie einen benutzerdefinierten Server hinzu.",+ "fr": "Les serveurs MCP donnent à votre agent accès à des outils externes comme GitHub, Slack ou la recherche. Parcourez la marketplace MCP ou ajoutez un serveur personnalisé.",+ "it": "I server MCP danno al tuo agente accesso a strumenti esterni come GitHub, Slack o ricerca. Sfoglia il marketplace MCP o aggiungi un server personalizzato.",+ "pt": "Servidores MCP dão ao seu agente acesso a ferramentas externas como GitHub, Slack ou busca. Navegue pelo marketplace MCP ou adicione um servidor personalizado.",+ "es": "Los servidores MCP dan a tu agente acceso a herramientas externas como GitHub, Slack o búsqueda. Explora el marketplace MCP o añade un servidor personalizado.",+ "ca": "Els servidors MCP donen al teu agent accés a eines externes com GitHub, Slack o cerca. Navega pel marketplace MCP o afegeix un servidor personalitzat.",+ "tr": "MCP sunucuları, ajanınıza GitHub, Slack veya arama gibi harici araçlara erişim sağlar. MCP pazarını inceleyin veya özel bir sunucu ekleyin.",+ "uk": "Сервери MCP дають агенту доступ до зовнішніх інструментів, таких як GitHub, Slack або пошук. Перегляньте маркетплейс MCP або додайте власний сервер."+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_START_CHAT_DESC": {+ "en": "Open a chat and send your first message. The agent can run commands, edit files, and help with code in your workspace.",+ "ja": "チャットを開いて最初のメッセージを送信してください。エージェントはコマンドの実行、ファイル編集、ワークスペース内のコード支援ができます。",+ "zh-CN": "打开对话并发送第一条消息。智能体可以运行命令、编辑文件,并在工作区中协助编写代码。",+ "zh-TW": "開啟對話並傳送第一則訊息。代理可以執行命令、編輯檔案,並在工作區中協助撰寫程式碼。",+ "ko-KR": "채팅을 열고 첫 메시지를 보내세요. 에이전트는 명령 실행, 파일 편집, 작업 공간의 코드 지원을 할 수 있습니다.",+ "no": "Åpne en chat og send din første melding. Agenten kan kjøre kommandoer, redigere filer og hjelpe med kode i arbeidsområdet ditt.",+ "ar": "افتح محادثة وأرسل رسالتك الأولى. يمكن للوكيل تشغيل الأوامر وتحرير الملفات والمساعدة في الكود في مساحة العمل.",+ "de": "Öffnen Sie einen Chat und senden Sie Ihre erste Nachricht. Der Agent kann Befehle ausführen, Dateien bearbeiten und bei Code in Ihrem Workspace helfen.",+ "fr": "Ouvrez une conversation et envoyez votre premier message. L'agent peut exécuter des commandes, modifier des fichiers et aider avec le code dans votre espace de travail.",+ "it": "Apri una chat e invia il tuo primo messaggio. L'agente può eseguire comandi, modificare file e aiutare con il codice nel tuo workspace.",+ "pt": "Abra um chat e envie sua primeira mensagem. O agente pode executar comandos, editar arquivos e ajudar com código no seu workspace.",+ "es": "Abre un chat y envía tu primer mensaje. El agente puede ejecutar comandos, editar archivos y ayudar con código en tu espacio de trabajo.",+ "ca": "Obre un xat i envia el teu primer missatge. L'agent pot executar ordres, editar fitxers i ajudar amb codi al teu espai de treball.",+ "tr": "Bir sohbet açın ve ilk mesajınızı gönderin. Ajan, çalışma alanınızda komut çalıştırabilir, dosyaları düzenleyebilir ve kod konusunda yardımcı olabilir.",+ "uk": "Відкрийте чат і надішліть перше повідомлення. Агент може виконувати команди, редагувати файли та допомагати з кодом у вашому робочому просторі."+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_SCHEDULE_TASK_DESC": {+ "en": "Automations run on a schedule or trigger. Create a scheduled task to have the agent work for you in the background.",+ "ja": "オートメーションはスケジュールまたはトリガーで実行されます。スケジュールタスクを作成して、エージェントにバックグラウンドで作業させましょう。",+ "zh-CN": "自动化可按计划或触发条件运行。创建计划任务,让智能体在后台为你工作。",+ "zh-TW": "自動化可依排程或觸發條件執行。建立排程任務,讓代理在背景為你工作。",+ "ko-KR": "자동화는 일정 또는 트리거로 실행됩니다. 예약 작업을 만들어 에이전트가 백그라운드에서 작업하도록 하세요.",+ "no": "Automatiseringer kjører etter en plan eller utløser. Opprett en planlagt oppgave for at agenten skal jobbe for deg i bakgrunnen.",+ "ar": "تعمل الأتمتة وفق جدول أو محفز. أنشئ مهمة مجدولة ليعمل الوكيل لك في الخلفية.",+ "de": "Automatisierungen laufen nach Zeitplan oder Auslöser. Erstellen Sie eine geplante Aufgabe, damit der Agent im Hintergrund für Sie arbeitet.",+ "fr": "Les automatisations s'exécutent selon un planning ou un déclencheur. Créez une tâche planifiée pour que l'agent travaille pour vous en arrière-plan.",+ "it": "Le automazioni vengono eseguite su programma o trigger. Crea un'attività pianificata per far lavorare l'agente in background.",+ "pt": "Automações rodam em agenda ou gatilho. Crie uma tarefa agendada para o agente trabalhar para você em segundo plano.",+ "es": "Las automatizaciones se ejecutan según un horario o un disparador. Crea una tarea programada para que el agente trabaje en segundo plano.",+ "ca": "Les automatitzacions s'executen segons un horari o un disparador. Crea una tasca programada perquè l'agent treballi en segon pla.",+ "tr": "Otomasyonlar bir zamanlamaya veya tetikleyiciye göre çalışır. Arka planda sizin için çalışması için zamanlanmış bir görev oluşturun.",+ "uk": "Автоматизації запускаються за розкладом або тригером. Створіть заплановане завдання, щоб агент працював для вас у фоновому режимі."+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_CUSTOMIZE_DESC": {+ "en": "Choose or create an agent profile to control which agent and model run your conversations.",+ "ja": "会話で使うエージェントとモデルを選ぶために、エージェントプロファイルを選択または作成してください。",+ "zh-CN": "选择或创建智能体配置文件,以控制对话使用的智能体和模型。",+ "zh-TW": "選擇或建立代理設定檔,以控制對話使用的代理與模型。",+ "ko-KR": "대화에 사용할 에이전트와 모델을 정하려면 에이전트 프로필을 선택하거나 만드세요.",+ "no": "Velg eller opprett en agentprofil for å styre hvilken agent og modell som kjører samtalene dine.",+ "ar": "اختر أو أنشئ ملف تعريف للوكيل للتحكم في الوكيل والنموذج اللذين يشغّلان محادثاتك.",+ "de": "Wählen oder erstellen Sie ein Agentenprofil, um festzulegen, welcher Agent und welches Modell Ihre Unterhaltungen ausführt.",+ "fr": "Choisissez ou créez un profil d'agent pour contrôler quel agent et quel modèle exécutent vos conversations.",+ "it": "Scegli o crea un profilo agente per controllare quale agente e modello eseguono le tue conversazioni.",+ "pt": "Escolha ou crie um perfil de agente para controlar qual agente e modelo executam suas conversas.",+ "es": "Elige o crea un perfil de agente para controlar qué agente y modelo ejecutan tus conversaciones.",+ "ca": "Tria o crea un perfil d'agent per controlar quin agent i model executen les teves converses.",+ "tr": "Konuşmalarınızı hangi ajan ve modelin çalıştıracağını kontrol etmek için bir ajan profili seçin veya oluşturun.",+ "uk": "Виберіть або створіть профіль агента, щоб керувати тим, який агент і модель запускають ваші розмови."+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_ITEM_COMPLETE": {+ "en": "Complete",+ "ja": "完了",+ "zh-CN": "已完成",+ "zh-TW": "已完成",+ "ko-KR": "완료",+ "no": "Fullført",+ "ar": "مكتمل",+ "de": "Abgeschlossen",+ "fr": "Terminé",+ "it": "Completato",+ "pt": "Concluído",+ "es": "Completado",+ "ca": "Completat",+ "tr": "Tamamlandı",+ "uk": "Виконано"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_DOCS_LINK": {+ "en": "Documentation",+ "ja": "ドキュメント",+ "zh-CN": "文档",+ "zh-TW": "文件",+ "ko-KR": "문서",+ "no": "Dokumentasjon",+ "ar": "التوثيق",+ "de": "Dokumentation",+ "fr": "Documentation",+ "it": "Documentazione",+ "pt": "Documentação",+ "es": "Documentación",+ "ca": "Documentació",+ "tr": "Dokümantasyon",+ "uk": "Документація"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_ACTION_CONFIGURE_LLM": {+ "en": "Add key",+ "ja": "キーを追加",+ "zh-CN": "添加密钥",+ "zh-TW": "新增金鑰",+ "ko-KR": "키 추가",+ "no": "Legg til nøkkel",+ "ar": "أضف مفتاحًا",+ "de": "Schlüssel hinzufügen",+ "fr": "Ajouter une clé",+ "it": "Aggiungi chiave",+ "pt": "Adicionar chave",+ "es": "Añadir clave",+ "ca": "Afegeix clau",+ "tr": "Anahtar ekle",+ "uk": "Додати ключ"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_ACTION_START_CHAT": {+ "en": "Start chat",+ "ja": "チャット開始",+ "zh-CN": "开始对话",+ "zh-TW": "開始對話",+ "ko-KR": "채팅 시작",+ "no": "Start chat",+ "ar": "ابدأ المحادثة",+ "de": "Chat starten",+ "fr": "Démarrer le chat",+ "it": "Avvia chat",+ "pt": "Iniciar chat",+ "es": "Iniciar chat",+ "ca": "Inicia xat",+ "tr": "Sohbeti başlat",+ "uk": "Почати чат"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_ACTION_SCHEDULE_TASK": {+ "en": "Schedule",+ "ja": "スケジュール",+ "zh-CN": "安排计划",+ "zh-TW": "安排排程",+ "ko-KR": "예약하기",+ "no": "Planlegg",+ "ar": "جدولة",+ "de": "Planen",+ "fr": "Planifier",+ "it": "Pianifica",+ "pt": "Agendar",+ "es": "Programar",+ "ca": "Programa",+ "tr": "Zamanla",+ "uk": "Запланувати"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_ACTION_CUSTOMIZE": {+ "en": "Customize",+ "ja": "カスタマイズ",+ "zh-CN": "自定义",+ "zh-TW": "自訂",+ "ko-KR": "맞춤 설정",+ "no": "Tilpass",+ "ar": "خصص",+ "de": "Anpassen",+ "fr": "Personnaliser",+ "it": "Personalizza",+ "pt": "Personalizar",+ "es": "Personalizar",+ "ca": "Personalitza",+ "tr": "Özelleştir",+ "uk": "Налаштувати"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_ACTION_CONNECT_MCP": {+ "en": "Connect",+ "ja": "接続",+ "zh-CN": "连接",+ "zh-TW": "連接",+ "ko-KR": "연결",+ "no": "Koble til",+ "ar": "اربط",+ "de": "Verbinden",+ "fr": "Connecter",+ "it": "Connetti",+ "pt": "Conectar",+ "es": "Conectar",+ "ca": "Connecta",+ "tr": "Bağlan",+ "uk": "Підключити"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_JOIN_SLACK": {+ "en": "Join the OpenHands Slack",+ "ja": "OpenHands Slackに参加",+ "zh-CN": "加入 OpenHands Slack",+ "zh-TW": "加入 OpenHands Slack",+ "ko-KR": "OpenHands Slack 참여",+ "no": "Bli med i OpenHands Slack",+ "ar": "انضم إلى OpenHands على Slack",+ "de": "Treten Sie dem OpenHands Slack bei",+ "fr": "Rejoindre le Slack OpenHands",+ "it": "Unisciti allo Slack di OpenHands",+ "pt": "Participe do Slack do OpenHands",+ "es": "Únete al Slack de OpenHands",+ "ca": "Uneix-te al Slack d'OpenHands",+ "tr": "OpenHands Slack'e katılın",+ "uk": "Приєднайтеся до OpenHands у Slack"+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_JOIN_SLACK_DESC": {+ "en": "Meet other OpenHands users and the team. Open the Slack invite to join the conversation.",+ "ja": "他のOpenHandsユーザーやチームとつながりましょう。Slackの招待リンクを開いて会話に参加してください。",+ "zh-CN": "结识其他 OpenHands 用户和团队。打开 Slack 邀请链接加入讨论。",+ "zh-TW": "認識其他 OpenHands 用戶與團隊。開啟 Slack 邀請連結加入討論。",+ "ko-KR": "다른 OpenHands 사용자와 팀을 만나보세요. Slack 초대 링크를 열어 대화에 참여하세요.",+ "no": "Møt andre OpenHands-brukere og teamet. Åpne Slack-invitasjonen for å bli med i samtalen.",+ "ar": "تعرّف على مستخدمي OpenHands الآخرين والفريق. افتح دعوة Slack للانضمام إلى المحادثة.",+ "de": "Treffen Sie andere OpenHands-Nutzer und das Team. Öffnen Sie die Slack-Einladung, um der Unterhaltung beizutreten.",+ "fr": "Rencontrez d'autres utilisateurs OpenHands et l'équipe. Ouvrez l'invitation Slack pour rejoindre la conversation.",+ "it": "Incontra altri utenti OpenHands e il team. Apri l'invito Slack per unirti alla conversazione.",+ "pt": "Conheça outros usuários do OpenHands e a equipe. Abra o convite do Slack para entrar na conversa.",+ "es": "Conoce a otros usuarios de OpenHands y al equipo. Abre la invitación de Slack para unirte a la conversación.",+ "ca": "Coneix altres usuaris d'OpenHands i l'equip. Obre la invitació de Slack per unir-te a la conversa.",+ "tr": "Diğer OpenHands kullanıcıları ve ekiple tanışın. Sohbete katılmak için Slack davetini açın.",+ "uk": "Познайомтеся з іншими користувачами OpenHands і командою. Відкрийте запрошення в Slack, щоб приєднатися до розмови."+ },+ "SIDEBAR$ONBOARDING_CHECKLIST_ACTION_JOIN_SLACK": {+ "en": "Join Slack",+ "ja": "Slackに参加",+ "zh-CN": "加入 Slack",+ "zh-TW": "加入 Slack",+ "ko-KR": "Slack 참여",+ "no": "Bli med i Slack",+ "ar": "انضم إلى Slack",+ "de": "Slack beitreten",+ "fr": "Rejoindre Slack",+ "it": "Unisciti a Slack",+ "pt": "Entrar no Slack",+ "es": "Unirse a Slack",+ "ca": "Uneix-te a Slack",+ "tr": "Slack'e katıl",+ "uk": "Приєднатися до Slack"+ },+ "SETTINGS$SHOW_GETTING_STARTED_CHECKLIST": {+ "en": "Show Getting Started checklist",+ "ja": "Getting Started チェックリストを表示",+ "zh-CN": "显示入门清单",+ "zh-TW": "顯示入門清單",+ "ko-KR": "시작하기 체크리스트 표시",+ "de": "Getting-Started-Checkliste anzeigen",+ "no": "Vis Kom i gang-sjekkliste",+ "it": "Mostra checklist Per iniziare",+ "pt": "Mostrar checklist Primeiros passos",+ "es": "Mostrar lista Primeros pasos",+ "ar": "إظهار قائمة البدء",+ "fr": "Afficher la checklist Premiers pas",+ "tr": "Başlarken kontrol listesini göster",+ "uk": "Показувати контрольний список «Початок роботи»",+ "ca": "Mostra la llista Per començar"+ },+ "ONBOARDING$SKIP_GETTING_STARTED_CHECKLIST": {+ "en": "Skip Getting Started checklist",+ "ja": "Getting Started チェックリストをスキップ",+ "zh-CN": "跳过入门清单",+ "zh-TW": "略過入門清單",+ "ko-KR": "시작하기 체크리스트 건너뛰기",+ "de": "Getting-Started-Checkliste überspringen",+ "no": "Hopp over Kom i gang-sjekklisten",+ "it": "Salta la checklist Per iniziare",+ "pt": "Pular checklist Primeiros passos",+ "es": "Omitir lista Primeros pasos",+ "ar": "تخطي قائمة البدء",+ "fr": "Ignorer la checklist Premiers pas",+ "tr": "Başlarken kontrol listesini atla",+ "uk": "Пропустити контрольний список «Початок роботи»",+ "ca": "Omet la llista Per començar"+ },"AUTOMATIONS$GIT_SYNC$NAV_BUTTON": {"en": "Git Sync","ja": "Git同期",diff --git a/src/routes/app-settings.tsx b/src/routes/app-settings.tsxindex 6ff8c69119..b6e76b0e04 100644--- a/src/routes/app-settings.tsx+++ b/src/routes/app-settings.tsx@@ -11,6 +11,7 @@ import { SettingsInput } from "#/components/features/settings/settings-input";import { I18nKey } from "#/i18n/declaration";import { LanguageInput } from "#/components/features/settings/app-settings/language-input";import { ThemeInput } from "#/components/features/settings/app-settings/theme-input";+import { GettingStartedChecklistSwitch } from "#/components/features/settings/app-settings/getting-started-checklist-switch";import {displayErrorToast,displaySuccessToast,@@ -219,6 +220,8 @@ export function AppSettingsScreen() {{t(I18nKey.SETTINGS$SOUND_NOTIFICATIONS)}</SettingsSwitch>+ <GettingStartedChecklistSwitch />+<div className="border-t border-[var(--oh-border)] pt-6 mt-2"><h3 className="text-lg font-medium mb-2">{t(I18nKey.SETTINGS$CONVERSATION_TITLES)}