Build and validate a replacement index, then atomically swap it into place while preserving the last good index on failure.
repair is the explicit recovery path for an index that cannot be updated or
read reliably. It performs the same transactional full rebuild as index --full.
smolbren repair [--vault <name>]
smolbren builds notes, edges, search indexes, and ontology metadata in a sibling
directory. It validates both Lance datasets before replacing the live directory.
Existing embeddings are preserved. If any note read, dataset write, search-index
build, or validation fails, the command reports the operation, paths involved,
and underlying storage error while leaving the previous index untouched.
If a process is interrupted between swap operations, the next index or repair
run restores the recovery backup before continuing.
Was this page helpful?
⌘I
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"smolbren","colors":{"primary":"#4462ec","light":"#9bacf4"},"favicon":"https://media.brand.dev/0c924c99-2045-460c-b1bc-1974f1f2ea23.png","navbar":{"primary":{"type":"github","href":"https://github.com/junaidrahim/smolbren"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"smolbren","hasAudioNarration":false,"actualSubdomain":"smolbren","customDomains":["smolbren.com"],"gitSource":{"type":"github","owner":"junaidrahim","repo":"smolbren","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a99be85d633508f667b849f","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"CLI Reference","count":15},{"language":"default","tag":"Commands","count":13},{"language":"default","tag":"Docs","count":12},{"language":"default","tag":"Core Concepts","count":4},{"language":"default","tag":"Guides","count":3},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Output \u0026 Errors","count":2},{"language":"default","tag":"Configuration","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"cli/repair","slug":"/cli/repair","pageMetadata":{"title":"smolbren repair — safely rebuild a damaged index","sidebarTitle":"repair","description":"Build and validate a replacement index, then atomically swap it into place while preserving the last good index on failure.","href":"/cli/repair"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Build and validate a replacement index, then atomically swap it into place while preserving the last good index on failure.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`repair`}),` is the explicit recovery path for an index that cannot be updated or\nread reliably. It performs the same transactional full rebuild as `,_jsx(_components.code,{children:`index --full`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`smolbren`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` repair`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [--vault `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`nam`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`]`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`smolbren builds notes, edges, search indexes, and ontology metadata in a sibling\ndirectory. It validates both Lance datasets before replacing the live directory.\nExisting embeddings are preserved. If any note read, dataset write, search-index\nbuild, or validation fails, the command reports the operation, paths involved,\nand underlying storage error while leaving the previous index untouched.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"repaired\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"stats\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"scanned\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1607`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"unchanged\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"added\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1607`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"updated\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"removed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"edges\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2412`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"unresolved_edges\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`92`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"duration_ms\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1843`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}}`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`If a process is interrupted between swap operations, the next `,_jsx(_components.code,{children:`index`}),` or `,_jsx(_components.code,{children:`repair`}),`\nrun restores the recovery backup before continuing.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"smolbren repair — safely rebuild a damaged index","sidebarTitle":"repair","description":"Build and validate a replacement index, then atomically swap it into place while preserving the last good index on failure.","href":"/cli/repair"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"smolbren","siteName":"smolbren","title":"smolbren repair — safely rebuild a damaged index - smolbren","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-07T13:31:44.729Z","originalFileLocation":"cli/repair.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Build and validate a replacement index, then atomically swap it into place while preserving the last good index on failure.\">\u003cmeta data-mint-head name=\"application-name\" content=\"smolbren\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://media.brand.dev/0c924c99-2045-460c-b1bc-1974f1f2ea23.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://media.brand.dev/0c924c99-2045-460c-b1bc-1974f1f2ea23.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://media.brand.dev/0c924c99-2045-460c-b1bc-1974f1f2ea23.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://media.brand.dev/0c924c99-2045-460c-b1bc-1974f1f2ea23.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"smolbren repair — safely rebuild a damaged index - smolbren\">\u003cmeta data-mint-head property=\"og:description\" content=\"Build and validate a replacement index, then atomically swap it into place while preserving the last good index on failure.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"smolbren\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://smolbren.com/cli/repair\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://smolbren.mintlify.site/_mintlify/api/og/v2?division=Commands\u0026amp;title=smolbren+repair+%E2%80%94+safely+rebuild+a+damaged+index\u0026amp;description=Build+and+validate+a+replacement+index%2C+then+atomically+swap+it+into+place+while+preserving+the+last+good+index+on+failure.\u0026amp;theme=836f7389f18051462ea1ee31\u0026amp;signature=f8b7e0bfdf47166b9c0d76c3c30d64875f4c360774e12a430aed2a08383e3090\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"smolbren repair — safely rebuild a damaged index - smolbren\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Build and validate a replacement index, then atomically swap it into place while preserving the last good index on failure.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://smolbren.mintlify.site/_mintlify/api/og/v2?division=Commands\u0026amp;title=smolbren+repair+%E2%80%94+safely+rebuild+a+damaged+index\u0026amp;description=Build+and+validate+a+replacement+index%2C+then+atomically+swap+it+into+place+while+preserving+the+last+good+index+on+failure.\u0026amp;theme=836f7389f18051462ea1ee31\u0026amp;signature=f8b7e0bfdf47166b9c0d76c3c30d64875f4c360774e12a430aed2a08383e3090\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/smolbren/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"smolbren\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4462ec\">\u003clink data-mint-head rel=\"canonical\" href=\"https://smolbren.com/cli/repair\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/cli/repair.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://smolbren.com/#organization\",\"name\":\"smolbren\",\"url\":\"https://smolbren.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://smolbren.com#website\",\"name\":\"smolbren\",\"url\":\"https://smolbren.com\",\"publisher\":{\"@id\":\"https://smolbren.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://smolbren.com/cli/repair#webpage\",\"url\":\"https://smolbren.com/cli/repair\",\"name\":\"smolbren repair — safely rebuild a damaged index\",\"description\":\"Build and validate a replacement index, then atomically swap it into place while preserving the last good index on failure.\",\"dateModified\":\"2026-08-07T13:31:44.729Z\",\"isPartOf\":{\"@id\":\"https://smolbren.com#website\"},\"breadcrumb\":{\"@id\":\"https://smolbren.com/cli/repair#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://smolbren.com/cli/repair#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Commands\",\"item\":\"https://smolbren.com/cli/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"smolbren repair — safely rebuild a damaged index\",\"item\":\"https://smolbren.com/cli/repair\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://smolbren.com/cli/repair#article\",\"headline\":\"smolbren repair — safely rebuild a damaged index\",\"name\":\"smolbren repair — safely rebuild a damaged index\",\"description\":\"Build and validate a replacement index, then atomically swap it into place while preserving the last good index on failure.\",\"url\":\"https://smolbren.com/cli/repair\",\"mainEntityOfPage\":{\"@id\":\"https://smolbren.com/cli/repair#webpage\"},\"dateModified\":\"2026-08-07T13:31:44.729Z\",\"publisher\":{\"@id\":\"https://smolbren.com/#organization\"},\"isPartOf\":{\"@id\":\"https://smolbren.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"smolbren\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"smolbren\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/cli/repair.md","siteName":"smolbren","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/introduction"}]},{"tab":"CLI Reference","groups":[{"group":"Commands","pages":[{"title":"smolbren CLI overview and global flags","sidebarTitle":"Overview","href":"/cli/overview"},{"title":"smolbren vault — manage your registered vaults","sidebarTitle":"vault","href":"/cli/vault"},{"title":"smolbren index — build and update the search index","sidebarTitle":"index","description":"Build or update the smolbren search index for a vault. Supports incremental updates by default; use --full for a complete rebuild.","href":"/cli/index"},{"title":"smolbren repair — safely rebuild a damaged index","sidebarTitle":"repair","href":"/cli/repair"},{"title":"smolbren embed — build vector embeddings for similarity search","sidebarTitle":"embed","description":"Chunk and embed note bodies with a local embedding model so similar and search --hybrid work. Incremental by default; --full re-embeds everything.","href":"/cli/embed"},{"title":"smolbren search — BM25 full-text search over your vault","sidebarTitle":"search","href":"/cli/search"},{"title":"smolbren similar — semantic similarity search over your vault","sidebarTitle":"similar","href":"/cli/similar"},{"title":"smolbren query — Cypher queries over the knowledge graph","sidebarTitle":"query","href":"/cli/query"},{"title":"smolbren get — fetch a single note by ID","sidebarTitle":"get","href":"/cli/get"},{"title":"smolbren links and backlinks — traverse graph edges","sidebarTitle":"links","href":"/cli/links"},{"title":"smolbren unresolved — enumerate dangling wikilinks","sidebarTitle":"unresolved","href":"/cli/unresolved"},{"title":"smolbren docs --agent — emit canonical agent instructions","sidebarTitle":"docs --agent","href":"/cli/docs"},{"title":"smolbren types and edges — inspect the vault ontology","sidebarTitle":"types","href":"/cli/types"}]},{"group":"Output \u0026 Errors","pages":[{"title":"smolbren output format: single-line JSON on stdout","sidebarTitle":"Output Format","href":"/cli/output-format"},{"title":"smolbren exit codes for shell scripting","sidebarTitle":"Exit Codes","href":"/cli/exit-codes"}]}]}]},"basePath":"","title":"smolbren repair — safely rebuild a damaged index - smolbren","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}