![\"Oversight\"](\"https://raw.githubusercontent.com/rachelslurs/storybook-oversight/main/assets/oversight-icon-128.png\"){kind=icon}
\n\n \n
\n See what your agent can and can't see.
\n Diagnoses silent failures in your Storybook MCP manifest.\n
\n ▶ Live demo\n
\n\nYour coding agent reads your components from the manifest Storybook's MCP server generates. When a description never reaches that manifest (extraction failed, the wrong docgen extractor ran, or the JSDoc is missing), the agent sees a component with no docs, and nothing tells you. Oversight lints the manifest per component while you work, so the gap surfaces on the component in front of you.\n\n\n\nBlog post: Your Agent Is Reading a Different Design System
\n\n## Requirements\n\n- **Storybook ^10.3** (React projects), and exactly one resolved copy of `@storybook/addon-docs` within that range. Two copies carry two theme contexts, so the Docs page renders blank with errors that name neither this addon nor the duplicate ([#93](https://github.com/rachelslurs/storybook-oversight/issues/93)). Mixing versions across the Storybook packages is the usual way to end up with two; from `0.6.1` the addon warns at startup when it detects it.\n- **React 18 or 19** in the consumer project. The addon's manager UI renders through Storybook's own React, so your app's React version is independent (needs `0.1.1+`; earlier versions crash the manager on React 19 projects).\n- The **components-manifest** feature enabled and served in dev. [`@storybook/addon-mcp`](https://www.npmjs.com/package/@storybook/addon-mcp) turns it on and serves `/manifests/components.json`, the manifest Oversight lints. Without it, the panel degrades to an \"unavailable\" state.\n- Storybook's experimental `experimentalDocgenServer` flag **disables the dev manifest by design**. From `0.5.0` the panel and the Docs block read Storybook's in-runtime service API in dev under that flag (needs Storybook `10.5+`), and resolve the ref-based (`v: 1`) manifest a build writes; earlier addon versions report the dev manifest unavailable and the built one unparseable. `oversight-lint` reads the built form as well.\n\n## Install\n\n```bash\nnpm install --save-dev storybook-addon-oversight\n# or: pnpm add -D storybook-addon-oversight\n```\n\nRegister it in `.storybook/main.ts` (alongside `@storybook/addon-mcp`):\n\n```ts\nconst config = {\n addons: ['@storybook/addon-mcp', 'storybook-addon-oversight'],\n};\nexport default config;\n```\n\nSet the extractor so JSDoc on components and props is actually extracted:\n\n```ts\n// .storybook/main.ts\nconst config = {\n typescript: { reactDocgen: 'react-docgen-typescript' },\n};\n```\n\nSet the same value as `expectedExtractor` (see [Configuration](#configuration)) so `extractor-drift` can flag a manifest built with a different extractor. The rule runs only when an expectation is configured.\n\nIf you enable `features.experimentalReactComponentMeta`, set `expectedExtractor` to `react-component-meta` instead. That flag chooses the extractor itself, so the manifest records `react-component-meta` and `typescript.reactDocgen` above is never read.\n\n`features.experimentalDocgenServer` records the same extractor, so `react-component-meta` is also the value to state under that flag: `expectedExtractor` for the panel and the Docs block, `--expected-extractor` on [`oversight-lint`](../cli/README.md) for the built manifest.\n\n### Optional: enable the Docs block\n\nRegister the global container in `.storybook/preview.ts` to render Oversight at the bottom of every component Docs page:\n\n```ts\nimport { OversightDocsContainer } from 'storybook-addon-oversight/blocks';\n\nconst preview = {\n parameters: { docs: { container: OversightDocsContainer } },\n};\nexport default preview;\n```\n\nUnattached MDX pages, such as an overview with no `of`, keep the plain Docs container without an Oversight block. Remove the container from `preview.ts` to disable the block globally.\n\nTo enable it on individual component MDX pages instead, place the block on each page:\n\n```mdx\nimport { Oversight } from 'storybook-addon-oversight/blocks';\n\n