diff --git a/packages/shared/src/features/interests/AgentContext.tsx b/packages/shared/src/features/interests/AgentContext.tsx
index 5d4186bc00..b220c8102d 100644
--- a/packages/shared/src/features/interests/AgentContext.tsx
+++ b/packages/shared/src/features/interests/AgentContext.tsx
@@ -17,10 +17,13 @@ import type {
 import {
   InterestRunStatus,
   InterestRunTrigger,
+  UserInterestOnboardingStep,
   UserInterestStatus,
 } from '../../graphql/interests';
 import { useSendInterestCommand } from './hooks/useSendInterestCommand';
 import { useUpdateInterest } from './hooks/useUpdateInterest';
+import { useCompleteInterestOnboarding } from './hooks/useCompleteInterestOnboarding';
+import { useConfirmInterestBrief } from './hooks/useConfirmInterestBrief';
 import { useToastNotification } from '../../hooks/useToastNotification';
 import { useAuthContext } from '../../contexts/AuthContext';
 import {
@@ -30,7 +33,12 @@ import {
 } from './queries';
 import { generateQueryKey, RequestKey } from '../../lib/query';
 import type { Post } from '../../graphql/posts';
-import type { AgentAttachment, AgentBlock, AgentMessage } from './chat';
+import type {
+  AgentAttachment,
+  AgentBlock,
+  AgentMessage,
+  AgentQuestionBlock,
+} from './chat';
 import { promptWithContext, restoreCommandText } from './chat';
 import type { AgentFeedItem } from './hooks/useAgentFeed';
 
@@ -82,6 +90,7 @@ type RunCommandArgs = {
   label?: string;
   targetId?: string;
   attachments?: AgentAttachment[];
+  questionId?: string;
   onComplete?: () => void;
 };
 
@@ -111,6 +120,27 @@ type AgentContextValue = {
   clearDraft: () => void;
   update: (data: UpdateInterestInput) => void;
   isUpdating: boolean;
+  isOnboarding: boolean;
+  onboardingStep?: UserInterestOnboardingStep | null;
+  /** The question at the tail of the transcript, still waiting on an answer. */
+  activeQuestion?: AgentQuestionBlock;
+  answerQuestion: (args: { text: string; questionId: string }) => void;
+  /** Selection for the open question, shared so Enter and the chips agree. */
+  pendingAnswer: string[];
+  togglePendingAnswer: (value: string) => void;
+  /** The review card is open and waiting to be confirmed. */
+  isReviewOpen: boolean;
+  completeOnboarding: () => void;
+  isCompleting: boolean;
+  /** The brief is on screen and can still be rewritten. */
+  isBriefOpen: boolean;
+  confirmBrief: (brief?: string) => void;
+  isConfirmingBrief: boolean;
+  /**
+   * Accepts whichever onboarding step is open. Shared by the composer and the
+   * workspace-wide Enter, so both do exactly the same thing.
+   */
+  advanceOnboarding: () => boolean;
   activity: AgentActivityItem[];
   messages: AgentMessage[];
   isHistoryPending: boolean;
@@ -183,6 +213,15 @@ const mapServerBlocks = (
       return acc;
     }
 
+    if (
+      block.type === 'question' ||
+      block.type === 'brief' ||
+      block.type === 'review'
+    ) {
+      acc.push(block);
+      return acc;
+    }
+
     if (block.type === 'picks') {
       const posts = resolvePosts(block.postIds, postsById);
 
@@ -305,6 +344,10 @@ export const AgentProvider = ({
   const { displayToast } = useToastNotification();
   const { sendCommand } = useSendInterestCommand(id);
   const { isUpdating, updateInterest } = useUpdateInterest(id);
+  const { isCompleting, completeOnboarding: runCompleteOnboarding } =
+    useCompleteInterestOnboarding(id);
+  const { isConfirmingBrief, confirmBrief: runConfirmBrief } =
+    useConfirmInterestBrief(id);
   const queryClient = useQueryClient();
   const [demoMessages, setDemoMessages] =
     useState<AgentMessage[]>(initialMessages);
@@ -513,6 +556,26 @@ export const AgentProvider = ({
     );
   }, [findings, isDemo, turns]);
 
+  const isOnboarding = interest?.status === UserInterestStatus.Onboarding;
+  // Live only at the tail: every earlier question already has its answer sitting
+  // under it, so the flow never has two open at once.
+  const lastMessage = messages[messages.length - 1];
+  const activeQuestion =
+    isOnboarding && lastMessage?.role === 'agent' && !lastMessage.isPending
+      ? (lastMessage.blocks?.find((block) => block.type === 'question') as
+          | AgentQuestionBlock
+          | undefined)
+      : undefined;
+
+  const isReviewOpen =
+    !!isOnboarding &&
+    lastMessage?.role === 'agent' &&
+    !lastMessage.isPending &&
+    !!lastMessage.blocks?.some((block) => block.type === 'review');
+
+  const isBriefOpen =
+    interest?.onboardingStep === UserInterestOnboardingStep.Brief;
+
   const serverPending = historyTurns.some(isRunPending);
   const echoPending = unresolvedEchoes.some((echo) => echo.state !== 'error');
   const isWorking = isDemo
@@ -549,6 +612,7 @@ export const AgentProvider = ({
       label,
       targetId,
       attachments: pointedAt,
+      questionId,
       onComplete,
     }: RunCommandArgs) => {
       workingRef.current = true;
@@ -614,7 +678,7 @@ export const AgentProvider = ({
         },
       ]);
 
-      sendCommand({ text: prompt })
+      sendCommand({ text: prompt, questionId })
         .then(() => {
           setEchoes((current) =>
             current.map((echo) =>
@@ -678,6 +742,90 @@ export const AgentProvider = ({
     [interest, isDemo, sendCommand],
   );
 
+  // Seeded from the question's own preselection and reset when the question
+  // changes, so the chips and the composer's Enter always submit the same set.
+  const [pendingAnswer, setPendingAnswer] = useState<string[]>([]);
+  const openQuestionId = activeQuestion?.questionId;
+
+  useEffect(() => {
+    setPendingAnswer(activeQuestion?.selected ?? []);
+    // Keyed on the question, not the block: re-renders must not wipe a choice.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [openQuestionId]);
+
+  const togglePendingAnswer = useCallback(
+    (value: string) =>
+      setPendingAnswer((current) => {
+        if (!activeQuestion?.multi) {
+          return [value];
+        }
+
+        return current.includes(value)
+          ? current.filter((item) => item !== value)
+          : [...current, value];
+      }),
+    [activeQuestion?.multi],
+  );
+
+  const confirmBrief = useCallback(
+    (brief?: string) => {
+      runConfirmBrief(brief).catch(() => undefined);
+    },
+    [runConfirmBrief],
+  );
+
+  const completeOnboarding = useCallback(() => {
+    runCompleteOnboarding().catch(() => undefined);
+  }, [runCompleteOnboarding]);
+
+  const answerQuestion = useCallback(
+    ({ text, questionId }: { text: string; questionId: string }) =>
+      runCommand({ text, questionId, label: text }),
+    [runCommand],
+  );
+
+  const advanceOnboarding = useCallback((): boolean => {
+    if (activeQuestion) {
+      const picked = (activeQuestion.choices ?? [])
+        .filter(({ value }) => pendingAnswer.includes(value))
+        .map(({ label }) => label)
+        .join(', ');
+
+      if (!picked) {
+        return false;
+      }
+
+      answerQuestion({
+        text: picked,
+        questionId: activeQuestion.questionId,
+      });
+
+      return true;
+    }
+
+    if (isBriefOpen) {
+      confirmBrief();
+
+      return true;
+    }
+
+    if (isReviewOpen) {
+      completeOnboarding();
+
+      return true;
+    }
+
+    return false;
+  }, [
+    activeQuestion,
+    answerQuestion,
+    completeOnboarding,
+    confirmBrief,
+    isBriefOpen,
+    isReviewOpen,
+    pendingAnswer,
+  ]);
+
   const attachContext = useCallback((attachment: AgentAttachment) => {
     setAttachments((current) =>
       current.some(({ id: existing }) => existing === attachment.id)
@@ -834,6 +982,19 @@ export const AgentProvider = ({
       clearDraft: () => setDraft(undefined),
       update,
       isUpdating,
+      isOnboarding: !!isOnboarding,
+      onboardingStep: interest?.onboardingStep,
+      activeQuestion,
+      answerQuestion,
+      pendingAnswer,
+      togglePendingAnswer,
+      isReviewOpen,
+      completeOnboarding,
+      isCompleting,
+      isBriefOpen,
+      confirmBrief,
+      isConfirmingBrief,
+      advanceOnboarding,
       activity,
       messages,
       isHistoryPending: historyQuery.isPending,
@@ -881,6 +1042,18 @@ export const AgentProvider = ({
       id,
       interest,
       isDemo,
+      isOnboarding,
+      activeQuestion,
+      answerQuestion,
+      pendingAnswer,
+      togglePendingAnswer,
+      isReviewOpen,
+      completeOnboarding,
+      isCompleting,
+      isBriefOpen,
+      confirmBrief,
+      isConfirmingBrief,
+      advanceOnboarding,
       isSettingsOpen,
       isUpdating,
       isWorking,
diff --git a/packages/shared/src/features/interests/attachments.ts b/packages/shared/src/features/interests/attachments.ts
index 8bd2b6f662..c98e19f956 100644
--- a/packages/shared/src/features/interests/attachments.ts
+++ b/packages/shared/src/features/interests/attachments.ts
@@ -1,6 +1,7 @@
 import type { Post } from '../../graphql/posts';
 import type { AgentActivityItem, AgentContentTarget } from './AgentContext';
 import type { AgentAttachment, AgentMessage } from './chat';
+import { isPostsBlock } from './chat';
 
 // Ids match the strings the content tabs use, so a post open in the panel and
 // the same post in the transcript dedupe to one entry.
@@ -74,7 +75,7 @@ const transcriptPosts = (messages: AgentMessage[]): Post[] =>
     .slice()
     .reverse()
     .flatMap(({ blocks }) => blocks ?? [])
-    .flatMap((block) => (block.type === 'text' ? [] : block.posts));
+    .flatMap((block) => (isPostsBlock(block) ? block.posts : []));
 
 export const mentionCandidates = ({
   openContent,
diff --git a/packages/shared/src/features/interests/chat.ts b/packages/shared/src/features/interests/chat.ts
index f6d0fa7346..b0a755391a 100644
--- a/packages/shared/src/features/interests/chat.ts
+++ b/packages/shared/src/features/interests/chat.ts
@@ -1,14 +1,28 @@
 import type { Post } from '../../graphql/posts';
 import type {
+  InterestQuestionChoice,
   InterestTurn,
   InterestTurnRelationship,
 } from '../../graphql/interests';
 
+export type AgentQuestionBlock = {
+  type: 'question';
+  questionId: string;
+  html: string;
+  input: 'chips' | 'text';
+  multi?: boolean;
+  choices?: InterestQuestionChoice[];
+  selected?: string[];
+};
+
 export type AgentBlock =
   | { type: 'text'; html: string }
   | { type: 'posts'; caption?: string; posts: Post[] }
   | { type: 'picks'; caption?: string; posts: Post[] }
-  | { type: 'feedLink'; label: string; posts: Post[] };
+  | { type: 'feedLink'; label: string; posts: Post[] }
+  | AgentQuestionBlock
+  | { type: 'brief'; html: string; brief: string }
+  | { type: 'review' };
 
 export type AgentAttachment = {
   id: string;
@@ -17,6 +31,13 @@ export type AgentAttachment = {
   detail?: string;
 };
 
+export type AgentPostsBlock = Extract<AgentBlock, { posts: Post[] }>;
+
+// Blocks that carry posts. A type guard rather than "not text", so a new block
+// type is excluded by default instead of crashing whatever reads `.posts`.
+export const isPostsBlock = (block: AgentBlock): block is AgentPostsBlock =>
+  block.type === 'posts' || block.type === 'picks' || block.type === 'feedLink';
+
 export type AgentMessage = {
   id: string;
   role: 'user' | 'agent';
diff --git a/packages/shared/src/features/interests/components/AgentBriefBlock.tsx b/packages/shared/src/features/interests/components/AgentBriefBlock.tsx
new file mode 100644
index 0000000000..b7b24a5a19
--- /dev/null
+++ b/packages/shared/src/features/interests/components/AgentBriefBlock.tsx
@@ -0,0 +1,115 @@
+import type { ReactElement } from 'react';
+import React, { useState } from 'react';
+import Markdown from '../../../components/Markdown';
+import {
+  Typography,
+  TypographyColor,
+  TypographyType,
+} from '../../../components/typography/Typography';
+import { FlexCol, FlexRow } from '../../../components/utilities';
+import {
+  Button,
+  ButtonSize,
+  ButtonVariant,
+} from '../../../components/buttons/Button';
+import { transcriptProse } from '../prose';
+import { useAgent } from '../AgentContext';
+
+export const AgentBriefBlock = ({
+  html,
+  brief,
+}: {
+  html: string;
+  brief: string;
+}): ReactElement => {
+  const { interest, isBriefOpen, confirmBrief, isConfirmingBrief } = useAgent();
+  const [draft, setDraft] = useState<string | null>(null);
+  const isEditing = draft !== null;
+  // Reflects a rewrite immediately, rather than the snapshot the run stored.
+  const current = interest?.brief ?? brief;
+
+  return (
+    <FlexCol className="gap-3 rounded-16 border border-border-subtlest-tertiary bg-surface-float p-4">
+      <Typography
+        type={TypographyType.Caption1}
+        color={TypographyColor.Tertiary}
+      >
+        Here is the brief I will run against
+      </Typography>
+
+      {isEditing ? (
+        <textarea
+          // eslint-disable-next-line jsx-a11y/no-autofocus
+          autoFocus
+          aria-label="Edit the brief"
+          rows={5}
+          value={draft}
+          onChange={(event) => setDraft(event.target.value)}
+          className="agent-scroll w-full resize-none rounded-12 border border-border-subtlest-secondary bg-transparent px-3 py-2 text-text-primary outline-none typo-callout"
+        />
+      ) : (
+        <blockquote className="border-l-2 border-brand-default pl-3">
+          {current === brief ? (
+            <Markdown className={transcriptProse} content={html} />
+          ) : (
+            <Typography
+              type={TypographyType.Callout}
+              className="!leading-relaxed"
+            >
+              {current}
+            </Typography>
+          )}
+        </blockquote>
+      )}
+
+      {isBriefOpen && (
+        <FlexRow className="items-center gap-2">
+          {isEditing ? (
+            <>
+              <Button
+                size={ButtonSize.Small}
+                variant={ButtonVariant.Primary}
+                loading={isConfirmingBrief}
+                disabled={!draft.trim()}
+                onClick={() => confirmBrief(draft.trim())}
+              >
+                Save and continue
+              </Button>
+              <Button
+                size={ButtonSize.Small}
+                variant={ButtonVariant.Tertiary}
+                onClick={() => setDraft(null)}
+              >
+                Cancel
+              </Button>
+            </>
+          ) : (
+            <>
+              <Button
+                size={ButtonSize.Small}
+                variant={ButtonVariant.Primary}
+                loading={isConfirmingBrief}
+                onClick={() => confirmBrief()}
+              >
+                Looks right
+              </Button>
+              <Button
+                size={ButtonSize.Small}
+                variant={ButtonVariant.Float}
+                onClick={() => setDraft(current)}
+              >
+                Edit it
+              </Button>
+              <Typography
+                type={TypographyType.Caption1}
+                color={TypographyColor.Quaternary}
+              >
+                or press Enter
+              </Typography>
+            </>
+          )}
+        </FlexRow>
+      )}
+    </FlexCol>
+  );
+};
diff --git a/packages/shared/src/features/interests/components/AgentChatSection.tsx b/packages/shared/src/features/interests/components/AgentChatSection.tsx
index 95669ae2b4..3f25477d18 100644
--- a/packages/shared/src/features/interests/components/AgentChatSection.tsx
+++ b/packages/shared/src/features/interests/components/AgentChatSection.tsx
@@ -44,6 +44,9 @@ import { AgentAttachmentChip } from './AgentAttachmentChip';
 import { addToChatFloat, AgentAddToChatButton } from './AgentAddToChatButton';
 import { AgentThinkingStrip } from './AgentThinkingStrip';
 import { AgentPostCard } from './AgentPostCard';
+import { AgentBriefBlock } from './AgentBriefBlock';
+import { AgentQuestionBlock } from './AgentQuestionBlock';
+import { AgentReviewBlock } from './AgentReviewBlock';
 import { AgentEmbedCard } from './blocks/AgentEmbedCard';
 
 const postLinkId = (href: string): string | undefined => {
@@ -79,6 +82,18 @@ const BlockRenderer = ({
   onPostLinkClick: (postId: string) => void;
   activePostId?: string;
 }): ReactElement => {
+  if (block.type === 'question') {
+    return <AgentQuestionBlock block={block} />;
+  }
+
+  if (block.type === 'review') {
+    return <AgentReviewBlock />;
+  }
+
+  if (block.type === 'brief') {
+    return <AgentBriefBlock html={block.html} brief={block.brief} />;
+  }
+
   if (block.type === 'text') {
     return (
       // eslint-disable-next-line jsx-a11y/no-static-element-interactions, jsx-a11y/click-events-have-key-events
@@ -457,7 +472,10 @@ const MessageRow = ({
               activePostId={activePostId}
             />
           ))}
-          {!!message.blocks?.length && <MessageActions message={message} />}
+          {message.blocks?.some(
+            ({ type }) =>
+              type !== 'question' && type !== 'review' && type !== 'brief',
+          ) && <MessageActions message={message} />}
         </>
       )}
     </FlexCol>
diff --git a/packages/shared/src/features/interests/components/AgentComposer.tsx b/packages/shared/src/features/interests/components/AgentComposer.tsx
index ac589cef40..b3a4720e7f 100644
--- a/packages/shared/src/features/interests/components/AgentComposer.tsx
+++ b/packages/shared/src/features/interests/components/AgentComposer.tsx
@@ -90,6 +90,12 @@ export const AgentComposer = (): ReactElement => {
     openContent,
     openContentTarget,
     setSettingsOpen,
+    isOnboarding,
+    activeQuestion,
+    answerQuestion,
+    advanceOnboarding,
+    isBriefOpen,
+    isReviewOpen,
     attachments,
     attachContext,
     detachContext,
@@ -249,6 +255,15 @@ export const AgentComposer = (): ReactElement => {
     write('');
   };
 
+  // Typing only answers an open free-text question. Every other onboarding step
+  // is driven by its own controls, so the field stands down rather than
+  // inviting input nothing is waiting on. Enter still advances: the workspace
+  // listens for it, which a disabled field could not.
+  const needsTypedAnswer = activeQuestion?.input === 'text';
+  const isComposerOff = isOnboarding && !needsTypedAnswer;
+  const canAdvance =
+    isOnboarding && (!!activeQuestion || isBriefOpen || isReviewOpen);
+
   const onSubmit = () => {
     const trimmed = feedback.trim();
     const typed = command ? undefined : parseCommand(trimmed);
@@ -257,6 +272,24 @@ export const AgentComposer = (): ReactElement => {
       parsed && isCommandAvailable(parsed, canDebug) ? parsed : undefined;
     const args = typed ? typed.args : trimmed;
 
+    // Empty Enter accepts whatever step is open, so the whole flow can be
+    // stepped through from the keyboard. A picked command has no text either,
+    // so it must not be swallowed here.
+    if (!trimmed && !sending) {
+      if (advanceOnboarding()) {
+        clear();
+      }
+
+      return;
+    }
+
+    if (activeQuestion && trimmed) {
+      answerQuestion({ text: trimmed, questionId: activeQuestion.questionId });
+      clear();
+
+      return;
+    }
+
     if (!sending && !trimmed) {
       return;
     }
@@ -335,6 +368,20 @@ export const AgentComposer = (): ReactElement => {
       return command.ask ?? 'Press enter to run it…';
     }
 
+    if (isComposerOff) {
+      if (isReviewOpen) {
+        return 'Press Enter to start hunting…';
+      }
+
+      return isBriefOpen
+        ? 'Use the buttons above, or press Enter…'
+        : 'Pick an option above, or press Enter…';
+    }
+
+    if (needsTypedAnswer) {
+      return 'Type your answer…';
+    }
+
     return isWorking
       ? 'Send feedback and it runs next…'
       : 'Ask anything, or / for commands…';
@@ -437,6 +484,7 @@ export const AgentComposer = (): ReactElement => {
                   aria-controls={hasMenuItems ? composerMenuId : undefined}
                   aria-activedescendant={activeOptionId}
                   placeholder={placeholder}
+                  disabled={isComposerOff}
                   value={feedback}
                   className={classNames(
                     'block w-full resize-none bg-transparent text-text-primary outline-none typo-callout placeholder:text-text-quaternary',
@@ -454,7 +502,9 @@ export const AgentComposer = (): ReactElement => {
               <AgentSendButton
                 label="Send to agent"
                 className="shrink-0"
-                disabled={!feedback.trim() && !command}
+                disabled={
+                  isComposerOff || (!feedback.trim() && !command && !canAdvance)
+                }
                 onClick={onSubmit}
               />
             </FlexRow>
diff --git a/packages/shared/src/features/interests/components/AgentHomeScreen.spec.tsx b/packages/shared/src/features/interests/components/AgentHomeScreen.spec.tsx
index ab0de5f4eb..1866873eb7 100644
--- a/packages/shared/src/features/interests/components/AgentHomeScreen.spec.tsx
+++ b/packages/shared/src/features/interests/components/AgentHomeScreen.spec.tsx
@@ -173,6 +173,7 @@ describe('AgentHomeScreen spawn settings', () => {
     expect(onCreate).toHaveBeenCalledWith({
       query: 'Rust in production',
       settings: defaultCreateInterestSettings,
+      onboarding: true,
     });
   });
 
@@ -186,7 +187,6 @@ describe('AgentHomeScreen spawn settings', () => {
 
     fireEvent.click(screen.getByRole('button', { name: 'Agent settings' }));
     fireEvent.click(screen.getByLabelText('Every week'));
-    fireEvent.click(screen.getByLabelText('Send a digest email'));
     fireEvent.change(field(), { target: { value: 'Zig internals' } });
     fireEvent.click(screen.getByLabelText('Spawn the agent'));
 
@@ -198,11 +198,12 @@ describe('AgentHomeScreen spawn settings', () => {
         outputModes: {
           feed: true,
           post: true,
-          digest: true,
+          digest: false,
           notification: true,
         },
         showHistory: true,
       },
+      onboarding: true,
     });
   });
 
@@ -211,7 +212,6 @@ describe('AgentHomeScreen spawn settings', () => {
 
     expect(screen.getByText('Whenever it matters')).toBeInTheDocument();
     expect(screen.getByText('Balanced')).toBeInTheDocument();
-    expect(screen.getByText('feed, posts, notifications')).toBeInTheDocument();
     expect(screen.getByText('Full history')).toBeInTheDocument();
     expect(screen.queryByLabelText('Every week')).not.toBeInTheDocument();
 
diff --git a/packages/shared/src/features/interests/components/AgentHomeScreen.tsx b/packages/shared/src/features/interests/components/AgentHomeScreen.tsx
index bf5aea0506..0d7ac87b2d 100644
--- a/packages/shared/src/features/interests/components/AgentHomeScreen.tsx
+++ b/packages/shared/src/features/interests/components/AgentHomeScreen.tsx
@@ -35,9 +35,7 @@ import {
   CadenceSection,
   FomoSection,
   HistorySection,
-  OutputModesSection,
   cadenceOptions,
-  outputOptions,
 } from './AgentSettingsFields';
 
 const maxFieldHeight = 120;
@@ -141,6 +139,7 @@ export const AgentHomeScreen = ({
   onCreate: (input: {
     query: string;
     settings?: CreateInterestSettings;
+    onboarding?: boolean;
   }) => void | Promise<unknown>;
   isCreating?: boolean;
   isStandalone?: boolean;
@@ -191,18 +190,14 @@ export const AgentHomeScreen = ({
 
     // The mutation reports its own failure with a toast, so swallowing here only
     // stops the same failure escaping as an unhandled rejection.
-    Promise.resolve(onCreate({ query: trimmed, settings })).catch(
-      () => undefined,
-    );
+    Promise.resolve(
+      onCreate({ query: trimmed, settings, onboarding: true }),
+    ).catch(() => undefined);
   };
 
   const cadenceSummary =
     cadenceOptions.find(({ value }) => value === settings.cadence)?.label ??
     'Whenever it matters';
-  const deliverySummary = outputOptions
-    .filter(({ key }) => settings.outputModes?.[key])
-    .map(({ short }) => short)
-    .join(', ');
   const threshold = settings.fomoThreshold ?? 0.5;
   let fomoSummary = 'Balanced';
   if (threshold > 0.7) {
@@ -214,7 +209,6 @@ export const AgentHomeScreen = ({
   const peekRows = [
     ['When it reports', cadenceSummary],
     ['FOMO vs quality', fomoSummary],
-    ['What it delivers', deliverySummary || 'Nothing yet'],
     [
       'History',
       settings.showHistory === false ? 'Latest only' : 'Full history',
@@ -426,16 +420,6 @@ export const AgentHomeScreen = ({
                     setSettings((current) => ({ ...current, fomoThreshold }))
                   }
                 />
-                <OutputModesSection
-                  value={settings.outputModes}
-                  disabled={isCreating}
-                  onChange={(outputModes) =>
-                    setSettings((current) => ({
-                      ...current,
-                      outputModes: { ...current.outputModes, ...outputModes },
-                    }))
-                  }
-                />
                 <HistorySection
                   value={settings.showHistory ?? true}
                   disabled={isCreating}
diff --git a/packages/shared/src/features/interests/components/AgentIntro.tsx b/packages/shared/src/features/interests/components/AgentIntro.tsx
index ce6ec326b0..5d94ed660d 100644
--- a/packages/shared/src/features/interests/components/AgentIntro.tsx
+++ b/packages/shared/src/features/interests/components/AgentIntro.tsx
@@ -25,7 +25,8 @@ export const AgentIntro = ({
   postsCount: number;
 }): ReactElement => {
   const { interest, status } = useAgent();
-  const isPaused = status !== UserInterestStatus.Active;
+  const isOnboarding = status === UserInterestStatus.Onboarding;
+  const isPaused = !isOnboarding && status !== UserInterestStatus.Active;
   const cadence = cadenceCopy[interest?.cadence ?? 'daily'];
 
   return (
@@ -34,8 +35,15 @@ export const AgentIntro = ({
         type={TypographyType.Caption1}
         color={TypographyColor.Tertiary}
       >
-        {isPaused ? 'Paused, no scheduled runs' : `Runs ${cadence}`}
-        {` · ${findingsCount} in feed · ${postsCount} posts written`}
+        {(() => {
+          if (isOnboarding) {
+            return 'Setting up';
+          }
+
+          return isPaused ? 'Paused, no scheduled runs' : `Runs ${cadence}`;
+        })()}
+        {!isOnboarding &&
+          ` · ${findingsCount} in feed · ${postsCount} posts written`}
       </Typography>
       {interest?.lastRunAt && (
         <Typography
diff --git a/packages/shared/src/features/interests/components/AgentQuestionBlock.tsx b/packages/shared/src/features/interests/components/AgentQuestionBlock.tsx
new file mode 100644
index 0000000000..d8b8378b2c
--- /dev/null
+++ b/packages/shared/src/features/interests/components/AgentQuestionBlock.tsx
@@ -0,0 +1,136 @@
+import type { ReactElement } from 'react';
+import React from 'react';
+import classNames from 'classnames';
+import Markdown from '../../../components/Markdown';
+import {
+  Typography,
+  TypographyColor,
+  TypographyType,
+} from '../../../components/typography/Typography';
+import { FlexCol, FlexRow } from '../../../components/utilities';
+import {
+  Button,
+  ButtonSize,
+  ButtonVariant,
+} from '../../../components/buttons/Button';
+import { VIcon } from '../../../components/icons';
+import { IconSize } from '../../../components/Icon';
+import type { AgentQuestionBlock as QuestionBlock } from '../chat';
+import { transcriptProse } from '../prose';
+import { useAgent } from '../AgentContext';
+
+export const AgentQuestionBlock = ({
+  block,
+}: {
+  block: QuestionBlock;
+}): ReactElement => {
+  const {
+    activeQuestion,
+    answerQuestion,
+    isWorking,
+    pendingAnswer,
+    togglePendingAnswer,
+  } = useAgent();
+  const isLive = activeQuestion?.questionId === block.questionId;
+  // An answered question keeps showing what was chosen, not the live selection.
+  const selected = isLive ? pendingAnswer : block.selected ?? [];
+
+  const labelsFor = (values: string[]): string =>
+    (block.choices ?? [])
+      .filter(({ value }) => values.includes(value))
+      .map(({ label }) => label)
+      .join(', ');
+
+  const submit = (values: string[]) => {
+    const text = labelsFor(values);
+
+    if (!text) {
+      return;
+    }
+
+    answerQuestion({ text, questionId: block.questionId });
+  };
+
+  const toggle = (value: string) => {
+    if (!block.multi) {
+      submit([value]);
+      return;
+    }
+
+    togglePendingAnswer(value);
+  };
+
+  return (
+    <FlexCol
+      className={classNames(
+        'gap-3 rounded-16 border border-border-subtlest-tertiary bg-surface-float p-4',
+        !isLive && 'opacity-60',
+      )}
+    >
+      <Markdown className={transcriptProse} content={block.html} />
+
+      {block.input === 'text' && !isLive && (
+        <FlexRow className="items-center gap-1.5">
+          <VIcon size={IconSize.Size16} className="text-status-success" />
+          <Typography
+            type={TypographyType.Footnote}
+            color={TypographyColor.Tertiary}
+          >
+            Answered
+          </Typography>
+        </FlexRow>
+      )}
+
+      {isLive && block.input === 'text' && (
+        <Typography
+          type={TypographyType.Caption1}
+          color={TypographyColor.Quaternary}
+        >
+          Answer below.
+        </Typography>
+      )}
+
+      {block.input === 'chips' && (
+        <FlexCol className="gap-3">
+          <FlexRow className="flex-wrap gap-2">
+            {(block.choices ?? []).map(({ value, label }) => {
+              const isOn = selected.includes(value);
+
+              return (
+                <Button
+                  key={value}
+                  size={ButtonSize.Small}
+                  variant={isOn ? ButtonVariant.Primary : ButtonVariant.Float}
+                  pressed={isOn}
+                  aria-pressed={isOn}
+                  disabled={!isLive || isWorking}
+                  onClick={() => toggle(value)}
+                >
+                  {label}
+                </Button>
+              );
+            })}
+          </FlexRow>
+          {isLive && block.multi && (
+            <FlexRow className="items-center gap-3">
+              <Button
+                size={ButtonSize.Small}
+                variant={ButtonVariant.Primary}
+                disabled={!selected.length || isWorking}
+                onClick={() => submit(selected)}
+              >
+                Continue
+              </Button>
+              <Typography
+                type={TypographyType.Caption1}
+                color={TypographyColor.Quaternary}
+              >
+                or press Enter
+              </Typography>
+            </FlexRow>
+          )}
+        </FlexCol>
+      )}
+    </FlexCol>
+  );
+};
diff --git a/packages/shared/src/features/interests/components/AgentReviewBlock.tsx b/packages/shared/src/features/interests/components/AgentReviewBlock.tsx
new file mode 100644
index 0000000000..9ae5c879fe
--- /dev/null
+++ b/packages/shared/src/features/interests/components/AgentReviewBlock.tsx
@@ -0,0 +1,149 @@
+import type { ReactElement } from 'react';
+import React, { useState } from 'react';
+import {
+  Typography,
+  TypographyColor,
+  TypographyType,
+} from '../../../components/typography/Typography';
+import { FlexCol, FlexRow } from '../../../components/utilities';
+import {
+  Button,
+  ButtonSize,
+  ButtonVariant,
+} from '../../../components/buttons/Button';
+import { UserInterestCadence } from '../../../graphql/interests';
+import { useAgent } from '../AgentContext';
+import {
+  CadenceSection,
+  FomoSection,
+  NotificationsSection,
+  cadenceOptions,
+} from './AgentSettingsFields';
+
+type Editable = 'cadence' | 'fomo' | 'notifications';
+
+export const AgentReviewBlock = (): ReactElement => {
+  const {
+    interest,
+    update,
+    isUpdating,
+    isOnboarding,
+    isCompleting,
+    completeOnboarding,
+  } = useAgent();
+  const [editing, setEditing] = useState<Editable>();
+
+  const threshold = interest?.fomoThreshold ?? 0.5;
+  const fomoSummary = (() => {
+    if (threshold >= 0.9) {
+      return 'Only perfect matches';
+    }
+
+    if (threshold >= 0.7) {
+      return 'Quality over quantity';
+    }
+
+    return threshold < 0.3 ? 'Show me everything' : 'Balanced';
+  })();
+
+  const rows: { key: Editable; label: string; value: string }[] = [
+    {
+      key: 'cadence',
+      label: 'When it reports',
+      value:
+        cadenceOptions.find(({ value }) => value === interest?.cadence)
+          ?.label ?? 'Whenever it matters',
+    },
+    { key: 'fomo', label: 'FOMO vs quality', value: fomoSummary },
+    {
+      key: 'notifications',
+      label: 'Notifications',
+      value:
+        interest?.outputModes?.notification === false ? 'Off' : 'Notify me',
+    },
+  ];
+
+  return (
+    <FlexCol className="gap-3 rounded-16 border border-border-subtlest-tertiary bg-surface-float p-4">
+      <Typography type={TypographyType.Body} bold>
+        Ready when you are
+      </Typography>
+
+      <FlexCol className="divide-y divide-border-subtlest-tertiary rounded-12 border border-border-subtlest-tertiary">
+        {rows.map(({ key, label, value }) => (
+          <FlexCol key={key}>
+            <FlexRow className="items-center gap-3 px-3 py-2">
+              <span className="w-32 shrink-0 text-text-quaternary typo-caption1">
+                {label}
+              </span>
+              <span className="min-w-0 flex-1 truncate text-text-primary typo-footnote">
+                {value}
+              </span>
+              <Button
+                size={ButtonSize.XSmall}
+                variant={ButtonVariant.Tertiary}
+                onClick={() =>
+                  setEditing((current) => (current === key ? undefined : key))
+                }
+              >
+                {editing === key ? 'Done' : 'Change'}
+              </Button>
+            </FlexRow>
+            {editing === key && (
+              <div className="border-t border-border-subtlest-tertiary px-3">
+                {key === 'cadence' && (
+                  <CadenceSection
+                    value={interest?.cadence ?? UserInterestCadence.Auto}
+                    disabled={isUpdating}
+                    onChange={(cadence) => update({ cadence })}
+                  />
+                )}
+                {key === 'fomo' && (
+                  <FomoSection
+                    value={threshold}
+                    onChange={(fomoThreshold) => update({ fomoThreshold })}
+                  />
+                )}
+                {key === 'notifications' && (
+                  <NotificationsSection
+                    value={interest?.outputModes?.notification ?? true}
+                    disabled={isUpdating}
+                    onChange={(notification) =>
+                      update({ outputModes: { notification } })
+                    }
+                  />
+                )}
+              </div>
+            )}
+          </FlexCol>
+        ))}
+      </FlexCol>
+
+      {isOnboarding ? (
+        <FlexRow className="items-center gap-3 pt-1">
+          <Button
+            size={ButtonSize.Small}
+            variant={ButtonVariant.Primary}
+            loading={isCompleting}
+            onClick={completeOnboarding}
+          >
+            Start hunting
+          </Button>
+          <Typography
+            type={TypographyType.Caption1}
+            color={TypographyColor.Quaternary}
+          >
+            or press Enter
+          </Typography>
+        </FlexRow>
+      ) : (
+        <Typography
+          type={TypographyType.Footnote}
+          color={TypographyColor.Tertiary}
+        >
+          Running. Change any of this in settings whenever you like.
+        </Typography>
+      )}
+    </FlexCol>
+  );
+};
diff --git a/packages/shared/src/features/interests/components/AgentSettingsFields.tsx b/packages/shared/src/features/interests/components/AgentSettingsFields.tsx
index c6c8fed30b..063e0572e3 100644
--- a/packages/shared/src/features/interests/components/AgentSettingsFields.tsx
+++ b/packages/shared/src/features/interests/components/AgentSettingsFields.tsx
@@ -9,7 +9,6 @@ import { FlexCol, FlexRow } from '../../../components/utilities';
 import { Switch } from '../../../components/fields/Switch';
 import { Slider } from '../../../components/fields/Slider';
 import { Radio } from '../../../components/fields/Radio';
-import type { InterestOutputModes } from '../../../graphql/interests';
 import { UserInterestCadence } from '../../../graphql/interests';
 
 export const cadenceOptions = [
@@ -19,33 +18,6 @@ export const cadenceOptions = [
   { value: UserInterestCadence.Weekly, label: 'Every week' },
 ];
 
-export const outputOptions = [
-  {
-    key: 'feed',
-    label: 'Add findings to my feed',
-    short: 'feed',
-    hint: 'Curated cards you can browse here',
-  },
-  {
-    key: 'post',
-    label: 'Write summary posts',
-    short: 'posts',
-    hint: 'A markdown recap of what it found',
-  },
-  {
-    key: 'notification',
-    label: 'Notify me about new content',
-    short: 'notifications',
-    hint: 'In-app and push ping when something lands',
-  },
-  {
-    key: 'digest',
-    label: 'Send a digest email',
-    short: 'email digest',
-    hint: 'Up to 5 picks, delivered at your chosen time',
-  },
-] as const;
-
 export const SettingsSection = ({
   title,
   hint,
@@ -96,6 +68,24 @@ export const CadenceSection = ({
   </SettingsSection>
 );
 
+// Bands line up with the onboarding presets, so the slider never describes a
+// value differently from the chip that set it.
+const fomoHint = (threshold: number): string => {
+  if (threshold >= 0.9) {
+    return 'Only perfect matches. Everything else is ignored.';
+  }
+
+  if (threshold >= 0.7) {
+    return 'Quality over quantity. You will miss some.';
+  }
+
+  if (threshold < 0.3) {
+    return 'You will see more, including the borderline stuff.';
+  }
+
+  return 'A fair balance of quality and volume.';
+};
+
 export const FomoSection = ({
   value,
   onChange,
@@ -107,14 +97,7 @@ export const FomoSection = ({
   const threshold = draft ?? value;
 
   return (
-    <SettingsSection
-      title="FOMO vs quality"
-      hint={
-        threshold > 0.7
-          ? 'Only the very best makes it through.'
-          : 'You will see more, including the borderline stuff.'
-      }
-    >
+    <SettingsSection title="FOMO vs quality" hint={fomoHint(threshold)}>
       <Slider
         min={0}
         max={0.95}
@@ -134,67 +117,59 @@ export const FomoSection = ({
           type={TypographyType.Caption1}
           color={TypographyColor.Tertiary}
         >
-          Only the best
+          Only perfect matches
         </Typography>
       </FlexRow>
     </SettingsSection>
   );
 };
 
-export const OutputModesSection = ({
+export const HistorySection = ({
   value,
   disabled,
   onChange,
 }: {
-  value: Partial<InterestOutputModes> | undefined;
+  value: boolean;
   disabled?: boolean;
-  onChange: (outputModes: Partial<InterestOutputModes>) => void;
+  onChange: (showHistory: boolean) => void;
 }): ReactElement => (
-  <SettingsSection title="What it delivers">
-    {outputOptions.map(({ key, label, hint }) => (
-      <FlexCol key={key} className="gap-0.5">
-        <Switch
-          inputId={`agent-output-${key}`}
-          name={`agent-output-${key}`}
-          checked={!!value?.[key]}
-          disabled={disabled}
-          onToggle={() => onChange({ [key]: !value?.[key] })}
-        >
-          {label}
-        </Switch>
-        <Typography
-          type={TypographyType.Caption1}
-          color={TypographyColor.Tertiary}
-          className="pl-14"
-        >
-          {hint}
-        </Typography>
-      </FlexCol>
-    ))}
+  <SettingsSection
+    title="History"
+    hint="Off shows only the latest update when you open this agent."
+  >
+    <Switch
+      inputId="agent-show-history"
+      name="agent-show-history"
+      checked={value}
+      disabled={disabled}
+      onToggle={() => onChange(!value)}
+    >
+      Show history
+    </Switch>
   </SettingsSection>
 );
 
-export const HistorySection = ({
+export const NotificationsSection = ({
   value,
   disabled,
   onChange,
 }: {
   value: boolean;
   disabled?: boolean;
-  onChange: (showHistory: boolean) => void;
+  onChange: (notification: boolean) => void;
 }): ReactElement => (
   <SettingsSection
-    title="History"
-    hint="Off shows only the latest update when you open this agent."
+    title="Notifications"
+    hint="A ping when something clears your bar. Nothing else."
   >
     <Switch
-      inputId="agent-show-history"
-      name="agent-show-history"
+      inputId="agent-notifications"
+      name="agent-notifications"
       checked={value}
       disabled={disabled}
       onToggle={() => onChange(!value)}
     >
-      Show history
+      Notify me
     </Switch>
   </SettingsSection>
 );
diff --git a/packages/shared/src/features/interests/components/AgentSettingsPane.tsx b/packages/shared/src/features/interests/components/AgentSettingsPane.tsx
index a66fd664c0..0546121ce7 100644
--- a/packages/shared/src/features/interests/components/AgentSettingsPane.tsx
+++ b/packages/shared/src/features/interests/components/AgentSettingsPane.tsx
@@ -26,7 +26,7 @@ import {
   CadenceSection,
   FomoSection,
   HistorySection,
-  OutputModesSection,
+  NotificationsSection,
   SettingsSection,
 } from './AgentSettingsFields';
 
@@ -86,10 +86,12 @@ export const AgentSettingsPane = ({
             onChange={(fomoThreshold) => update({ fomoThreshold })}
           />
 
-          <OutputModesSection
-            value={interest?.outputModes}
+          <NotificationsSection
+            value={interest?.outputModes?.notification ?? true}
             disabled={isUpdating}
-            onChange={(outputModes) => update({ outputModes })}
+            onChange={(notification) =>
+              update({ outputModes: { notification } })
+            }
           />
 
           <HistorySection
diff --git a/packages/shared/src/features/interests/components/AgentWorkspace.tsx b/packages/shared/src/features/interests/components/AgentWorkspace.tsx
index f9d544c3f8..aaf76ba49a 100644
--- a/packages/shared/src/features/interests/components/AgentWorkspace.tsx
+++ b/packages/shared/src/features/interests/components/AgentWorkspace.tsx
@@ -52,6 +52,7 @@ export const AgentWorkspace = ({
     isHistoryPending,
     isRunView,
     isHistoryLimited,
+    advanceOnboarding,
   } = useAgent();
   const shellHeight = useAgentShellHeight(isStandalone);
   const [storedWidth, setStoredWidth, isWidthLoaded] =
@@ -193,6 +194,38 @@ export const AgentWorkspace = ({
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [isTailPending]);
 
+  // "Press Enter" has to hold anywhere on the screen: clicking a chip moves
+  // focus onto that button, and the composer's own handler only fires while the
+  // field is focused.
+  useEffect(() => {
+    const onKeyDown = (event: KeyboardEvent) => {
+      if (event.key !== 'Enter' || event.shiftKey || event.defaultPrevented) {
+        return;
+      }
+
+      const target = event.target as HTMLElement | null;
+      const tag = target?.tagName;
+
+      // The composer, and any other field, answer for themselves.
+      if (
+        tag === 'INPUT' ||
+        tag === 'TEXTAREA' ||
+        target?.isContentEditable ||
+        target?.closest('[role="dialog"]')
+      ) {
+        return;
+      }
+
+      if (advanceOnboarding()) {
+        event.preventDefault();
+      }
+    };
+
+    globalThis.addEventListener('keydown', onKeyDown);
+
+    return () => globalThis.removeEventListener('keydown', onKeyDown);
+  }, [advanceOnboarding]);
+
   useEffect(() => {
     const measure = () => {
       const workspace = workspaceRef.current;
diff --git a/packages/shared/src/features/interests/hooks/useCompleteInterestOnboarding.ts b/packages/shared/src/features/interests/hooks/useCompleteInterestOnboarding.ts
new file mode 100644
index 0000000000..e799d1ac3d
--- /dev/null
+++ b/packages/shared/src/features/interests/hooks/useCompleteInterestOnboarding.ts
@@ -0,0 +1,30 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { useAuthContext } from '../../../contexts/AuthContext';
+import { useToastNotification } from '../../../hooks/useToastNotification';
+import { generateQueryKey, RequestKey } from '../../../lib/query';
+import { completeInterestOnboarding } from '../../../graphql/interests';
+
+export const useCompleteInterestOnboarding = (id: string) => {
+  const { user } = useAuthContext();
+  const { displayToast } = useToastNotification();
+  const queryClient = useQueryClient();
+
+  const { isPending, mutateAsync } = useMutation({
+    mutationFn: () => completeInterestOnboarding(id),
+    onSuccess: async () => {
+      await Promise.all([
+        queryClient.invalidateQueries({
+          queryKey: generateQueryKey(RequestKey.Interests, user, id),
+        }),
+        queryClient.invalidateQueries({
+          queryKey: generateQueryKey(RequestKey.Interests, user),
+        }),
+      ]);
+    },
+    onError: () => {
+      displayToast('Failed to start the agent. Please try again.');
+    },
+  });
+
+  return { isCompleting: isPending, completeOnboarding: mutateAsync };
+};
diff --git a/packages/shared/src/features/interests/hooks/useConfirmInterestBrief.ts b/packages/shared/src/features/interests/hooks/useConfirmInterestBrief.ts
new file mode 100644
index 0000000000..1c06d71114
--- /dev/null
+++ b/packages/shared/src/features/interests/hooks/useConfirmInterestBrief.ts
@@ -0,0 +1,25 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { useAuthContext } from '../../../contexts/AuthContext';
+import { useToastNotification } from '../../../hooks/useToastNotification';
+import { generateQueryKey, RequestKey } from '../../../lib/query';
+import { confirmInterestBrief } from '../../../graphql/interests';
+
+export const useConfirmInterestBrief = (id: string) => {
+  const { user } = useAuthContext();
+  const { displayToast } = useToastNotification();
+  const queryClient = useQueryClient();
+
+  const { isPending, mutateAsync } = useMutation({
+    mutationFn: (brief?: string) => confirmInterestBrief({ id, brief }),
+    onSuccess: async () => {
+      await queryClient.invalidateQueries({
+        queryKey: generateQueryKey(RequestKey.Interests, user, id),
+      });
+    },
+    onError: () => {
+      displayToast('Failed to save the brief. Please try again.');
+    },
+  });
+
+  return { isConfirmingBrief: isPending, confirmBrief: mutateAsync };
+};
diff --git a/packages/shared/src/features/interests/hooks/useCreateInterest.ts b/packages/shared/src/features/interests/hooks/useCreateInterest.ts
index 2ba69252b3..a3a2d32115 100644
--- a/packages/shared/src/features/interests/hooks/useCreateInterest.ts
+++ b/packages/shared/src/features/interests/hooks/useCreateInterest.ts
@@ -16,8 +16,11 @@ export const useCreateInterest = ({
   const queryClient = useQueryClient();
 
   const { isPending, mutateAsync } = useMutation({
-    mutationFn: (input: { query: string; settings?: CreateInterestSettings }) =>
-      createInterest(input),
+    mutationFn: (input: {
+      query: string;
+      settings?: CreateInterestSettings;
+      onboarding?: boolean;
+    }) => createInterest(input),
     onSuccess: async (interest) => {
       // Without priming, the page opened below mounts while the fetch is still
       // in flight and lands on an empty transcript.
diff --git a/packages/shared/src/features/interests/hooks/useSendInterestCommand.ts b/packages/shared/src/features/interests/hooks/useSendInterestCommand.ts
index fd6329eebb..32dc9c8a59 100644
--- a/packages/shared/src/features/interests/hooks/useSendInterestCommand.ts
+++ b/packages/shared/src/features/interests/hooks/useSendInterestCommand.ts
@@ -13,10 +13,12 @@ export const useSendInterestCommand = (id: string) => {
     mutationFn: ({
       text,
       triggerRun,
+      questionId,
     }: {
       text: string;
       triggerRun?: boolean;
-    }) => sendInterestCommand({ id, text, triggerRun }),
+      questionId?: string;
+    }) => sendInterestCommand({ id, text, triggerRun, questionId }),
     onSuccess: async () => {
       await Promise.all([
         queryClient.invalidateQueries({
diff --git a/packages/shared/src/features/interests/monitorItems.ts b/packages/shared/src/features/interests/monitorItems.ts
index afae47916f..ef7c1231db 100644
--- a/packages/shared/src/features/interests/monitorItems.ts
+++ b/packages/shared/src/features/interests/monitorItems.ts
@@ -6,6 +6,7 @@ import {
 } from '../../graphql/interests';
 
 export type AgentMonitorState =
+  | 'onboarding'
   | 'waiting'
   | 'running'
   | 'watching'
@@ -28,6 +29,7 @@ export type AgentMonitorSource = UserInterest;
 const freshMs = 1000 * 60 * 60 * 6;
 
 const fallbackLine: Record<AgentMonitorState, string> = {
+  onboarding: 'Still being set up.',
   waiting: 'Came back with something.',
   running: 'Scanning now…',
   watching: 'Watching. Nothing new yet.',
@@ -40,6 +42,7 @@ const fallbackLine: Record<AgentMonitorState, string> = {
 // One word each. "Waiting for review" took the whole row on a phone, leaving
 // three letters of the name it described.
 export const stateLabel: Record<AgentMonitorState, string> = {
+  onboarding: 'Setup',
   waiting: 'Review',
   running: 'Running',
   watching: 'Watching',
@@ -50,6 +53,7 @@ export const stateLabel: Record<AgentMonitorState, string> = {
 };
 
 export const stateMeaning: Record<AgentMonitorState, string> = {
+  onboarding: 'Still being set up',
   waiting: 'Waiting for review',
   running: 'Running now',
   watching: 'Watching',
@@ -60,6 +64,7 @@ export const stateMeaning: Record<AgentMonitorState, string> = {
 };
 
 export const inkClass: Record<AgentMonitorState, string> = {
+  onboarding: 'text-status-help',
   waiting: 'text-brand-default',
   running: 'text-status-success',
   watching: 'text-status-info',
@@ -70,6 +75,7 @@ export const inkClass: Record<AgentMonitorState, string> = {
 };
 
 export const dotClass: Record<AgentMonitorState, string> = {
+  onboarding: 'bg-status-help',
   waiting: 'bg-brand-default',
   running: 'animate-pulse bg-status-success',
   watching: 'bg-status-info',
@@ -89,6 +95,11 @@ export const toMonitorItems = (
       !!agent.lastRunFindings && !!agent.lastRunAt && now - ran < freshMs;
 
     const resolve = (): AgentMonitorState => {
+      // Checked before the run status: its setup runs are not hunting runs.
+      if (agent.status === UserInterestStatus.Onboarding) {
+        return 'onboarding';
+      }
+
       if (
         agent.lastRunStatus === InterestRunStatus.Queued ||
         agent.lastRunStatus === InterestRunStatus.Running
diff --git a/packages/shared/src/features/interests/replyText.ts b/packages/shared/src/features/interests/replyText.ts
index be23f5e5ec..739ec38d0b 100644
--- a/packages/shared/src/features/interests/replyText.ts
+++ b/packages/shared/src/features/interests/replyText.ts
@@ -1,4 +1,5 @@
 import type { AgentBlock, AgentMessage } from './chat';
+import { isPostsBlock } from './chat';
 
 // For attribute position: a quote in an API title would otherwise close it.
 const escapeAttribute = (value: string) =>
@@ -37,6 +38,10 @@ export const messageAsMarkdown = (message: AgentMessage): string =>
         return blockParagraphs(block).join('\n\n');
       }
 
+      if (!isPostsBlock(block)) {
+        return '';
+      }
+
       const links = block.posts
         .map((post) => `- [${post.title}](${post.commentsPermalink})`)
         .join('\n');
@@ -57,6 +62,10 @@ export const messageAsHtml = (message: AgentMessage): string =>
         return block.html;
       }
 
+      if (!isPostsBlock(block)) {
+        return '';
+      }
+
       const items = block.posts
         .map(
           (post) =>
diff --git a/packages/shared/src/graphql/interests.ts b/packages/shared/src/graphql/interests.ts
index 11117984c7..b17337c857 100644
--- a/packages/shared/src/graphql/interests.ts
+++ b/packages/shared/src/graphql/interests.ts
@@ -8,6 +8,13 @@ export enum UserInterestStatus {
   Active = 'active',
   Paused = 'paused',
   Stopped = 'stopped',
+  Onboarding = 'onboarding',
+}
+
+export enum UserInterestOnboardingStep {
+  Questions = 'questions',
+  Brief = 'brief',
+  Settings = 'settings',
 }
 
 export enum UserInterestCadence {
@@ -41,12 +48,15 @@ export enum InterestRunTrigger {
   Spawn = 'spawn',
   Command = 'command',
   Scheduled = 'scheduled',
+  Onboarding = 'onboarding',
 }
 
 export type UserInterest = {
   id: string;
   query: string;
   title?: string | null;
+  brief?: string | null;
+  onboardingStep?: UserInterestOnboardingStep | null;
   status: UserInterestStatus;
   cadence: UserInterestCadence;
   fomoThreshold: number;
@@ -94,10 +104,23 @@ export type InterestFinding = {
   post?: Post | null;
 };
 
+export type InterestQuestionChoice = { value: string; label: string };
+
 export type InterestRunBlock =
   | { type: 'text'; html: string }
   | { type: 'picks'; caption?: string; postIds: string[] }
-  | { type: 'feedLink'; label: string; count: number; postIds?: string[] };
+  | { type: 'feedLink'; label: string; count: number; postIds?: string[] }
+  | {
+      type: 'question';
+      questionId: string;
+      html: string;
+      input: 'chips' | 'text';
+      multi?: boolean;
+      choices?: InterestQuestionChoice[];
+      selected?: string[];
+    }
+  | { type: 'brief'; html: string; brief: string }
+  | { type: 'review' };
 
 export type InterestTurnRelationship = {
   id: string;
@@ -129,6 +152,8 @@ const USER_INTEREST_FRAGMENT = `
     id
     query
     title
+    brief
+    onboardingStep
     status
     cadence
     fomoThreshold
@@ -182,8 +207,8 @@ export const INTEREST_FINDINGS_QUERY = `
 `;
 
 export const CREATE_INTEREST_MUTATION = `
-  mutation CreateInterest($query: String!, $settings: CreateInterestSettingsInput) {
-    createInterest(query: $query, settings: $settings) {
+  mutation CreateInterest($query: String!, $settings: CreateInterestSettingsInput, $onboarding: Boolean) {
+    createInterest(query: $query, settings: $settings, onboarding: $onboarding) {
       ...UserInterestFragment
     }
   }
@@ -191,13 +216,31 @@ export const CREATE_INTEREST_MUTATION = `
 `;
 
 export const SEND_INTEREST_COMMAND_MUTATION = `
-  mutation SendInterestCommand($id: ID!, $text: String!, $triggerRun: Boolean) {
-    sendInterestCommand(id: $id, text: $text, triggerRun: $triggerRun) {
+  mutation SendInterestCommand($id: ID!, $text: String!, $triggerRun: Boolean, $questionId: String) {
+    sendInterestCommand(id: $id, text: $text, triggerRun: $triggerRun, questionId: $questionId) {
       id
     }
   }
 `;
 
+export const CONFIRM_INTEREST_BRIEF_MUTATION = `
+  mutation ConfirmInterestBrief($id: ID!, $brief: String) {
+    confirmInterestBrief(id: $id, brief: $brief) {
+      ...UserInterestFragment
+    }
+  }
+  ${USER_INTEREST_FRAGMENT}
+`;
+
+export const COMPLETE_INTEREST_ONBOARDING_MUTATION = `
+  mutation CompleteInterestOnboarding($id: ID!) {
+    completeInterestOnboarding(id: $id) {
+      ...UserInterestFragment
+    }
+  }
+  ${USER_INTEREST_FRAGMENT}
+`;
+
 export const INTEREST_HISTORY_QUERY = `
   query InterestHistory(
     $id: ID!
@@ -311,29 +354,56 @@ export const getInterestFindings = async (
 export const createInterest = async ({
   query,
   settings,
+  onboarding,
 }: {
   query: string;
   settings?: CreateInterestSettings;
+  onboarding?: boolean;
 }): Promise<UserInterest> => {
   const res = await gqlClient.request<{ createInterest: UserInterest }>(
     CREATE_INTEREST_MUTATION,
-    { query, settings },
+    { query, settings, onboarding },
   );
   return res.createInterest;
 };
 
+export const confirmInterestBrief = async ({
+  id,
+  brief,
+}: {
+  id: string;
+  brief?: string;
+}): Promise<UserInterest> => {
+  const res = await gqlClient.request<{ confirmInterestBrief: UserInterest }>(
+    CONFIRM_INTEREST_BRIEF_MUTATION,
+    { id, brief },
+  );
+  return res.confirmInterestBrief;
+};
+
+export const completeInterestOnboarding = async (
+  id: string,
+): Promise<UserInterest> => {
+  const res = await gqlClient.request<{
+    completeInterestOnboarding: UserInterest;
+  }>(COMPLETE_INTEREST_ONBOARDING_MUTATION, { id });
+  return res.completeInterestOnboarding;
+};
+
 export const sendInterestCommand = async ({
   id,
   text,
   triggerRun,
+  questionId,
 }: {
   id: string;
   text: string;
   triggerRun?: boolean;
+  questionId?: string;
 }): Promise<Pick<UserInterest, 'id'>> => {
   const res = await gqlClient.request<{
     sendInterestCommand: Pick<UserInterest, 'id'>;
-  }>(SEND_INTEREST_COMMAND_MUTATION, { id, text, triggerRun });
+  }>(SEND_INTEREST_COMMAND_MUTATION, { id, text, triggerRun, questionId });
   return res.sendInterestCommand;
 };