Shape Cloud AI requires an official release. Local editing still works in any build. Contributors building from source can work without Cloud AI. See Troubleshooting.
Client may show cached usage for UX. Never the authority.
Client gate
Client may require sign-in before sending. Not the only check.
Server authoritative
Server allows or denies against real account state.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Shape","description":"The desktop coding agent. Works in your files.","colors":{"primary":"#3946FF","light":"#3946FF","dark":"#3946FF"},"logo":{"light":"https://mintcdn.com/shape-799cc160/80qpXzwWc9pazi4_/logo/light.svg?fit=max\u0026auto=format\u0026n=80qpXzwWc9pazi4_\u0026q=85\u0026s=3434585af97141ea1465cb56a4f8306a","dark":"https://mintcdn.com/shape-799cc160/80qpXzwWc9pazi4_/logo/dark.svg?fit=max\u0026auto=format\u0026n=80qpXzwWc9pazi4_\u0026q=85\u0026s=1b91545b16b60d56dc6d021ad85aad90","href":"https://useshape.org"},"favicon":"https://mintcdn.com/shape-799cc160/NYc9mFMGg6FzNgxz/logo/icon.svg?fit=max\u0026auto=format\u0026n=NYc9mFMGg6FzNgxz\u0026q=85\u0026s=c4c123a66e11f99cb1d4f1da10028be6","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://github.com/useshape/Shape","type":"github"}],"primary":{"type":"button","label":"Download","href":"https://useshape.org/download"}},"footer":{"socials":{"x":"https://x.com/useshape","github":"https://github.com/useshape/Shape","discord":"https://discord.com/invite/MMCEDVZKYf"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"shape-799cc160","hasAudioNarration":false,"actualSubdomain":"shape-799cc160","customDomains":["docs.useshape.org"],"gitSource":{"type":"github","owner":"useshape","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adfa73267aae62e51ac6327","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Docs","count":17},{"language":"default","tag":"Contributing","count":8},{"language":"default","tag":"Contribute","count":8},{"language":"default","tag":"Help","count":5},{"language":"default","tag":"Agent","count":4},{"language":"default","tag":"Plugins","count":3},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Git","count":2},{"language":"default","tag":"Changelog","count":1}]},"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":"llms-txt-v2","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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"developing/client-trust","slug":"/developing/client-trust","pageMetadata":{"title":"Client trust and usage","description":"Why Cloud AI is enforced on the server.","order":8,"icon":"ri-shield-check-line","href":"/developing/client-trust"},"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: \"Why Cloud AI is enforced on the server.\"\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={a:`a`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The desktop app runs on the user’s machine. Only the authenticated account on Shape Cloud decides whether an AI request is allowed.`}),`\n`,_jsx(Heading,{level:`2`,id:`official-builds`,children:`Official builds`}),`\n`,_jsxs(_components.p,{children:[`Shape Cloud AI requires an official release. Local editing still works in any build. Contributors building from source can work without Cloud AI. See `,_jsx(_components.a,{href:`/docs/help/troubleshooting`,children:`Troubleshooting`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`rules-of-thumb`,children:`Rules of thumb`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Kind`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Display`})}),_jsx(_components.td,{children:`Client may show cached usage for UX. Never the authority.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Client gate`})}),_jsx(_components.td,{children:`Client may require sign-in before sending. Not the only check.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Server authoritative`})}),_jsx(_components.td,{children:`Server allows or denies against real account state.`})]})]})]})]})}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":"Client trust and usage","description":"Why Cloud AI is enforced on the server.","order":8,"icon":"ri-shield-check-line","href":"/developing/client-trust"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Official builds","slug":"official-builds","depth":2,"children":[]},{"title":"Rules of thumb","slug":"rules-of-thumb","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"shape-799cc160","siteName":"Shape","title":"Client trust and usage - Shape","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-09T17:52:22.469Z","originalFileLocation":"developing/client-trust.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=\"dark\"}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=\"Why Cloud AI is enforced on the server.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Shape\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/shape-799cc160/kzquaJI50VNlerJQ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/shape-799cc160/kzquaJI50VNlerJQ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/shape-799cc160/kzquaJI50VNlerJQ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/shape-799cc160/kzquaJI50VNlerJQ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/shape-799cc160/kzquaJI50VNlerJQ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/shape-799cc160/kzquaJI50VNlerJQ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/shape-799cc160/kzquaJI50VNlerJQ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/shape-799cc160/kzquaJI50VNlerJQ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/shape-799cc160/kzquaJI50VNlerJQ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Client trust and usage - Shape\">\u003cmeta data-mint-head property=\"og:description\" content=\"Why Cloud AI is enforced on the server.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Shape\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.useshape.org/developing/client-trust\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://shape-799cc160.mintlify.site/_mintlify/api/og/v2?division=Contribute\u0026amp;title=Client+trust+and+usage\u0026amp;description=Why+Cloud+AI+is+enforced+on+the+server.\u0026amp;theme=43a998214c1fb64ed8c85c35\u0026amp;signature=fac7a3fbf85f7dfc742790d86b349b3a693ffb6471bf704e5e457e4731edf13e\">\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=\"Client trust and usage - Shape\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Why Cloud AI is enforced on the server.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://shape-799cc160.mintlify.site/_mintlify/api/og/v2?division=Contribute\u0026amp;title=Client+trust+and+usage\u0026amp;description=Why+Cloud+AI+is+enforced+on+the+server.\u0026amp;theme=43a998214c1fb64ed8c85c35\u0026amp;signature=fac7a3fbf85f7dfc742790d86b349b3a693ffb6471bf704e5e457e4731edf13e\">\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=\"/mintlify-assets/_mintlify/favicons/shape-799cc160/kzquaJI50VNlerJQ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Shape\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3946FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.useshape.org/developing/client-trust\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developing/client-trust.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.useshape.org/#organization\",\"name\":\"Shape\",\"url\":\"https://docs.useshape.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/shape-799cc160/80qpXzwWc9pazi4_/logo/light.svg?fit=max\u0026auto=format\u0026n=80qpXzwWc9pazi4_\u0026q=85\u0026s=3434585af97141ea1465cb56a4f8306a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.useshape.org#website\",\"name\":\"Shape\",\"url\":\"https://docs.useshape.org\",\"publisher\":{\"@id\":\"https://docs.useshape.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.useshape.org/developing/client-trust#webpage\",\"url\":\"https://docs.useshape.org/developing/client-trust\",\"name\":\"Client trust and usage\",\"description\":\"Why Cloud AI is enforced on the server.\",\"dateModified\":\"2026-10-09T17:52:22.469Z\",\"isPartOf\":{\"@id\":\"https://docs.useshape.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.useshape.org/developing/client-trust#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.useshape.org/developing/client-trust#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Contribute\",\"item\":\"https://docs.useshape.org/developing/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Client trust and usage\",\"item\":\"https://docs.useshape.org/developing/client-trust\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.useshape.org/developing/client-trust#article\",\"headline\":\"Client trust and usage\",\"name\":\"Client trust and usage\",\"description\":\"Why Cloud AI is enforced on the server.\",\"url\":\"https://docs.useshape.org/developing/client-trust\",\"mainEntityOfPage\":{\"@id\":\"https://docs.useshape.org/developing/client-trust#webpage\"},\"dateModified\":\"2026-10-09T17:52:22.469Z\",\"publisher\":{\"@id\":\"https://docs.useshape.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.useshape.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Shape\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Shape\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developing/client-trust.md","siteName":"Shape","nav":{"global":null,"tabs":[{"tab":"Docs","icon":"book-open","pages":[{"title":"Docs","href":""}]},{"tab":"Contributing","icon":"git-branch","groups":[{"group":"Contribute","pages":[{"title":"Overview","href":"/developing/overview"},{"title":"Architecture","icon":"ri-organization-chart","href":"/developing/architecture"},{"title":"Local development","href":"/developing/local-development"},{"title":"Agent tools","icon":"ri-robot-2-line","href":"/developing/agent-tools"},{"title":"Language servers","icon":"ri-lightbulb-line","href":"/developing/language-servers"},{"title":"Indexing and search","description":"Workspace search, outline, and how indexing feeds discovery features.","icon":"ri-search-line","href":"/developing/indexing-and-search"},{"title":"Client trust and usage","icon":"ri-shield-check-line","href":"/developing/client-trust"},{"title":"Tauri commands and IPC","description":"The boundary between the TypeScript frontend and Rust Tauri commands.","icon":"ri-exchange-line","href":"/developing/tauri-ipc"}]}]},{"tab":"Changelog","icon":"list","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Client trust and usage - Shape","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":[],"chunks":[]}