diff --git a/surfaces/cli/src/commands/app.test.ts b/surfaces/cli/src/commands/app.test.ts
index 42c96c308..2d09a5d28 100644
--- a/surfaces/cli/src/commands/app.test.ts
+++ b/surfaces/cli/src/commands/app.test.ts
@@ -25,6 +25,50 @@ describe("registerAppCommands", () => {
 		expect(calls).toEqual([[]]);
 	});
 
+	test("passes setup mode to the setup wizard", async () => {
+		const calls: unknown[] = [];
+		const program = new Command();
+
+		registerAppCommands(program, {
+			collectListOption: (value, previous) => [...previous, value],
+			configureAgent: async () => {},
+			launchDashboard: async () => {},
+			migrateSchema: async () => {},
+			setupWizard: async (options) => {
+				calls.push(options);
+			},
+			showDoctor: async () => {},
+			showStatus: async () => {},
+			syncTemplates: async () => {},
+		});
+
+		await program.parseAsync(["node", "test", "setup", "--setup-mode", "dashboard"]);
+
+		expect(calls).toEqual([expect.objectContaining({ setupMode: "dashboard" })]);
+	});
+
+	test("rejects malformed setup option tokens as excess arguments", async () => {
+		const calls: unknown[] = [];
+		const program = new Command();
+		program.exitOverride();
+
+		registerAppCommands(program, {
+			collectListOption: (value, previous) => [...previous, value],
+			configureAgent: async () => {},
+			launchDashboard: async () => {},
+			migrateSchema: async () => {},
+			setupWizard: async (options) => {
+				calls.push(options);
+			},
+			showDoctor: async () => {},
+			showStatus: async () => {},
+			syncTemplates: async () => {},
+		});
+
+		await expect(program.parseAsync(["node", "test", "setup", " --setup-mode", "dashboard"])).rejects.toThrow();
+		expect(calls).toEqual([]);
+	});
+
 	test("routes doctor target into doctor options", async () => {
 		const calls: unknown[] = [];
 		const program = new Command();
diff --git a/surfaces/cli/src/commands/app.ts b/surfaces/cli/src/commands/app.ts
index e88e2e689..1e9480bfe 100644
--- a/surfaces/cli/src/commands/app.ts
+++ b/surfaces/cli/src/commands/app.ts
@@ -24,6 +24,7 @@ interface SetupOptions {
 	disableSignetSecrets?: boolean;
 	withGraphiq?: boolean;
 	disableGraphiq?: boolean;
+	setupMode?: string;
 }
 
 interface PathOptions {
@@ -49,9 +50,11 @@ interface AppDeps {
 export function registerAppCommands(program: Command, deps: AppDeps): void {
 	program
 		.command("setup")
+		.allowExcessArguments(false)
 		.description("Setup wizard (interactive by default)")
 		.option("-p, --path <path>", "Base path for agent files")
 		.option("--non-interactive", "Run setup without prompts")
+		.option("--setup-mode <mode>", "Interactive setup surface (terminal, dashboard)")
 		.option("--name <name>", "Agent name (non-interactive mode)")
 		.option("--description <description>", "Agent description (non-interactive mode)")
 		.option(
@@ -72,7 +75,7 @@ export function registerAppCommands(program: Command, deps: AppDeps): void {
 		.option("--embedding-model <model>", "Embedding model in non-interactive mode")
 		.option(
 			"--extraction-provider <provider>",
-			"Extraction provider in non-interactive mode (claude-code, codex, llama-cpp, ollama, opencode, openrouter, openai-compatible, none)",
+			"Extraction provider in non-interactive mode (acpx, claude-code, codex, llama-cpp, ollama, opencode, openrouter, openai-compatible, none)",
 		)
 		.option("--extraction-model <model>", "Extraction model in non-interactive mode")
 		.option("--extraction-endpoint <url>", "OpenAI-compatible extraction endpoint in non-interactive mode")
diff --git a/surfaces/cli/src/features/setup-types.ts b/surfaces/cli/src/features/setup-types.ts
index 5aa7a6588..1af2293cf 100644
--- a/surfaces/cli/src/features/setup-types.ts
+++ b/surfaces/cli/src/features/setup-types.ts
@@ -30,7 +30,8 @@ export interface SetupWizardOptions {
 	disableSignetSecrets?: boolean;
 	withGraphiq?: boolean;
 	disableGraphiq?: boolean;
-	identityPreset?: string;
+		identityPreset?: string;
+		setupMode?: string;
 }
 
 export interface SetupDeps {
diff --git a/surfaces/cli/src/features/setup.ts b/surfaces/cli/src/features/setup.ts
index d280f0b3b..fa5b7fadd 100644
--- a/surfaces/cli/src/features/setup.ts
+++ b/surfaces/cli/src/features/setup.ts
@@ -180,6 +180,8 @@ export async function setupWizard(options: SetupWizardOptions, deps: SetupDeps):
 	const requestedExtractionProvider = deps.normalizeChoice(rawExtractionProvider, EXTRACTION_PROVIDER_CHOICES);
 	const rawExtractionEndpoint = deps.normalizeStringValue(options.extractionEndpoint);
 	const requestedExtractionEndpoint = normalizeHttpEndpoint(rawExtractionEndpoint);
+	const rawSetupMode = deps.normalizeStringValue(options.setupMode);
+	const requestedSetupMode = deps.normalizeChoice(rawSetupMode, ["terminal", "dashboard"] as const);
 	const existingName = readString(existingConfig.name) ?? readString(existingAgent.name) ?? "My Agent";
 	const existingDesc =
 		readString(existingConfig.description) ?? readString(existingAgent.description) ?? "Personal AI assistant";
@@ -228,6 +230,9 @@ export async function setupWizard(options: SetupWizardOptions, deps: SetupDeps):
 	if (rawExtractionEndpoint && !requestedExtractionEndpoint) {
 		failSetupValidation("--extraction-endpoint must be an http:// or https:// URL.");
 	}
+	if (rawSetupMode && !requestedSetupMode) {
+		failSetupValidation(`Unknown --setup-mode value: ${rawSetupMode}. Valid choices: terminal, dashboard.`);
+	}
 	const unknownHarnessValues = findUnknownHarnessValues(options.harness, deps);
 	if (nonInteractive && unknownHarnessValues.length > 0) {
 		failNonInteractiveSetup(
@@ -497,13 +502,16 @@ export async function setupWizard(options: SetupWizardOptions, deps: SetupDeps):
 
 		const setupMethod = nonInteractive
 			? "new"
-			: await select({
-					message: "How would you like to set up?",
-					choices: [
-						{ value: "new", name: "Create new agent identity" },
-						{ value: "github", name: "Import from GitHub repository" },
-					],
-				});
+			: requestedSetupMode === "dashboard"
+				? "dashboard"
+				: await select({
+						message: "How would you like to set up?",
+						choices: [
+							{ value: "new", name: "Create new agent identity in terminal" },
+							{ value: "dashboard", name: "Create defaults and finish in dashboard" },
+							{ value: "github", name: "Import from GitHub repository" },
+						],
+					});
 
 		if (setupMethod === "github") {
 			mkdirSync(basePath, { recursive: true });
@@ -511,6 +519,61 @@ export async function setupWizard(options: SetupWizardOptions, deps: SetupDeps):
 			await deps.importFromGitHub(basePath);
 			return;
 		}
+		if (setupMethod === "dashboard") {
+			const deploymentType = requestedDeploymentType ?? "local";
+			const embeddingProvider = requestedEmbeddingProvider ?? defaultEmbeddingProviderForDeployment(deploymentType);
+			let embeddingModel = deps.normalizeStringValue(options.embeddingModel) || "nomic-embed-text-v1.5";
+			let embeddingDimensions = getEmbeddingDimensions(embeddingModel);
+			if (embeddingProvider === "native") {
+				embeddingModel = "nomic-embed-text-v1.5";
+				embeddingDimensions = 768;
+			}
+			const harnesses = normalizeHarnessList(options.harness, deps);
+			const extractionProvider = resolveSetupExtractionProvider({
+				deploymentType,
+				requestedProvider: requestedExtractionProvider,
+				preserveExisting: false,
+				detectedProvider,
+				availableProviders: availableToolExtractionProviders,
+				preferredHarnesses: harnesses,
+			});
+			const extractionModel =
+				deps.normalizeStringValue(options.extractionModel) || defaultExtractionModel(extractionProvider);
+			await runFreshSetup(
+				{
+					basePath,
+					agentName: deps.normalizeStringValue(options.name) || existingName,
+					agentDescription: deps.normalizeStringValue(options.description) || existingDesc,
+					networkMode: deps.normalizeChoice(options.networkMode, NETWORK_MODES) ?? "localhost",
+					harnesses,
+					openclawRuntimePath: deps.normalizeChoice(options.openclawRuntimePath, OPENCLAW_RUNTIME_CHOICES) ?? "plugin",
+					configureOpenClawWs: options.configureOpenclawWorkspace === true,
+					openclawConfigCount: new OpenClawConnector().getDiscoveredConfigPaths().length,
+					embeddingProvider,
+					embeddingModel,
+					embeddingDimensions,
+					extractionProvider,
+					extractionModel,
+					availableExtractionProviders: availableToolExtractionProviders,
+					acpxBin,
+					searchBalance: deps.parseSearchBalanceValue(options.searchBalance) ?? 0.7,
+					searchTopK: 20,
+					searchMinScore: 0.3,
+					memorySessionBudget: 2000,
+					memoryDecayRate: 0.95,
+					gitEnabled: options.skipGit !== true,
+					existingAgentsDir: existing.agentsDir,
+					nonInteractive: true,
+					openDashboard: true,
+					allowUnprotectedWorkspace: options.allowUnprotectedWorkspace === true,
+					createLocalBackup: options.createLocalBackup === true,
+					signetSecretsEnabled: await resolveSignetSecretsCorePluginSelection(basePath, true, options),
+					graphiqEnabled: await resolveGraphiqPluginSelection(basePath, true, options),
+				},
+				deps,
+			);
+			return;
+		}
 		console.log();
 	}
 
diff --git a/surfaces/dashboard/src/lib/components/onboarding/OnboardingModal.svelte b/surfaces/dashboard/src/lib/components/onboarding/OnboardingModal.svelte
new file mode 100644
index 000000000..6bb8547f2
--- /dev/null
+++ b/surfaces/dashboard/src/lib/components/onboarding/OnboardingModal.svelte
@@ -0,0 +1,590 @@
+<script lang="ts">
+	import { invalidateAll } from "$app/navigation";
+	import { type ConfigFile, type DaemonStatus, type Harness, type MemoryStats, saveConfigFileResult } from "$lib/api";
+	import { Button } from "$lib/components/ui/button/index.js";
+	import { applyRecommendedPipelineSetup, resolveSynthesisEnabled } from "$lib/components/tabs/settings/pipeline-settings";
+	import { KNOWN_HARNESSES, st } from "$lib/stores/settings.svelte";
+	import { toast } from "$lib/stores/toast.svelte";
+	import type { TabId } from "$lib/stores/navigation.svelte";
+	import { defaultPipelineModel, type PipelineProviderChoice } from "@signet/core/pipeline-providers";
+	import { onMount, untrack } from "svelte";
+	import { fly } from "svelte/transition";
+	import { stringify } from "yaml";
+	import {
+		type OnboardingState,
+		type EmbeddingProvider,
+		type IdentityPresetName,
+		EMBEDDING_PROVIDER_OPTIONS,
+		EXTRACTION_PROVIDER_OPTIONS,
+		EXTRACTION_MODEL_PRESETS,
+		createDefaultState,
+	} from "./onboarding-state.svelte";
+	import WelcomeStep from "./steps/WelcomeStep.svelte";
+	import IdentityStep from "./steps/IdentityStep.svelte";
+	import EmbeddingStep from "./steps/EmbeddingStep.svelte";
+	import ExtractionStep from "./steps/ExtractionStep.svelte";
+	import ReviewStep from "./steps/ReviewStep.svelte";
+
+	interface Props {
+		configFiles: ConfigFile[];
+		memoryStats: MemoryStats;
+		daemonStatus: DaemonStatus | null;
+		harnesses?: Harness[];
+		onnavigate?: (tab: TabId) => void;
+	}
+
+	const { configFiles, memoryStats, daemonStatus, harnesses = [], onnavigate }: Props = $props();
+
+	const STEPS = [
+		{ number: "01", title: "Welcome", subtitle: "Choose an identity preset for your agent." },
+		{ number: "02", title: "Identity", subtitle: "Name your agent and select harnesses." },
+		{ number: "03", title: "Embeddings", subtitle: "Configure vector search for semantic recall." },
+		{ number: "04", title: "Extraction", subtitle: "Pick an extraction route for the memory pipeline." },
+		{ number: "05", title: "Review", subtitle: "Confirm your choices before saving." },
+	];
+
+	let open = $state(false);
+	let initialized = $state(false);
+	let forceOpen = false;
+	let direction = $state<1 | -1>(1);
+	let obState = $state<OnboardingState>(createDefaultState());
+
+	const storageKey = $derived(`signet:onboarding:dismissed:${daemonStatus?.agentsDir ?? "unknown"}`);
+
+	function readPipelineString(...path: string[]): string {
+		return st.aStr(["memory", "pipelineV2", ...path]);
+	}
+
+	function hydrateFromSettings(): void {
+		st.init(configFiles);
+		obState.agentName = st.aStr(["agent", "name"]) || st.aStr(["name"]) || "My Agent";
+		obState.agentDescription = st.aStr(["agent", "description"]) || st.aStr(["description"]) || "Personal AI assistant";
+		obState.identityPreset = (st.aStr(["identity", "preset"]) || "minimal") as IdentityPresetName;
+
+		const harnessFromApi = harnesses.map((h) => h.id || h.name).filter(Boolean);
+		const combined = [...new Set([...harnessFromApi, ...KNOWN_HARNESSES])];
+		obState.selectedHarnesses = st.harnessArray();
+		if (obState.selectedHarnesses.length === 0 && combined.length > 0) {
+			obState.selectedHarnesses = [combined[0]];
+		}
+		obState.selectedHarness = obState.selectedHarnesses[0] ?? "";
+
+		const embProvider = st.sStr([...st.embPath(), "provider"]) || "native";
+		obState.embeddingProvider = EMBEDDING_PROVIDER_OPTIONS.some((o) => o.value === embProvider) ? embProvider as EmbeddingProvider : "native";
+		obState.embeddingModel =
+			st.sStr([...st.embPath(), "model"]) ||
+			(EMBEDDING_PROVIDER_OPTIONS.find((o) => o.value === obState.embeddingProvider)?.defaultModel ?? "");
+		obState.embeddingEndpoint = st.sStr([...st.embPath(), "base_url"]) || st.sStr([...st.embPath(), "baseurl"]) || "";
+
+		const rawProvider =
+			readPipelineString("extractionProvider") || readPipelineString("extraction", "provider");
+		obState.extractionProvider = EXTRACTION_PROVIDER_OPTIONS.some((o) => o.value === rawProvider)
+			? (rawProvider as PipelineProviderChoice)
+			: "acpx";
+		obState.extractionModel =
+			readPipelineString("extractionModel") ||
+			readPipelineString("extraction", "model") ||
+			defaultPipelineModel(obState.extractionProvider);
+		obState.extractionEndpoint =
+			readPipelineString("extraction", "endpoint") ||
+			readPipelineString("extractionEndpoint") ||
+			readPipelineString("extractionBaseUrl") ||
+			"";
+		obState.synthesisEnabled = resolveSynthesisEnabled(st.agent);
+		initialized = true;
+	}
+
+	function isDefaultishWorkspace(): boolean {
+		const name = obState.agentName.trim().toLowerCase();
+		return memoryStats.total === 0 && (name === "my agent" || name.length === 0);
+	}
+
+	function maybeOpen(): void {
+		if (typeof window === "undefined") return;
+		if (!initialized || !daemonStatus) return;
+		if (forceOpen) {
+			open = true;
+			return;
+		}
+		if (localStorage.getItem(storageKey) === "true") return;
+		if (isDefaultishWorkspace()) open = true;
+	}
+
+	onMount(() => {
+		forceOpen = new URLSearchParams(window.location.search).get("onboarding") === "1";
+		untrack(hydrateFromSettings);
+		maybeOpen();
+	});
+
+	$effect(() => {
+		const _configFiles = configFiles;
+		const _harnesses = harnesses;
+		void _configFiles;
+		void _harnesses;
+		untrack(hydrateFromSettings);
+	});
+
+	$effect(() => {
+		const _daemonStatus = daemonStatus;
+		const _memoryTotal = memoryStats.total;
+		void _daemonStatus;
+		void _memoryTotal;
+		maybeOpen();
+	});
+
+	function dismiss(): void {
+		forceOpen = false;
+		localStorage.setItem(storageKey, "true");
+		open = false;
+	}
+
+	function openSettings(): void {
+		dismiss();
+		onnavigate?.("settings");
+	}
+
+	function validateStep(step: number): string[] {
+		if (step === 1) {
+			const errors: string[] = [];
+			if (!obState.agentName.trim()) errors.push("Agent name is required.");
+			if (obState.selectedHarnesses.length === 0) errors.push("Select at least one harness.");
+			return errors;
+		}
+		if (step === 2) {
+			if (obState.embeddingProvider === "none") return [];
+			if (!obState.embeddingModel.trim()) return ["Embedding model is required."];
+			return [];
+		}
+		if (step === 3) {
+			if (obState.extractionProvider === "none") return [];
+			if (!obState.extractionModel.trim()) return ["Extraction model is required."];
+			return [];
+		}
+		return [];
+	}
+
+	function nextStep(): void {
+		const errors = validateStep(obState.currentStep);
+		if (errors.length > 0) {
+			toast(errors[0], "error");
+			return;
+		}
+		direction = 1;
+		obState.currentStep = Math.min(obState.currentStep + 1, STEPS.length - 1);
+	}
+
+	function prevStep(): void {
+		direction = -1;
+		obState.currentStep = Math.max(obState.currentStep - 1, 0);
+	}
+
+	async function persistOnboardingConfig(): Promise<void> {
+		if (st.agentFile) {
+			await st.save();
+			return;
+		}
+		const result = await saveConfigFileResult("agent.yaml", stringify(st.agent));
+		if (!result.ok) throw new Error(result.error ?? `Failed to create agent.yaml (${result.status})`);
+		st.agentSnapshot = JSON.stringify(st.agent);
+	}
+
+	async function finish(): Promise<void> {
+		if (obState.saving) return;
+		obState.saving = true;
+		try {
+			st.aSetStr(["agent", "name"], obState.agentName.trim() || "My Agent");
+			st.aSetStr(["agent", "description"], obState.agentDescription.trim() || "Personal AI assistant");
+			st.aSetStr(["identity", "preset"], obState.identityPreset);
+			st.set(st.agent, ["harnesses"], obState.selectedHarnesses);
+
+			const needsEndpoint = (() => {
+				const mode = EXTRACTION_PROVIDER_OPTIONS.find((o) => o.value === obState.extractionProvider)?.mode;
+				return mode === "local" || mode === "api";
+			})();
+
+			applyRecommendedPipelineSetup(st.agent, {
+				provider: obState.extractionProvider,
+				model: obState.extractionModel,
+				endpoint: needsEndpoint ? obState.extractionEndpoint : "",
+				acpxHarness: obState.extractionProvider === "acpx" ? obState.selectedHarness : "",
+				synthesisEnabled: obState.synthesisEnabled,
+			});
+
+			st.agent = { ...st.agent };
+			await persistOnboardingConfig();
+			forceOpen = false;
+			localStorage.setItem(storageKey, "true");
+			open = false;
+			await invalidateAll();
+			toast("Setup complete", "success");
+			onnavigate?.("sources");
+		} finally {
+			obState.saving = false;
+		}
+	}
+</script>
+
+{#if open}
+	<div class="onboarding-backdrop" role="presentation">
+		<div class="onboarding-modal sig-panel" role="dialog" aria-modal="true" aria-labelledby="onboarding-title" tabindex="-1">
+			<header class="onboarding-header sig-panel-header">
+				<div class="header-copy">
+					<div class="header-kicker">
+						<span class="signal-dot"></span>
+						<span>SETUP_SEQUENCE</span>
+						<span class="header-step">{STEPS[obState.currentStep].number} / {String(STEPS.length).padStart(2, "0")}</span>
+					</div>
+					<h2 id="onboarding-title">Initialize Signet</h2>
+					<p class="lede">{STEPS[obState.currentStep].subtitle}</p>
+				</div>
+
+				<div class="progress-track">
+					{#each STEPS as step, i (i)}
+						<button
+							type="button"
+							class="progress-dot"
+							class:progress-dot-active={i === obState.currentStep}
+							class:progress-dot-done={i < obState.currentStep}
+							disabled={i > obState.currentStep}
+							onclick={() => { if (i < obState.currentStep) { direction = -1; obState.currentStep = i; } }}
+							aria-label="Go to step {i + 1}: {step.title}"
+						>
+							{i + 1}
+						</button>
+						{#if i < STEPS.length - 1}
+							<span class="progress-line" class:progress-line-done={i < obState.currentStep}></span>
+						{/if}
+					{/each}
+				</div>
+
+				<button class="icon-button sig-switch" type="button" aria-label="Dismiss onboarding" onclick={dismiss}>
+					&times;
+				</button>
+			</header>
+
+			<div class="onboarding-body">
+				{#key obState.currentStep}
+					<div class="step-panel" in:fly={{ x: direction * 60, duration: 180 }}>
+						{#if obState.currentStep === 0}
+							<WelcomeStep state={obState} />
+						{:else if obState.currentStep === 1}
+							<IdentityStep state={obState} {harnesses} />
+						{:else if obState.currentStep === 2}
+							<EmbeddingStep state={obState} />
+						{:else if obState.currentStep === 3}
+							<ExtractionStep state={obState} />
+						{:else}
+							<ReviewStep state={obState} />
+						{/if}
+					</div>
+				{/key}
+			</div>
+
+			<footer class="onboarding-actions sig-panel-footer">
+				<div class="secondary-actions">
+					<Button variant="ghost" type="button" onclick={openSettings}>Settings</Button>
+					<Button variant="ghost" type="button" onclick={dismiss}>Skip for now</Button>
+				</div>
+				<div class="action-cluster">
+					{#if obState.currentStep > 0}
+						<Button variant="ghost" type="button" onclick={prevStep}>Back</Button>
+					{/if}
+					{#if obState.currentStep < STEPS.length - 1}
+						<Button type="button" onclick={nextStep}>
+							{obState.currentStep === 0 ? "Get started" : "Continue"}
+						</Button>
+					{:else}
+						<Button type="button" onclick={finish} disabled={obState.saving}>
+							{obState.saving ? "Saving..." : "Save and continue to sources"}
+						</Button>
+					{/if}
+				</div>
+			</footer>
+		</div>
+	</div>
+{/if}
+
+<style>
+	.onboarding-backdrop {
+		position: fixed;
+		inset: 0;
+		z-index: 90;
+		display: grid;
+		place-items: center;
+		padding: 24px;
+		background:
+			radial-gradient(circle at 52% 16%, color-mix(in srgb, var(--sig-highlight), transparent 84%), transparent 32%),
+			radial-gradient(ellipse at 80% 85%, color-mix(in srgb, var(--sig-surface-raised), transparent 60%), transparent 50%),
+			color-mix(in srgb, var(--sig-bg), transparent 10%);
+		backdrop-filter: blur(8px) saturate(0.9);
+	}
+
+	.onboarding-modal {
+		position: relative;
+		width: min(960px, 100%);
+		height: min(720px, calc(100vh - 48px));
+		display: flex;
+		flex-direction: column;
+		background: var(--sig-bg);
+		overflow: hidden;
+	}
+
+	.onboarding-modal::before,
+	.onboarding-modal::after {
+		content: "";
+		position: absolute;
+		z-index: 2;
+		pointer-events: none;
+		width: 24px;
+		height: 24px;
+		border-color: var(--sig-border-strong);
+		border-style: solid;
+		opacity: 0.45;
+	}
+
+	.onboarding-modal::before {
+		top: 10px;
+		left: 10px;
+		border-width: 1px 0 0 1px;
+	}
+
+	.onboarding-modal::after {
+		right: 10px;
+		bottom: 10px;
+		border-width: 0 1px 1px 0;
+	}
+
+	.onboarding-header {
+		position: relative;
+		display: flex;
+		align-items: flex-start;
+		justify-content: space-between;
+		gap: 24px;
+		padding: 18px 30px 15px;
+		border-bottom: 1px solid var(--sig-border-strong);
+		background:
+			linear-gradient(var(--sig-grid-line) 1px, transparent 1px),
+			linear-gradient(90deg, var(--sig-grid-line) 1px, transparent 1px),
+			linear-gradient(135deg, color-mix(in srgb, var(--sig-surface-raised), var(--sig-highlight) 5%), var(--sig-bg) 68%);
+		background-size: 28px 28px, 28px 28px, auto;
+		overflow: hidden;
+	}
+
+	.onboarding-header::after {
+		content: "SIGNET / MEMORY / IDENTITY";
+		position: absolute;
+		right: 72px;
+		bottom: -15px;
+		font-family: var(--font-display, monospace);
+		font-size: clamp(24px, 5vw, 58px);
+		letter-spacing: 0.1em;
+		color: var(--sig-text-bright);
+		opacity: 0.022;
+		white-space: nowrap;
+		pointer-events: none;
+	}
+
+	.header-copy {
+		position: relative;
+		z-index: 1;
+		max-width: 480px;
+	}
+
+	.header-kicker {
+		display: flex;
+		align-items: center;
+		gap: 10px;
+		margin-bottom: 10px;
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		color: var(--sig-highlight-text);
+	}
+
+	.signal-dot {
+		width: 7px;
+		height: 7px;
+		border: 1px solid var(--sig-success);
+		background: var(--sig-success);
+		box-shadow: 0 0 10px color-mix(in srgb, var(--sig-success), transparent 28%);
+	}
+
+	.header-step {
+		color: var(--sig-text-muted);
+	}
+
+	h2 {
+		margin: 0;
+		font-family: var(--font-display, monospace);
+		font-size: clamp(24px, 3.4vw, 38px);
+		line-height: 0.94;
+		letter-spacing: 0.06em;
+		color: var(--sig-text-bright);
+		text-transform: uppercase;
+	}
+
+	.lede {
+		margin: 7px 0 0;
+		font-size: 13px;
+		line-height: 1.35;
+		color: var(--sig-text);
+	}
+
+	.progress-track {
+		position: relative;
+		z-index: 1;
+		display: flex;
+		align-items: center;
+		gap: 0;
+		margin-top: 12px;
+	}
+
+	.progress-dot {
+		width: 28px;
+		height: 28px;
+		display: inline-grid;
+		place-items: center;
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.05em;
+		color: var(--sig-text-muted);
+		background: var(--sig-bg);
+		border: 1px solid var(--sig-border-strong);
+		cursor: pointer;
+		transition: border-color var(--dur) var(--ease), color var(--dur) var(--ease),
+			background var(--dur) var(--ease), box-shadow var(--dur) var(--ease);
+	}
+
+	.progress-dot:hover:not(:disabled) {
+		border-color: var(--sig-highlight);
+		color: var(--sig-text-bright);
+	}
+
+	.progress-dot:disabled {
+		cursor: default;
+	}
+
+	.progress-dot-active {
+		border-color: var(--sig-highlight);
+		background: var(--sig-highlight);
+		color: var(--sig-bg);
+		box-shadow: 0 0 12px color-mix(in srgb, var(--sig-highlight), transparent 32%);
+	}
+
+	.progress-dot-done {
+		border-color: var(--sig-highlight);
+		color: var(--sig-highlight-text);
+	}
+
+	.progress-line {
+		width: 28px;
+		height: 2px;
+		background: var(--sig-border-strong);
+	}
+
+	.progress-line-done {
+		background: var(--sig-highlight);
+	}
+
+	.icon-button {
+		position: relative;
+		z-index: 3;
+		width: 40px;
+		height: 40px;
+		color: var(--sig-text);
+		font-size: 24px;
+		line-height: 1;
+		cursor: pointer;
+	}
+
+	.onboarding-body {
+		flex: 1;
+		overflow-y: auto;
+		overflow-x: hidden;
+		padding: 24px 30px;
+		background:
+			radial-gradient(ellipse at 25% 10%, color-mix(in srgb, var(--sig-highlight), transparent 92%), transparent 40%),
+			var(--sig-bg);
+	}
+
+	.step-panel {
+		position: relative;
+	}
+
+	.onboarding-actions {
+		display: flex;
+		align-items: center;
+		justify-content: space-between;
+		gap: 12px;
+		padding: 12px 24px;
+	}
+
+	.action-cluster,
+	.secondary-actions {
+		display: flex;
+		gap: 10px;
+		align-items: center;
+	}
+
+	@media (max-width: 980px) {
+		.progress-track {
+			display: none;
+		}
+	}
+
+	@media (max-width: 620px) {
+		.onboarding-backdrop {
+			padding: 8px;
+		}
+
+		.onboarding-modal {
+			height: calc(100dvh - 16px);
+		}
+
+		.onboarding-header {
+			padding: 18px 16px 16px;
+			gap: 12px;
+		}
+
+		.onboarding-header::after {
+			display: none;
+		}
+
+		h2 {
+			font-size: 24px;
+			line-height: 1;
+			letter-spacing: 0.04em;
+		}
+
+		.lede {
+			font-size: 13px;
+		}
+
+		.icon-button {
+			width: 42px;
+			height: 42px;
+			flex: 0 0 auto;
+		}
+
+		.header-step,
+		.progress-track {
+			display: none;
+		}
+
+		.onboarding-body {
+			padding: 16px;
+		}
+
+		.onboarding-actions {
+			align-items: stretch;
+			flex-direction: column;
+			padding: 12px;
+		}
+
+		.action-cluster,
+		.secondary-actions {
+			justify-content: space-between;
+		}
+	}
+</style>
diff --git a/surfaces/dashboard/src/lib/components/onboarding/OnboardingStepShell.svelte b/surfaces/dashboard/src/lib/components/onboarding/OnboardingStepShell.svelte
new file mode 100644
index 000000000..043333a88
--- /dev/null
+++ b/surfaces/dashboard/src/lib/components/onboarding/OnboardingStepShell.svelte
@@ -0,0 +1,75 @@
+<script lang="ts">
+	interface Props {
+		readonly stepNumber: string;
+		readonly title: string;
+		readonly subtitle: string;
+		readonly children: import("svelte").Snippet;
+	}
+
+	const { stepNumber, title, subtitle, children }: Props = $props();
+</script>
+
+<div class="step-shell">
+	<div class="step-shell-head">
+		<span class="step-shell-number">{stepNumber}</span>
+		<div>
+			<h3 class="step-shell-title">{title}</h3>
+			<p class="step-shell-subtitle">{subtitle}</p>
+		</div>
+	</div>
+	<div class="step-shell-body">
+		{@render children()}
+	</div>
+</div>
+
+<style>
+	.step-shell {
+		display: flex;
+		flex-direction: column;
+		gap: 14px;
+	}
+
+	.step-shell-head {
+		display: flex;
+		gap: 12px;
+		align-items: flex-start;
+	}
+
+	.step-shell-number {
+		display: inline-grid;
+		place-items: center;
+		width: 32px;
+		height: 32px;
+		border: 1px solid var(--sig-border-strong);
+		background: var(--sig-bg);
+		color: var(--sig-text-bright);
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.05);
+		flex: 0 0 auto;
+	}
+
+	.step-shell-title {
+		margin: 0;
+		font-family: var(--font-display, monospace);
+		font-size: 14px;
+		letter-spacing: 0.09em;
+		color: var(--sig-text-bright);
+		text-transform: uppercase;
+	}
+
+	.step-shell-subtitle {
+		margin: 4px 0 0;
+		font-size: 12px;
+		line-height: 1.35;
+		color: var(--sig-text-muted);
+	}
+
+	.step-shell-body {
+		display: flex;
+		flex-direction: column;
+		gap: 12px;
+	}
+</style>
diff --git a/surfaces/dashboard/src/lib/components/onboarding/onboarding-state.svelte.ts b/surfaces/dashboard/src/lib/components/onboarding/onboarding-state.svelte.ts
new file mode 100644
index 000000000..2d995f7f0
--- /dev/null
+++ b/surfaces/dashboard/src/lib/components/onboarding/onboarding-state.svelte.ts
@@ -0,0 +1,229 @@
+import type { PipelineProviderChoice } from "@signet/core/pipeline-providers";
+
+export type IdentityPresetName = "minimal" | "hermes" | "openclaw" | "custom";
+
+export const IDENTITY_PRESET_META: Array<{
+	name: IdentityPresetName;
+	title: string;
+	subtitle: string;
+	files: string;
+}> = [
+	{
+		name: "minimal",
+		title: "Minimal",
+		subtitle: "AGENTS.md operating instructions plus dreaming. Light and focused.",
+		files: "AGENTS.md + DREAMING.md",
+	},
+	{
+		name: "hermes",
+		title: "Hermes",
+		subtitle: "SOUL.md primary identity with project-context discovery.",
+		files: "SOUL.md + AGENTS.md + DREAMING.md",
+	},
+	{
+		name: "openclaw",
+		title: "OpenClaw",
+		subtitle: "Rich identity stack for character-forward agents.",
+		files: "AGENTS.md + SOUL.md + IDENTITY.md + USER.md + MEMORY.md",
+	},
+	{
+		name: "custom",
+		title: "Custom",
+		subtitle: "Select your own startup files later in settings.",
+		files: "AGENTS.md + DREAMING.md",
+	},
+];
+
+export interface OnboardingState {
+	identityPreset: IdentityPresetName;
+	agentName: string;
+	agentDescription: string;
+	selectedHarnesses: string[];
+	selectedHarness: string;
+	embeddingProvider: EmbeddingProvider;
+	embeddingModel: string;
+	embeddingEndpoint: string;
+	extractionProvider: PipelineProviderChoice;
+	extractionModel: string;
+	extractionEndpoint: string;
+	synthesisEnabled: boolean;
+	showAdvancedProviders: boolean;
+	currentStep: number;
+	saving: boolean;
+}
+
+export type EmbeddingProvider = "native" | "llama-cpp" | "ollama" | "openai" | "none";
+
+export const EMBEDDING_PROVIDER_OPTIONS: Array<{
+	readonly value: EmbeddingProvider;
+	readonly label: string;
+	readonly detail: string;
+	readonly defaultModel: string;
+	readonly defaultEndpoint: string;
+}> = [
+	{
+		value: "native",
+		label: "Native (built-in)",
+		detail: "On-device embedding with no external server. Recommended.",
+		defaultModel: "nomic-embed-text-v1.5",
+		defaultEndpoint: "",
+	},
+	{
+		value: "llama-cpp",
+		label: "llama.cpp",
+		detail: "OpenAI-compatible server bundled with llama.cpp.",
+		defaultModel: "nomic-embed-text",
+		defaultEndpoint: "http://localhost:8080/v1",
+	},
+	{
+		value: "ollama",
+		label: "Ollama",
+		detail: "Ollama daemon on this machine or LAN.",
+		defaultModel: "nomic-embed-text",
+		defaultEndpoint: "http://localhost:11434",
+	},
+	{
+		value: "openai",
+		label: "OpenAI",
+		detail: "OpenAI text-embedding API. Requires API key in secrets.",
+		defaultModel: "text-embedding-3-small",
+		defaultEndpoint: "https://api.openai.com/v1",
+	},
+	{
+		value: "none",
+		label: "Off",
+		detail: "Disable vector search. Memory will be keyword-only.",
+		defaultModel: "",
+		defaultEndpoint: "",
+	},
+];
+
+export const EMBEDDING_MODEL_PRESETS: Record<string, Array<{ value: string; label: string }>> = {
+	native: [{ value: "nomic-embed-text-v1.5", label: "nomic-embed-text-v1.5" }],
+	"llama-cpp": [
+		{ value: "nomic-embed-text", label: "nomic-embed-text" },
+		{ value: "all-minilm", label: "all-minilm" },
+		{ value: "mxbai-embed-large", label: "mxbai-embed-large" },
+	],
+	ollama: [
+		{ value: "nomic-embed-text", label: "nomic-embed-text" },
+		{ value: "all-minilm", label: "all-minilm" },
+		{ value: "mxbai-embed-large", label: "mxbai-embed-large" },
+	],
+	openai: [
+		{ value: "text-embedding-3-small", label: "text-embedding-3-small" },
+		{ value: "text-embedding-3-large", label: "text-embedding-3-large" },
+	],
+	none: [],
+};
+
+export type ExtractionProviderOption = {
+	value: PipelineProviderChoice;
+	label: string;
+	detail: string;
+	mode: "agent" | "local" | "api" | "off" | "custom";
+	endpointPlaceholder?: string;
+};
+
+export const EXTRACTION_PROVIDER_OPTIONS: ExtractionProviderOption[] = [
+	{
+		value: "acpx",
+		label: "ACPX",
+		detail: "Route extraction through a selected installed agent harness.",
+		mode: "agent",
+	},
+	{
+		value: "llama-cpp",
+		label: "llama.cpp",
+		detail: "Use a local llama.cpp OpenAI-compatible server.",
+		mode: "local",
+		endpointPlaceholder: "http://127.0.0.1:8080/v1",
+	},
+	{
+		value: "ollama",
+		label: "Ollama",
+		detail: "Use an Ollama daemon running on this machine or LAN.",
+		mode: "local",
+		endpointPlaceholder: "http://127.0.0.1:11434",
+	},
+	{
+		value: "claude-code",
+		label: "Claude Code",
+		detail: "Call the local Claude Code CLI directly for extraction.",
+		mode: "agent",
+	},
+	{
+		value: "codex",
+		label: "Codex",
+		detail: "Call the local Codex CLI directly for extraction.",
+		mode: "agent",
+	},
+	{
+		value: "opencode",
+		label: "OpenCode",
+		detail: "Use OpenCode as the extraction backend.",
+		mode: "agent",
+	},
+	{
+		value: "anthropic",
+		label: "Anthropic API",
+		detail: "Use Anthropic directly with configured secrets.",
+		mode: "api",
+		endpointPlaceholder: "https://api.anthropic.com",
+	},
+	{
+		value: "openrouter",
+		label: "OpenRouter",
+		detail: "Use OpenRouter with configured secrets.",
+		mode: "api",
+		endpointPlaceholder: "https://openrouter.ai/api/v1",
+	},
+	{
+		value: "command",
+		label: "Command",
+		detail: "Use a custom command provider configured in advanced settings.",
+		mode: "custom",
+	},
+	{
+		value: "none",
+		label: "Off",
+		detail: "Leave extraction disabled for now.",
+		mode: "off",
+	},
+];
+
+export const EXTRACTION_MODEL_PRESETS: Partial<Record<PipelineProviderChoice, string[]>> = {
+	acpx: ["gpt-5-codex-mini", "gpt-5-codex", "claude-haiku-4-5"],
+	"llama-cpp": ["qwen3.5:4b", "qwen3:8b", "llama-3.1-8b"],
+	ollama: ["qwen3:4b", "qwen3:8b", "glm-4.7-flash"],
+	"claude-code": ["haiku", "sonnet", "opus"],
+	codex: ["gpt-5-codex-mini", "gpt-5-codex", "gpt-5.4"],
+	opencode: ["anthropic/claude-haiku-4-5-20251001", "google/gemini-2.5-flash"],
+	anthropic: ["haiku", "sonnet", "opus"],
+	openrouter: ["openai/gpt-4o-mini", "anthropic/claude-haiku-4-5-20251001"],
+};
+
+export const EXTRACTION_SAFETY_TEXT =
+	"Remote API extraction can stack up extreme fees fast. Intended usage: Claude Code on haiku, Codex CLI on gpt-5-codex-mini with a pro/max subscription, or local providers (llama.cpp or Ollama) at qwen3:4b or larger.";
+
+export const RECOMMENDED_EXTRACTION: PipelineProviderChoice[] = ["acpx", "ollama", "codex", "claude-code"];
+
+export function createDefaultState(): OnboardingState {
+	return {
+		identityPreset: "minimal",
+		agentName: "My Agent",
+		agentDescription: "Personal AI assistant",
+		selectedHarnesses: [],
+		selectedHarness: "",
+		embeddingProvider: "native",
+		embeddingModel: "nomic-embed-text-v1.5",
+		embeddingEndpoint: "",
+		extractionProvider: "acpx",
+		extractionModel: "gpt-5-codex-mini",
+		extractionEndpoint: "",
+		synthesisEnabled: true,
+		showAdvancedProviders: false,
+		currentStep: 0,
+		saving: false,
+	};
+}
diff --git a/surfaces/dashboard/src/lib/components/onboarding/steps/EmbeddingStep.svelte b/surfaces/dashboard/src/lib/components/onboarding/steps/EmbeddingStep.svelte
new file mode 100644
index 000000000..282940517
--- /dev/null
+++ b/surfaces/dashboard/src/lib/components/onboarding/steps/EmbeddingStep.svelte
@@ -0,0 +1,237 @@
+<script lang="ts">
+	import { Input } from "$lib/components/ui/input/index.js";
+	import * as Select from "$lib/components/ui/select/index.js";
+	import {
+		EMBEDDING_MODEL_PRESETS,
+		EMBEDDING_PROVIDER_OPTIONS,
+		type EmbeddingProvider,
+		type OnboardingState,
+	} from "../onboarding-state.svelte";
+
+	interface Props {
+		state: OnboardingState;
+	}
+
+	const { state }: Props = $props();
+
+	const selectTriggerClass =
+		"font-mono text-[11px] text-[var(--sig-text)] bg-[var(--sig-bg)] border-[var(--sig-border-strong)] rounded-lg w-full h-auto min-h-[30px] px-2 py-[5px] box-border focus-visible:border-[var(--sig-accent)]";
+	const selectContentClass =
+		"font-mono text-[11px] bg-[var(--sig-bg)] text-[var(--sig-text)] border-[var(--sig-border-strong)] rounded-lg";
+	const selectItemClass = "font-mono text-[11px] rounded-lg";
+
+	const providerOption = $derived(
+		EMBEDDING_PROVIDER_OPTIONS.find((o) => o.value === state.embeddingProvider),
+	);
+	const modelPresets = $derived(EMBEDDING_MODEL_PRESETS[state.embeddingProvider] ?? []);
+	const needsEndpoint = $derived(
+		state.embeddingProvider === "llama-cpp" ||
+			state.embeddingProvider === "ollama" ||
+			state.embeddingProvider === "openai",
+	);
+
+	function chooseProvider(next: EmbeddingProvider): void {
+		const option = EMBEDDING_PROVIDER_OPTIONS.find((o) => o.value === next);
+		if (!option) return;
+		state.embeddingProvider = next;
+		state.embeddingModel = option.defaultModel;
+		state.embeddingEndpoint = option.defaultEndpoint;
+	}
+
+	export function validate(): string[] {
+		if (state.embeddingProvider === "none") return [];
+		if (!state.embeddingModel.trim()) return ["Embedding model is required."];
+		return [];
+	}
+</script>
+
+<div class="embedding-step">
+	<p class="step-hint">
+		Embedding turns text into vectors for semantic search. The built-in native provider works out of
+		the box with no setup.
+	</p>
+
+	<div class="provider-grid">
+		{#each EMBEDDING_PROVIDER_OPTIONS as option (option.value)}
+			<button
+				type="button"
+				class="provider-card sig-switch"
+				class:provider-card-active={state.embeddingProvider === option.value}
+				onclick={() => chooseProvider(option.value)}
+				aria-pressed={state.embeddingProvider === option.value}
+			>
+				<span class="provider-radio" aria-hidden="true"></span>
+				<strong>{option.label}</strong>
+				{#if state.embeddingProvider === option.value}
+					<span class="selected-badge">selected</span>
+				{/if}
+			</button>
+		{/each}
+	</div>
+
+	{#if state.embeddingProvider !== "none"}
+		<div class="config-fields">
+			<div class="field-row">
+				<label class="field">
+					<span class="field-label">Model</span>
+					<Select.Root
+						type="single"
+						value={modelPresets.some((p) => p.value === state.embeddingModel)
+							? state.embeddingModel
+							: "__custom__"}
+						onValueChange={(v: string) => {
+							if (v !== "__custom__") state.embeddingModel = v;
+						}}
+					>
+						<Select.Trigger class={selectTriggerClass}>
+							{state.embeddingModel || "select model"}
+						</Select.Trigger>
+						<Select.Content class={selectContentClass}>
+							{#each modelPresets as preset (preset.value)}
+								<Select.Item class={selectItemClass} value={preset.value}>
+									{preset.label}
+								</Select.Item>
+							{/each}
+							<Select.Item class={selectItemClass} value="__custom__">Custom...</Select.Item>
+						</Select.Content>
+					</Select.Root>
+				</label>
+
+				{#if needsEndpoint}
+					<label class="field">
+						<span class="field-label">Base URL</span>
+						<Input
+							class="onboarding-input"
+							bind:value={state.embeddingEndpoint}
+							placeholder={providerOption?.defaultEndpoint ?? "https://..."}
+						/>
+					</label>
+				{/if}
+			</div>
+		</div>
+	{/if}
+</div>
+
+<style>
+	.embedding-step {
+		display: flex;
+		flex-direction: column;
+		gap: 12px;
+	}
+
+	.step-hint {
+		margin: 0;
+		font-size: 13px;
+		line-height: 1.4;
+		color: var(--sig-text);
+	}
+
+	.provider-grid {
+		display: grid;
+		grid-template-columns: repeat(2, minmax(0, 1fr));
+		gap: 8px;
+	}
+
+	.provider-card {
+		position: relative;
+		min-height: 40px;
+		padding: 8px 10px 8px 30px;
+		text-align: left;
+		cursor: pointer;
+		border: 1px solid var(--sig-border-strong);
+		border-radius: var(--sig-radius);
+		background: color-mix(in srgb, var(--sig-surface), transparent 5%);
+		color: var(--sig-text);
+		transition: border-color var(--dur) var(--ease), background var(--dur) var(--ease);
+	}
+
+	.provider-card:hover {
+		border-color: var(--sig-highlight);
+	}
+
+	.provider-card-active {
+		border-color: var(--sig-highlight);
+		background: color-mix(in srgb, var(--sig-surface-raised), var(--sig-highlight) 10%);
+		box-shadow: var(--sig-glow-highlight), inset 3px 0 0 var(--sig-highlight),
+			inset 0 1px 0 rgba(255, 255, 255, 0.08);
+	}
+
+	.provider-radio {
+		position: absolute;
+		top: 13px;
+		left: 10px;
+		width: 12px;
+		height: 12px;
+		border: 1px solid var(--sig-border-strong);
+		background: var(--sig-bg);
+	}
+
+	.provider-card-active .provider-radio {
+		border-color: var(--sig-highlight);
+		background: var(--sig-highlight);
+		box-shadow: inset 0 0 0 3px var(--sig-bg),
+			0 0 9px color-mix(in srgb, var(--sig-highlight), transparent 36%);
+	}
+
+	.provider-card strong {
+		display: block;
+		font-family: var(--font-display, monospace);
+		font-size: 13px;
+		letter-spacing: 0.08em;
+		text-transform: uppercase;
+		color: var(--sig-text-bright);
+	}
+
+	.selected-badge {
+		position: absolute;
+		top: 9px;
+		right: 10px;
+		font-family: var(--font-mono, monospace);
+		font-size: 9px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		color: var(--sig-highlight-text);
+	}
+
+	.config-fields {
+		display: flex;
+		flex-direction: column;
+		gap: 10px;
+	}
+
+	.field-row {
+		display: grid;
+		grid-template-columns: repeat(2, minmax(0, 1fr));
+		gap: 10px;
+	}
+
+	.field {
+		display: flex;
+		flex-direction: column;
+		gap: 7px;
+	}
+
+	.field-label {
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		color: var(--sig-text-muted);
+	}
+
+	:global(.onboarding-input) {
+		border-radius: var(--sig-radius) !important;
+		border-color: var(--sig-border-strong) !important;
+		background: color-mix(in srgb, var(--sig-bg), transparent 6%) !important;
+		color: var(--sig-text-bright) !important;
+		font-family: var(--font-mono, monospace) !important;
+		box-shadow: inset 0 1px 3px rgba(0, 0, 0, 0.28) !important;
+	}
+
+	@media (max-width: 620px) {
+		.provider-grid,
+		.field-row {
+			grid-template-columns: 1fr;
+		}
+	}
+</style>
diff --git a/surfaces/dashboard/src/lib/components/onboarding/steps/ExtractionStep.svelte b/surfaces/dashboard/src/lib/components/onboarding/steps/ExtractionStep.svelte
new file mode 100644
index 000000000..4454447e2
--- /dev/null
+++ b/surfaces/dashboard/src/lib/components/onboarding/steps/ExtractionStep.svelte
@@ -0,0 +1,420 @@
+<script lang="ts">
+	import { Checkbox } from "$lib/components/ui/checkbox/index.js";
+	import { Input } from "$lib/components/ui/input/index.js";
+	import { defaultPipelineModel, type PipelineProviderChoice } from "@signet/core/pipeline-providers";
+	import {
+		EXTRACTION_MODEL_PRESETS,
+		EXTRACTION_PROVIDER_OPTIONS,
+		EXTRACTION_SAFETY_TEXT,
+		RECOMMENDED_EXTRACTION,
+		type OnboardingState,
+	} from "../onboarding-state.svelte";
+
+	interface Props {
+		state: OnboardingState;
+	}
+
+	const { state }: Props = $props();
+
+	const providerOption = $derived(
+		EXTRACTION_PROVIDER_OPTIONS.find((o) => o.value === state.extractionProvider) ??
+			EXTRACTION_PROVIDER_OPTIONS[0],
+	);
+	const modelPresets = $derived(EXTRACTION_MODEL_PRESETS[state.extractionProvider] ?? []);
+	const needsEndpoint = $derived(
+		providerOption.mode === "local" || providerOption.mode === "api",
+	);
+
+	function chooseProvider(next: PipelineProviderChoice): void {
+		state.extractionProvider = next;
+		state.extractionModel = EXTRACTION_MODEL_PRESETS[next]?.[0] ?? defaultPipelineModel(next);
+		state.extractionEndpoint =
+			EXTRACTION_PROVIDER_OPTIONS.find((o) => o.value === next)?.endpointPlaceholder ?? "";
+		if (next === "none") state.extractionEndpoint = "";
+	}
+
+	function isRecommended(provider: PipelineProviderChoice): boolean {
+		return RECOMMENDED_EXTRACTION.includes(provider);
+	}
+
+	export function validate(): string[] {
+		if (state.extractionProvider === "none") return [];
+		if (!state.extractionModel.trim()) return ["Extraction model is required."];
+		if (
+			needsEndpoint &&
+			state.extractionEndpoint.trim() &&
+			!/^https?:\/\//.test(state.extractionEndpoint.trim())
+		) {
+			return ["Endpoint must be an http:// or https:// URL."];
+		}
+		return [];
+	}
+</script>
+
+<div class="extraction-step">
+	<p class="step-hint">{EXTRACTION_SAFETY_TEXT}</p>
+
+	<div class="provider-grid">
+		<p class="provider-group-title">Recommended routes</p>
+		{#each EXTRACTION_PROVIDER_OPTIONS as option (option.value)}
+			{#if isRecommended(option.value)}
+				<button
+					type="button"
+					class="provider-card sig-switch"
+					class:provider-card-active={state.extractionProvider === option.value}
+					onclick={() => chooseProvider(option.value)}
+					aria-pressed={state.extractionProvider === option.value}
+				>
+					<span class="provider-radio" aria-hidden="true"></span>
+					<span class="provider-mode">{option.mode}</span>
+					{#if state.extractionProvider === option.value}
+						<span class="selected-badge">selected</span>
+					{/if}
+					<strong>{option.label}</strong>
+				</button>
+			{/if}
+		{/each}
+
+		<button
+			type="button"
+			class="advanced-toggle sig-switch"
+			onclick={() => (state.showAdvancedProviders = !state.showAdvancedProviders)}
+			aria-expanded={state.showAdvancedProviders}
+		>
+			<span>{state.showAdvancedProviders ? "Hide advanced routes" : "Show advanced routes"}</span>
+		</button>
+
+		{#if state.showAdvancedProviders}
+			<p class="provider-group-title provider-group-title-secondary">Advanced routes</p>
+			{#each EXTRACTION_PROVIDER_OPTIONS as option (option.value)}
+				{#if !isRecommended(option.value)}
+					<button
+						type="button"
+						class="provider-card provider-card-compact sig-switch"
+						class:provider-card-active={state.extractionProvider === option.value}
+						onclick={() => chooseProvider(option.value)}
+						aria-pressed={state.extractionProvider === option.value}
+					>
+						<span class="provider-radio" aria-hidden="true"></span>
+						<span class="provider-mode">{option.mode}</span>
+						{#if state.extractionProvider === option.value}
+							<span class="selected-badge">selected</span>
+						{/if}
+						<strong>{option.label}</strong>
+					</button>
+				{/if}
+			{/each}
+		{/if}
+	</div>
+
+	<div class="provider-detail">
+		<div class="detail-banner">
+			<span>{providerOption.mode}</span>
+			<p>{providerOption.detail}</p>
+		</div>
+
+		{#if state.extractionProvider === "acpx"}
+			<div class="field">
+				<span class="field-label">ACPX harness</span>
+				<div class="choice-row">
+					{#each state.selectedHarnesses as h (h)}
+						<button
+							type="button"
+							class="choice-pill sig-switch"
+							class:choice-pill-active={state.selectedHarness === h}
+							onclick={() => (state.selectedHarness = h)}
+						>
+							{h}
+						</button>
+					{/each}
+					{#if state.selectedHarnesses.length === 0}
+						<small class="empty-hint">Select at least one harness in the previous step.</small>
+					{/if}
+				</div>
+			</div>
+		{/if}
+
+		<div class="field-row">
+			<label class="field">
+				<span class="field-label">Model</span>
+				<Input
+					class="onboarding-input"
+					bind:value={state.extractionModel}
+					placeholder="model id"
+					disabled={state.extractionProvider === "none"}
+				/>
+			</label>
+			{#if needsEndpoint}
+				<label class="field">
+					<span class="field-label">Endpoint URL</span>
+					<Input
+						class="onboarding-input"
+						bind:value={state.extractionEndpoint}
+						placeholder={providerOption.endpointPlaceholder ?? "https://..."}
+					/>
+				</label>
+			{/if}
+		</div>
+
+		{#if modelPresets.length > 0 && state.extractionProvider !== "none"}
+			<div class="choice-row preset-row" aria-label="Model presets">
+				{#each modelPresets as preset (preset)}
+					<button
+						type="button"
+						class="choice-pill sig-switch"
+						class:choice-pill-active={state.extractionModel === preset}
+						onclick={() => (state.extractionModel = preset)}
+					>
+						{preset}
+					</button>
+				{/each}
+			</div>
+		{/if}
+
+		<label class="inline-toggle sig-switch">
+			<Checkbox
+				checked={state.synthesisEnabled}
+				onCheckedChange={(checked) => (state.synthesisEnabled = !!checked)}
+			/>
+			<span>Use the same provider for session synthesis</span>
+		</label>
+	</div>
+</div>
+
+<style>
+	.extraction-step {
+		display: flex;
+		flex-direction: column;
+		gap: 12px;
+	}
+
+	.step-hint {
+		margin: 0;
+		padding: 8px 10px;
+		border: 1px solid var(--sig-border-strong);
+		border-radius: var(--sig-radius);
+		background: var(--sig-bg);
+		font-size: 12px;
+		line-height: 1.35;
+		color: var(--sig-text-muted);
+	}
+
+	.provider-grid {
+		display: grid;
+		grid-template-columns: repeat(2, minmax(0, 1fr));
+		gap: 8px;
+	}
+
+	.provider-group-title {
+		grid-column: 1 / -1;
+		margin: 2px 0 -2px;
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.11em;
+		text-transform: uppercase;
+		color: var(--sig-highlight-text);
+	}
+
+	.provider-group-title-secondary {
+		margin-top: 8px;
+		color: var(--sig-text-muted);
+	}
+
+	.provider-card {
+		position: relative;
+		min-height: 40px;
+		padding: 8px 10px 8px 30px;
+		text-align: left;
+		cursor: pointer;
+		border: 1px solid var(--sig-border-strong);
+		border-radius: var(--sig-radius);
+		background: color-mix(in srgb, var(--sig-surface), transparent 5%);
+		color: var(--sig-text);
+		transition: border-color var(--dur) var(--ease), background var(--dur) var(--ease);
+	}
+
+	.provider-card:hover {
+		border-color: var(--sig-highlight);
+	}
+
+	.provider-card-active {
+		border-color: var(--sig-highlight);
+		background: color-mix(in srgb, var(--sig-surface-raised), var(--sig-highlight) 10%);
+		box-shadow: var(--sig-glow-highlight), inset 3px 0 0 var(--sig-highlight),
+			inset 0 1px 0 rgba(255, 255, 255, 0.08);
+	}
+
+	.provider-card-compact {
+		min-height: 32px;
+	}
+
+	.provider-radio {
+		position: absolute;
+		top: 13px;
+		left: 10px;
+		width: 12px;
+		height: 12px;
+		border: 1px solid var(--sig-border-strong);
+		background: var(--sig-bg);
+	}
+
+	.provider-card-active .provider-radio {
+		border-color: var(--sig-highlight);
+		background: var(--sig-highlight);
+		box-shadow: inset 0 0 0 3px var(--sig-bg),
+			0 0 9px color-mix(in srgb, var(--sig-highlight), transparent 36%);
+	}
+
+	.provider-mode {
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		color: var(--sig-highlight-text);
+	}
+
+	.provider-card strong {
+		display: block;
+		margin: 4px 0 0;
+		font-family: var(--font-display, monospace);
+		font-size: 13px;
+		letter-spacing: 0.08em;
+		text-transform: uppercase;
+		color: var(--sig-text-bright);
+	}
+
+	.selected-badge {
+		position: absolute;
+		top: 9px;
+		right: 10px;
+		font-family: var(--font-mono, monospace);
+		font-size: 9px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		color: var(--sig-highlight-text);
+	}
+
+	.advanced-toggle {
+		grid-column: 1 / -1;
+		justify-content: center;
+		min-height: 28px;
+		padding: 6px 10px;
+		font-family: var(--font-mono, monospace);
+		font-size: 11px;
+		letter-spacing: 0.08em;
+		text-transform: uppercase;
+		color: var(--sig-text);
+		cursor: pointer;
+		border: 1px solid var(--sig-border-strong);
+		border-radius: var(--sig-radius);
+		background: color-mix(in srgb, var(--sig-surface), transparent 5%);
+	}
+
+	.provider-detail {
+		display: flex;
+		flex-direction: column;
+		gap: 10px;
+	}
+
+	.detail-banner {
+		display: flex;
+		gap: 12px;
+		align-items: center;
+		padding: 8px 10px;
+		border: 1px solid var(--sig-border-strong);
+		border-radius: var(--sig-radius);
+		background: var(--sig-bg);
+	}
+
+	.detail-banner span {
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		text-transform: uppercase;
+		color: var(--sig-highlight-text);
+	}
+
+	.detail-banner p {
+		margin: 0;
+		font-size: 12px;
+		line-height: 1.35;
+		color: var(--sig-text-muted);
+	}
+
+	.field-row {
+		display: grid;
+		grid-template-columns: repeat(2, minmax(0, 1fr));
+		gap: 10px;
+	}
+
+	.field {
+		display: flex;
+		flex-direction: column;
+		gap: 7px;
+	}
+
+	.field-label {
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		color: var(--sig-text-muted);
+	}
+
+	.choice-row {
+		display: flex;
+		flex-wrap: wrap;
+		gap: 8px;
+	}
+
+	.preset-row {
+		padding-top: 2px;
+	}
+
+	.choice-pill {
+		padding: 7px 10px;
+		font-family: var(--font-mono, monospace);
+		font-size: 12px;
+		color: var(--sig-text);
+		cursor: pointer;
+		border: 1px solid var(--sig-border-strong);
+		border-radius: var(--sig-radius);
+		background: color-mix(in srgb, var(--sig-surface), transparent 5%);
+	}
+
+	.choice-pill-active {
+		border-color: var(--sig-highlight);
+		color: var(--sig-text-bright);
+		background: var(--sig-highlight-muted);
+	}
+
+	.empty-hint {
+		font-size: 12px;
+		color: var(--sig-text-muted);
+	}
+
+	.inline-toggle {
+		display: flex;
+		align-items: center;
+		gap: 9px;
+		padding: 10px;
+		font-size: 12px;
+		color: var(--sig-text);
+		cursor: pointer;
+	}
+
+	:global(.onboarding-input) {
+		border-radius: var(--sig-radius) !important;
+		border-color: var(--sig-border-strong) !important;
+		background: color-mix(in srgb, var(--sig-bg), transparent 6%) !important;
+		color: var(--sig-text-bright) !important;
+		font-family: var(--font-mono, monospace) !important;
+		box-shadow: inset 0 1px 3px rgba(0, 0, 0, 0.28) !important;
+	}
+
+	@media (max-width: 620px) {
+		.provider-grid,
+		.field-row {
+			grid-template-columns: 1fr;
+		}
+	}
+</style>
diff --git a/surfaces/dashboard/src/lib/components/onboarding/steps/IdentityStep.svelte b/surfaces/dashboard/src/lib/components/onboarding/steps/IdentityStep.svelte
new file mode 100644
index 000000000..c87e3737b
--- /dev/null
+++ b/surfaces/dashboard/src/lib/components/onboarding/steps/IdentityStep.svelte
@@ -0,0 +1,212 @@
+<script lang="ts">
+	import type { Harness } from "$lib/api";
+	import { Checkbox } from "$lib/components/ui/checkbox/index.js";
+	import { Input } from "$lib/components/ui/input/index.js";
+	import { Textarea } from "$lib/components/ui/textarea/index.js";
+	import { KNOWN_HARNESSES } from "$lib/stores/settings.svelte";
+	import type { OnboardingState } from "../onboarding-state.svelte";
+
+	interface Props {
+		state: OnboardingState;
+		harnesses?: Harness[];
+	}
+
+	const { state, harnesses = [] }: Props = $props();
+
+	const harnessOptions = $derived.by(() => {
+		const fromApi = harnesses.map((h) => h.id || h.name).filter(Boolean);
+		const combined = [...new Set([...fromApi, ...KNOWN_HARNESSES])];
+		return combined.map((id) => ({
+			id,
+			meta: harnesses.find((h) => h.id === id || h.name === id),
+		}));
+	});
+
+	function toggleHarness(id: string, checked: boolean | string): void {
+		if (checked) {
+			state.selectedHarnesses = [...new Set([...state.selectedHarnesses, id])];
+			if (!state.selectedHarness) state.selectedHarness = id;
+			return;
+		}
+		state.selectedHarnesses = state.selectedHarnesses.filter((h) => h !== id);
+		if (state.selectedHarness === id) state.selectedHarness = state.selectedHarnesses[0] ?? "";
+	}
+
+	export function validate(): string[] {
+		const errors: string[] = [];
+		if (!state.agentName.trim()) errors.push("Agent name is required.");
+		if (state.selectedHarnesses.length === 0) errors.push("Select at least one harness.");
+		return errors;
+	}
+</script>
+
+<div class="identity-fields">
+	<div class="field-grid">
+		<label class="field">
+			<span class="field-label">Name</span>
+			<Input class="onboarding-input" bind:value={state.agentName} placeholder="Dot" />
+		</label>
+		<label class="field field-wide">
+			<span class="field-label">Description</span>
+			<Textarea
+				class="onboarding-input onboarding-textarea"
+				rows={2}
+				bind:value={state.agentDescription}
+				placeholder="A portable memory agent for..."
+			/>
+		</label>
+	</div>
+
+	<div class="harness-section">
+		<span class="field-label">Harnesses</span>
+		<div class="harness-list">
+			{#each harnessOptions as h (h.id)}
+				<label
+					class="harness-row sig-switch"
+					class:harness-row-active={state.selectedHarnesses.includes(h.id)}
+				>
+					<Checkbox
+						checked={state.selectedHarnesses.includes(h.id)}
+						onCheckedChange={(checked) => toggleHarness(h.id, checked)}
+					/>
+					<span class="status-dot" class:status-dot-installed={h.meta?.exists}></span>
+					<span class="harness-main">
+						<strong>{h.id}</strong>
+						<small>{h.meta?.path ?? "known harness"}</small>
+					</span>
+					<span class="harness-state">{h.meta?.exists ? "installed" : "not found"}</span>
+				</label>
+			{/each}
+		</div>
+	</div>
+</div>
+
+<style>
+	.identity-fields {
+		display: flex;
+		flex-direction: column;
+		gap: 16px;
+	}
+
+	.field-grid {
+		display: grid;
+		grid-template-columns: repeat(2, minmax(0, 1fr));
+		gap: 10px;
+	}
+
+	.field {
+		display: flex;
+		flex-direction: column;
+		gap: 7px;
+	}
+
+	.field-wide {
+		grid-column: 1 / -1;
+	}
+
+	.field-label {
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		color: var(--sig-text-muted);
+	}
+
+	:global(.onboarding-input) {
+		border-radius: var(--sig-radius) !important;
+		border-color: var(--sig-border-strong) !important;
+		background: color-mix(in srgb, var(--sig-bg), transparent 6%) !important;
+		color: var(--sig-text-bright) !important;
+		font-family: var(--font-mono, monospace) !important;
+		box-shadow: inset 0 1px 3px rgba(0, 0, 0, 0.28) !important;
+	}
+
+	:global(.onboarding-textarea) {
+		min-height: 48px !important;
+		resize: vertical;
+	}
+
+	.harness-section {
+		display: flex;
+		flex-direction: column;
+		gap: 8px;
+	}
+
+	.harness-list {
+		display: flex;
+		flex-direction: column;
+		gap: 4px;
+		max-height: 240px;
+		overflow: auto;
+		padding-right: 2px;
+	}
+
+	.harness-row {
+		display: flex;
+		align-items: center;
+		gap: 10px;
+		padding: 8px 10px;
+		cursor: pointer;
+		border: 1px solid transparent;
+		border-radius: var(--sig-radius);
+		transition: background var(--dur) var(--ease), border-color var(--dur) var(--ease);
+	}
+
+	.harness-row-active {
+		border-color: var(--sig-highlight-dim);
+		background: var(--sig-highlight-muted);
+		box-shadow: inset 3px 0 0 var(--sig-highlight),
+			inset 0 1px 0 rgba(255, 255, 255, 0.05);
+	}
+
+	.status-dot {
+		width: 8px;
+		height: 8px;
+		border: 1px solid var(--sig-text-muted);
+		background: transparent;
+		flex: 0 0 auto;
+	}
+
+	.status-dot-installed {
+		border-color: var(--sig-success);
+		background: var(--sig-success);
+		box-shadow: 0 0 8px color-mix(in srgb, var(--sig-success), transparent 40%);
+	}
+
+	.harness-main {
+		display: flex;
+		flex-direction: column;
+		gap: 2px;
+		min-width: 0;
+		flex: 1;
+	}
+
+	.harness-main strong {
+		font-size: 13px;
+		color: var(--sig-text-bright);
+	}
+
+	.harness-main small {
+		font-size: 12px;
+		line-height: 1.35;
+		color: var(--sig-text-muted);
+		overflow: hidden;
+		white-space: nowrap;
+		text-overflow: ellipsis;
+	}
+
+	.harness-state {
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		color: var(--sig-text-muted);
+		flex: 0 0 auto;
+	}
+
+	@media (max-width: 620px) {
+		.field-grid {
+			grid-template-columns: 1fr;
+		}
+	}
+</style>
diff --git a/surfaces/dashboard/src/lib/components/onboarding/steps/ReviewStep.svelte b/surfaces/dashboard/src/lib/components/onboarding/steps/ReviewStep.svelte
new file mode 100644
index 000000000..1063abfef
--- /dev/null
+++ b/surfaces/dashboard/src/lib/components/onboarding/steps/ReviewStep.svelte
@@ -0,0 +1,174 @@
+<script lang="ts">
+	import {
+		EMBEDDING_PROVIDER_OPTIONS,
+		EXTRACTION_PROVIDER_OPTIONS,
+		IDENTITY_PRESET_META,
+		type OnboardingState,
+	} from "../onboarding-state.svelte";
+
+	interface Props {
+		state: OnboardingState;
+	}
+
+	const { state }: Props = $props();
+
+	const presetLabel = $derived(IDENTITY_PRESET_META.find((p) => p.name === state.identityPreset)?.title ?? state.identityPreset);
+	const embeddingLabel = $derived(
+		EMBEDDING_PROVIDER_OPTIONS.find((o) => o.value === state.embeddingProvider)?.label ??
+			state.embeddingProvider,
+	);
+	const extractionLabel = $derived(
+		EXTRACTION_PROVIDER_OPTIONS.find((o) => o.value === state.extractionProvider)?.label ??
+			state.extractionProvider,
+	);
+</script>
+
+<div class="review-grid">
+	<section class="review-section">
+		<span class="review-label">Identity preset</span>
+		<span class="review-value review-badge">{presetLabel}</span>
+	</section>
+
+	<section class="review-section">
+		<span class="review-label">Agent name</span>
+		<span class="review-value">{state.agentName}</span>
+	</section>
+
+	<section class="review-section">
+		<span class="review-label">Description</span>
+		<span class="review-value">{state.agentDescription}</span>
+	</section>
+
+	<section class="review-section">
+		<span class="review-label">Harnesses</span>
+		<div class="review-harnesses">
+			{#each state.selectedHarnesses as h (h)}
+				<span class="review-badge">{h}</span>
+			{/each}
+		</div>
+	</section>
+
+	<div class="review-divider"></div>
+
+	<section class="review-section">
+		<span class="review-label">Embedding</span>
+		<span class="review-value"
+			>{embeddingLabel}
+			{#if state.embeddingProvider !== "none" && state.embeddingModel}
+				<span class="review-dim">/ {state.embeddingModel}</span>
+			{/if}</span
+		>
+	</section>
+
+	<section class="review-section">
+		<span class="review-label">Extraction</span>
+		<span class="review-value"
+			>{extractionLabel}
+			{#if state.extractionProvider !== "none" && state.extractionModel}
+				<span class="review-dim">/ {state.extractionModel}</span>
+			{/if}</span
+		>
+	</section>
+
+	{#if state.extractionEndpoint}
+		<section class="review-section">
+			<span class="review-label">Endpoint</span>
+			<span class="review-value review-mono">{state.extractionEndpoint}</span>
+		</section>
+	{/if}
+
+	<section class="review-section">
+		<span class="review-label">Session synthesis</span>
+		<span class="review-value">{state.synthesisEnabled ? "Enabled" : "Disabled"}</span>
+	</section>
+
+	<p class="review-note">
+		Additional settings (network mode, search tuning, auth, advanced pipeline options) are available in
+		the Settings tab after saving.
+	</p>
+</div>
+
+<style>
+	.review-grid {
+		display: grid;
+		grid-template-columns: minmax(130px, 0.35fr) minmax(0, 1fr);
+		gap: 10px 18px;
+		align-items: baseline;
+	}
+
+	.review-section {
+		display: contents;
+	}
+
+	.review-divider {
+		grid-column: 1 / -1;
+		height: 1px;
+		background: linear-gradient(90deg, var(--sig-border-strong), transparent 80%);
+		margin: 4px 0;
+	}
+
+	.review-label {
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		color: var(--sig-text-muted);
+		padding-top: 2px;
+	}
+
+	.review-value {
+		font-size: 13px;
+		color: var(--sig-text-bright);
+	}
+
+	.review-dim {
+		color: var(--sig-text-muted);
+	}
+
+	.review-mono {
+		font-family: var(--font-mono, monospace);
+		font-size: 12px;
+	}
+
+	.review-badge {
+		display: inline-block;
+		padding: 2px 8px;
+		border: 1px solid var(--sig-border-strong);
+		border-radius: var(--sig-radius);
+		font-family: var(--font-mono, monospace);
+		font-size: 11px;
+		letter-spacing: 0.04em;
+		color: var(--sig-text-bright);
+		background: color-mix(in srgb, var(--sig-surface), transparent 5%);
+	}
+
+	.review-harnesses {
+		display: flex;
+		flex-wrap: wrap;
+		gap: 6px;
+	}
+
+	.review-note {
+		grid-column: 1 / -1;
+		margin: 10px 0 0;
+		padding: 10px 12px;
+		border: 1px solid var(--sig-border);
+		border-radius: var(--sig-radius);
+		background: var(--sig-surface);
+		font-size: 12px;
+		line-height: 1.35;
+		color: var(--sig-text-muted);
+	}
+
+	@media (max-width: 620px) {
+		.review-grid {
+			grid-template-columns: 1fr;
+			gap: 4px;
+		}
+
+		.review-label {
+			padding-top: 8px;
+			border-top: 1px solid var(--sig-border-strong);
+		}
+	}
+</style>
diff --git a/surfaces/dashboard/src/lib/components/onboarding/steps/WelcomeStep.svelte b/surfaces/dashboard/src/lib/components/onboarding/steps/WelcomeStep.svelte
new file mode 100644
index 000000000..468ff08eb
--- /dev/null
+++ b/surfaces/dashboard/src/lib/components/onboarding/steps/WelcomeStep.svelte
@@ -0,0 +1,152 @@
+<script lang="ts">
+	import { IDENTITY_PRESET_META, type IdentityPresetName, type OnboardingState } from "../onboarding-state.svelte";
+
+	interface Props {
+		state: OnboardingState;
+	}
+
+	const { state }: Props = $props();
+
+	const PRESET_META = IDENTITY_PRESET_META;
+
+	function selectPreset(name: IdentityPresetName): void {
+		state.identityPreset = name;
+	}
+</script>
+
+<div class="welcome-grid">
+	<p class="welcome-intro">
+		Choose an identity preset. This determines which files load at startup and shapes how your agent
+		thinks. You can change it later in Settings.
+	</p>
+
+	{#each PRESET_META as preset (preset.name)}
+		<button
+			type="button"
+			class="preset-card sig-switch"
+			class:preset-card-active={state.identityPreset === preset.name}
+			onclick={() => selectPreset(preset.name)}
+			aria-pressed={state.identityPreset === preset.name}
+		>
+			<span class="preset-radio" aria-hidden="true"></span>
+			<div class="preset-content">
+				<div class="preset-header">
+					<strong>{preset.title}</strong>
+					{#if state.identityPreset === preset.name}
+						<span class="selected-badge">selected</span>
+					{/if}
+				</div>
+				<p>{preset.subtitle}</p>
+				<span class="preset-files">{preset.files}</span>
+			</div>
+		</button>
+	{/each}
+</div>
+
+<style>
+	.welcome-grid {
+		display: grid;
+		grid-template-columns: repeat(2, minmax(0, 1fr));
+		gap: 12px;
+	}
+
+	.welcome-intro {
+		grid-column: 1 / -1;
+		margin: 0 0 4px;
+		font-size: 13px;
+		line-height: 1.4;
+		color: var(--sig-text);
+	}
+
+	.preset-card {
+		position: relative;
+		padding: 14px 14px 14px 36px;
+		text-align: left;
+		cursor: pointer;
+		border: 1px solid var(--sig-border-strong);
+		border-radius: var(--sig-radius);
+		background: color-mix(in srgb, var(--sig-surface), transparent 5%);
+		color: var(--sig-text);
+		transition: border-color var(--dur) var(--ease), background var(--dur) var(--ease),
+			box-shadow var(--dur) var(--ease);
+	}
+
+	.preset-card:hover {
+		border-color: var(--sig-highlight);
+		background: color-mix(in srgb, var(--sig-surface), var(--sig-highlight) 4%);
+	}
+
+	.preset-card-active {
+		border-color: var(--sig-highlight);
+		background: color-mix(in srgb, var(--sig-surface-raised), var(--sig-highlight) 10%);
+		box-shadow: var(--sig-glow-highlight), inset 3px 0 0 var(--sig-highlight),
+			inset 0 1px 0 rgba(255, 255, 255, 0.08);
+	}
+
+	.preset-radio {
+		position: absolute;
+		top: 16px;
+		left: 12px;
+		width: 13px;
+		height: 13px;
+		border: 1px solid var(--sig-border-strong);
+		background: var(--sig-bg);
+		border-radius: 50%;
+	}
+
+	.preset-card-active .preset-radio {
+		border-color: var(--sig-highlight);
+		background: var(--sig-highlight);
+		box-shadow: inset 0 0 0 3px var(--sig-bg),
+			0 0 10px color-mix(in srgb, var(--sig-highlight), transparent 36%);
+	}
+
+	.preset-content {
+		display: flex;
+		flex-direction: column;
+		gap: 5px;
+	}
+
+	.preset-header {
+		display: flex;
+		align-items: center;
+		gap: 8px;
+	}
+
+	.preset-header strong {
+		font-family: var(--font-display, monospace);
+		font-size: 13px;
+		letter-spacing: 0.08em;
+		text-transform: uppercase;
+		color: var(--sig-text-bright);
+	}
+
+	.selected-badge {
+		font-family: var(--font-mono, monospace);
+		font-size: 9px;
+		letter-spacing: 0.1em;
+		text-transform: uppercase;
+		color: var(--sig-highlight-text);
+	}
+
+	.preset-content p {
+		margin: 0;
+		font-size: 12px;
+		line-height: 1.35;
+		color: var(--sig-text-muted);
+	}
+
+	.preset-files {
+		font-family: var(--font-mono, monospace);
+		font-size: 10px;
+		letter-spacing: 0.04em;
+		color: var(--sig-text-muted);
+		opacity: 0.7;
+	}
+
+	@media (max-width: 620px) {
+		.welcome-grid {
+			grid-template-columns: 1fr;
+		}
+	}
+</style>
diff --git a/surfaces/dashboard/src/lib/components/tabs/settings/PipelineSection.svelte b/surfaces/dashboard/src/lib/components/tabs/settings/PipelineSection.svelte
index cc8175236..378c40373 100644
--- a/surfaces/dashboard/src/lib/components/tabs/settings/PipelineSection.svelte
+++ b/surfaces/dashboard/src/lib/components/tabs/settings/PipelineSection.svelte
@@ -16,12 +16,12 @@ import {
 	st,
 } from "$lib/stores/settings.svelte";
 import { modelPresetsForProvider } from "@signet/core/llm-model-catalog";
-import { defaultPipelineModel } from "@signet/core/pipeline-providers";
+import { type PipelineProviderChoice, defaultPipelineModel } from "@signet/core/pipeline-providers";
 import {
 	ACPX_DASHBOARD_AGENT_OPTIONS,
 	type AcpxDashboardAgent,
 	DEFAULT_OPENAI_COMPATIBLE_ENDPOINT,
-	applyAcpxDashboardSetup,
+	applyRecommendedPipelineSetup,
 	defaultAcpxDashboardAgent,
 	defaultAcpxDashboardModel,
 	hasExplicitSynthesisConfig,
@@ -327,35 +327,11 @@ function extractionModelLabel(): string {
 	return preset ? preset.label : model;
 }
 
-let acpxAgent = $state<AcpxDashboardAgent>("codex");
-let acpxModel = $state(defaultAcpxDashboardModel("codex"));
-
-$effect(() => {
-	const nextAgent = defaultAcpxDashboardAgent(st.agent);
-	acpxAgent = nextAgent;
-	const current =
-		st.aStr(["memory", "pipelineV2", "extractionProvider"]) === "acpx"
-			? st.aStr(["memory", "pipelineV2", "extractionModel"])
-			: "";
-	acpxModel = current || defaultAcpxDashboardModel(nextAgent);
-});
-
-function acpxAgentLabel(): string {
-	return ACPX_DASHBOARD_AGENT_OPTIONS.find((option) => option.value === acpxAgent)?.label ?? acpxAgent;
-}
-
-function setAcpxAgent(value: string | undefined): void {
-	if (value !== "codex" && value !== "claude-code" && value !== "opencode") return;
-	acpxAgent = value;
-	acpxModel = defaultAcpxDashboardModel(value);
-}
-
-function setAcpxModel(e: Event): void {
-	acpxModel = (e.currentTarget as HTMLInputElement).value;
-}
-
-function applyAcpxQuickSetup(): void {
-	applyAcpxDashboardSetup(st.agent, { agent: acpxAgent, model: acpxModel });
+function applyRecommendedSetup(): void {
+	const currentProvider = extractionProvider();
+	const provider: PipelineProviderChoice = isKnownProvider(currentProvider) ? currentProvider : "acpx";
+	const model = extractionModel() || defaultModelForProvider(provider);
+	applyRecommendedPipelineSetup(st.agent, { provider, model });
 	st.agent = { ...st.agent };
 }
 
@@ -378,46 +354,20 @@ const ADVANCED_FEATURE_KEYS = ["autonomousFrozen"] as const;
 {#if st.agentFile}
 	<FormSection description="V2 memory pipeline. Runs LLM-based fact extraction on incoming memories, then decides whether to write, update, or skip. Lives under memory.pipelineV2 in agent.yaml.">
 		<div class="rounded-lg border border-[var(--sig-border-strong)] bg-[color-mix(in_srgb,var(--sig-bg),var(--sig-highlight)_4%)] p-3">
-			<div class="flex flex-col gap-3">
-				<div class="flex items-start justify-between gap-3">
-					<div class="flex flex-col gap-1">
-						<span class="font-mono text-[10px] uppercase tracking-[0.12em] text-[var(--sig-highlight)]">ACPX quick setup</span>
-						<span class="text-[12px] leading-snug text-[var(--sig-text)]">Configure background extraction and session synthesis through ACPX with the guarded defaults Signet expects.</span>
-					</div>
-					<button
-						type="button"
-						class="shrink-0 rounded-md border border-[var(--sig-highlight)] bg-[color-mix(in_srgb,var(--sig-highlight),transparent_88%)] px-3 py-1.5 font-mono text-[10px] uppercase tracking-[0.08em] text-[var(--sig-highlight)] transition-colors hover:bg-[color-mix(in_srgb,var(--sig-highlight),transparent_80%)]"
-						onclick={applyAcpxQuickSetup}
-					>
-						Use ACPX defaults
-					</button>
-				</div>
-
-				<div class="grid gap-2 md:grid-cols-[minmax(0,1fr)_minmax(0,1.2fr)]">
-					<div class="flex flex-col gap-1.5">
-						<span class="font-mono text-[9px] uppercase tracking-[0.1em] text-[var(--sig-text-muted)]">Agent adapter</span>
-						<Select.Root type="single" value={acpxAgent} onValueChange={setAcpxAgent}>
-							<Select.Trigger class={selectTriggerClass}>{acpxAgentLabel()}</Select.Trigger>
-							<Select.Content class={selectContentClass}>
-								{#each ACPX_DASHBOARD_AGENT_OPTIONS as option (option.value)}
-									<Select.Item class={selectItemClass} value={option.value} label={option.label} />
-								{/each}
-							</Select.Content>
-						</Select.Root>
-					</div>
-					<div class="flex flex-col gap-1.5">
-						<span class="font-mono text-[9px] uppercase tracking-[0.1em] text-[var(--sig-text-muted)]">Model</span>
-						<Input value={acpxModel} oninput={setAcpxModel} placeholder="model passed through ACPX" />
-					</div>
-				</div>
-
-				<div class="grid gap-2 text-[9px] uppercase tracking-[0.08em] text-[var(--sig-text-muted)] md:grid-cols-3">
-					<span>npx acpx@0.7.0</span>
-					<span>permissions: deny-all</span>
-					<span>hooks: disabled</span>
+			<div class="flex items-start justify-between gap-3">
+				<div class="flex flex-col gap-1">
+					<span class="font-mono text-[10px] uppercase tracking-[0.12em] text-[var(--sig-highlight)]">Pipeline setup</span>
+					<span class="text-[12px] leading-snug text-[var(--sig-text)]">Configure extraction and session synthesis through the unified provider settings below. Provider routing stays with the shared LLM configuration instead of dashboard-specific inference wiring.</span>
 				</div>
-				<span class="text-[9px] uppercase tracking-wider text-[var(--sig-warning)]">Writes memory.pipelineV2 plus a background-acpx inference route for memory extraction and session synthesis. Save settings after applying.</span>
+				<button
+					type="button"
+					class="shrink-0 rounded-md border border-[var(--sig-highlight)] bg-[color-mix(in_srgb,var(--sig-highlight),transparent_88%)] px-3 py-1.5 font-mono text-[10px] uppercase tracking-[0.08em] text-[var(--sig-highlight)] transition-colors hover:bg-[color-mix(in_srgb,var(--sig-highlight),transparent_80%)]"
+					onclick={applyRecommendedSetup}
+				>
+					Use recommended defaults
+				</button>
 			</div>
+			<span class="mt-2 block text-[9px] uppercase tracking-wider text-[var(--sig-warning)]">Writes memory.pipelineV2 extraction and synthesis provider settings only. Save settings after applying.</span>
 		</div>
 
 		<FormField label={PIPELINE_CORE_BOOLS[0].key} description={PIPELINE_CORE_BOOLS[0].desc}>
diff --git a/surfaces/dashboard/src/lib/components/tabs/settings/pipeline-settings.test.ts b/surfaces/dashboard/src/lib/components/tabs/settings/pipeline-settings.test.ts
index 13847d5ad..e8342e0b4 100644
--- a/surfaces/dashboard/src/lib/components/tabs/settings/pipeline-settings.test.ts
+++ b/surfaces/dashboard/src/lib/components/tabs/settings/pipeline-settings.test.ts
@@ -3,8 +3,8 @@ import { describe, expect, it } from "bun:test";
 import { DEFAULT_PIPELINE_TIMEOUT_MS } from "@signet/core/pipeline-providers";
 import {
 	DEFAULT_OPENAI_COMPATIBLE_ENDPOINT,
-	applyAcpxDashboardSetup,
 	defaultAcpxDashboardAgent,
+	applyRecommendedPipelineSetup,
 	hasExplicitSynthesisConfig,
 	hasExplicitSynthesisProvider,
 	resolveExtractionEndpoint,
@@ -90,7 +90,7 @@ describe("pipeline-settings synthesis resolution", () => {
 					extractionModel: "qwen3:4b",
 					synthesis: {
 						provider: "claude-code",
-						model: "haiku",
+						model: "gpt-5-codex-mini",
 						endpoint: "http://127.0.0.1:9999",
 						timeout: 180000,
 					},
@@ -101,7 +101,7 @@ describe("pipeline-settings synthesis resolution", () => {
 		expect(hasExplicitSynthesisConfig(agent)).toBe(true);
 		expect(hasExplicitSynthesisProvider(agent)).toBe(true);
 		expect(resolveSynthesisProvider(agent)).toBe("claude-code");
-		expect(resolveSynthesisModel(agent)).toBe("haiku");
+		expect(resolveSynthesisModel(agent)).toBe("gpt-5-codex-mini");
 		expect(resolveSynthesisEndpoint(agent)).toBe("http://127.0.0.1:9999");
 		expect(resolveSynthesisTimeout(agent)).toBe(180000);
 		expect(resolveSynthesisEnabled(agent)).toBe(true);
@@ -181,7 +181,6 @@ describe("pipeline-settings ACPX dashboard setup", () => {
 
 	it("applies a one-click ACPX background setup for extraction, synthesis, and routing", () => {
 		const agent: Record<string, unknown> = {
-			harnesses: ["claude-code"],
 			inference: {
 				defaultPolicy: "custom-local",
 				targets: {
@@ -190,17 +189,20 @@ describe("pipeline-settings ACPX dashboard setup", () => {
 			},
 		};
 
-		applyAcpxDashboardSetup(agent, { agent: "claude-code" });
+		applyRecommendedPipelineSetup(agent, { provider: "acpx", model: "gpt-5-codex-mini" });
 
 		expect(agent.memory).toMatchObject({
 			pipelineV2: {
 				enabled: true,
 				extractionProvider: "acpx",
-				extractionModel: "haiku",
+				extractionModel: "gpt-5-codex-mini",
+				graphEnabled: true,
+				rerankerEnabled: true,
+				semanticContradictionEnabled: true,
 				synthesis: {
 					enabled: true,
 					provider: "acpx",
-					model: "haiku",
+					model: "gpt-5-codex-mini",
 					timeout: 120000,
 				},
 			},
@@ -212,21 +214,27 @@ describe("pipeline-settings ACPX dashboard setup", () => {
 			"allowUpdateDelete",
 		);
 		expect((agent.memory as { pipelineV2: Record<string, unknown> }).pipelineV2).not.toHaveProperty("maintenanceMode");
-		expect(agent.inference).toMatchObject({
+		expect(agent.inference).toEqual({
 			defaultPolicy: "custom-local",
 			targets: {
 				"custom-local": { executor: "ollama" },
 				"background-acpx": {
 					executor: "acpx",
 					acpx: {
-						agent: "claude",
+						agent: "codex",
 						package: "acpx@0.7.0",
+						version: "0.7.0",
+						mode: "exec",
+						terminal: "inherit",
 						permissions: "deny-all",
 						hooks: "disabled",
 					},
 					models: {
 						default: {
-							model: "haiku",
+							model: "gpt-5-codex-mini",
+							reasoning: "medium",
+							toolUse: true,
+							costTier: "medium",
 						},
 					},
 				},
@@ -235,12 +243,60 @@ describe("pipeline-settings ACPX dashboard setup", () => {
 				"background-acpx": {
 					mode: "automatic",
 					defaultTargets: ["background-acpx/default"],
+					fallbackTargets: ["background-acpx/default"],
 				},
 			},
+			taskClasses: {
+				memory_extraction: { reasoning: "medium", toolsRequired: true, privacy: "restricted_remote" },
+				session_synthesis: { reasoning: "medium", toolsRequired: true, privacy: "restricted_remote" },
+			},
 			workloads: {
 				memoryExtraction: { target: "background-acpx/default", taskClass: "memory_extraction" },
 				sessionSynthesis: { target: "background-acpx/default", taskClass: "session_synthesis" },
 			},
 		});
 	});
+
+	it("applies onboarding endpoint and ACPX harness choices", () => {
+		const localAgent: Record<string, unknown> = {};
+		applyRecommendedPipelineSetup(localAgent, {
+			provider: "llama-cpp",
+			model: "qwen3.5:4b",
+			endpoint: "http://127.0.0.1:8080/v1",
+		});
+		expect(localAgent.memory).toMatchObject({
+			pipelineV2: {
+				extractionProvider: "llama-cpp",
+				extractionModel: "qwen3.5:4b",
+				extractionEndpoint: "http://127.0.0.1:8080/v1",
+				extractionBaseUrl: "http://127.0.0.1:8080/v1",
+				extraction: {
+					provider: "llama-cpp",
+					model: "qwen3.5:4b",
+					endpoint: "http://127.0.0.1:8080/v1",
+				},
+				synthesis: {
+					provider: "llama-cpp",
+					model: "qwen3.5:4b",
+					endpoint: "http://127.0.0.1:8080/v1",
+				},
+			},
+		});
+
+		const acpxAgent: Record<string, unknown> = {};
+		applyRecommendedPipelineSetup(acpxAgent, {
+			provider: "acpx",
+			model: "gpt-5-codex-mini",
+			acpxHarness: "codex",
+		});
+		expect(acpxAgent.memory).toMatchObject({
+			pipelineV2: {
+				extraction: {
+					provider: "acpx",
+					model: "gpt-5-codex-mini",
+					harness: "codex",
+				},
+			},
+		});
+	});
 });
diff --git a/surfaces/dashboard/src/lib/components/tabs/settings/pipeline-settings.ts b/surfaces/dashboard/src/lib/components/tabs/settings/pipeline-settings.ts
index 82751d159..2ddcd6a07 100644
--- a/surfaces/dashboard/src/lib/components/tabs/settings/pipeline-settings.ts
+++ b/surfaces/dashboard/src/lib/components/tabs/settings/pipeline-settings.ts
@@ -175,23 +175,52 @@ function acpxCommandAgent(agent: AcpxDashboardAgent): string {
 	return agent === "claude-code" ? "claude" : agent;
 }
 
-export function applyAcpxDashboardSetup(
+export function applyRecommendedPipelineSetup(
 	agentConfig: Record<string, unknown>,
-	options: { readonly agent: AcpxDashboardAgent; readonly model?: string },
+		options: {
+			readonly provider?: PipelineProviderChoice;
+			readonly model?: string;
+			readonly agent?: AcpxDashboardAgent;
+			readonly endpoint?: string;
+			readonly acpxHarness?: string;
+			readonly synthesisEnabled?: boolean;
+		} = {},
 ): void {
-	const model = options.model?.trim() || defaultAcpxDashboardModel(options.agent);
+	const provider = options.provider ?? "acpx";
+	const model = options.model?.trim() || defaultPipelineModel(provider);
+	const endpoint = options.endpoint?.trim() ?? "";
+	const acpxHarness = options.acpxHarness?.trim() ?? "";
+	const enabled = provider !== "none";
 	const memory = ensureRecord(agentConfig, "memory");
 	const pipeline = ensureRecord(memory, "pipelineV2");
-	pipeline.enabled = true;
-	pipeline.extractionProvider = "acpx";
+	const extraction = ensureRecord(pipeline, "extraction");
+	pipeline.enabled = enabled;
+	pipeline.extractionProvider = provider;
 	pipeline.extractionModel = model;
-	pipeline.semanticContradictionEnabled = true;
-	pipeline.graphEnabled = true;
-	pipeline.rerankerEnabled = true;
+	extraction.provider = provider;
+	extraction.model = model;
+	if (endpoint) {
+		pipeline.extractionEndpoint = endpoint;
+		pipeline.extractionBaseUrl = endpoint;
+		extraction.endpoint = endpoint;
+	} else {
+		pipeline.extractionEndpoint = undefined;
+		pipeline.extractionBaseUrl = undefined;
+		extraction.endpoint = undefined;
+	}
+	if (provider === "acpx" && acpxHarness) {
+		extraction.harness = acpxHarness;
+	} else {
+		extraction.harness = undefined;
+	}
+	pipeline.semanticContradictionEnabled = enabled;
+	pipeline.graphEnabled = enabled;
+	pipeline.rerankerEnabled = enabled;
 	pipeline.synthesis = {
-		enabled: true,
-		provider: "acpx",
+		enabled: options.synthesisEnabled ?? enabled,
+		provider,
 		model,
+		...(endpoint ? { endpoint } : {}),
 		timeout: 120000,
 	};
 
@@ -200,7 +229,7 @@ export function applyAcpxDashboardSetup(
 	targets["background-acpx"] = {
 		executor: "acpx",
 		acpx: {
-			agent: acpxCommandAgent(options.agent),
+			agent: acpxCommandAgent(options.agent ?? "codex"),
 			package: "acpx@0.7.0",
 			version: "0.7.0",
 			mode: "exec",
diff --git a/surfaces/dashboard/src/routes/+page.svelte b/surfaces/dashboard/src/routes/+page.svelte
index d5e1534bb..842b4b55a 100644
--- a/surfaces/dashboard/src/routes/+page.svelte
+++ b/surfaces/dashboard/src/routes/+page.svelte
@@ -8,6 +8,7 @@ import GlobalCommandPalette from "$lib/components/command/GlobalCommandPalette.s
 import PageFooter from "$lib/components/layout/PageFooter.svelte";
 import TabContentLoader from "$lib/components/layout/TabContentLoader.svelte";
 import WindowTitlebar from "$lib/components/layout/WindowTitlebar.svelte";
+import OnboardingModal from "$lib/components/onboarding/OnboardingModal.svelte";
 import * as Sidebar from "$lib/components/ui/sidebar/index.js";
 import { Toaster } from "$lib/components/ui/sonner/index.js";
 import { isDesktopShell } from "$lib/desktop-shell";
@@ -294,6 +295,13 @@ $effect(() => {
 </div>
 
 <GlobalCommandPalette />
+<OnboardingModal
+	configFiles={data.configFiles}
+	memoryStats={data.memoryStats}
+	harnesses={data.harnesses}
+	{daemonStatus}
+	onnavigate={setTab}
+/>
 
 <Toaster
 	position="bottom-right"