1"use strict";(globalThis.webpackChunk_atlas_docs_zen=globalThis.webpackChunk_atlas_docs_zen||[]).push([[1235],{4056(e,s,n){n.d(s,{R:()=>r,x:()=>l});var i=n(2155);const d={},t=i.createContext(d);function r(e){const s=i.useContext(t);return i.useMemo(function(){return"function"==typeof e?e(s):{...s,...e}},[s,e])}function l(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(d):e.components||d:r(e.components),i.createElement(t.Provider,{value:s},e.children)}},9966(e,s,n){n.r(s),n.d(s,{assets:()=>o,contentTitle:()=>l,default:()=>h,frontMatter:()=>r,metadata:()=>i,toc:()=>c});const i=JSON.parse('{"id":"integrations/windsurf","title":"Windsurf","description":"Use AddressZen inside Windsurf by pointing Cascade at our llms.txt context file.","source":"@site/docs/integrations/windsurf.mdx","sourceDirName":"integrations","slug":"/integrations/windsurf","permalink":"/docs/integrations/windsurf","draft":false,"unlisted":false,"tags":[],"version":"current","frontMatter":{"title":"Windsurf","sidebar_label":"Windsurf","description":"Use AddressZen inside Windsurf by pointing Cascade at our llms.txt context file."},"sidebar":"integrations","previous":{"title":"Codex","permalink":"/docs/integrations/codex"},"next":{"title":"GitHub Copilot","permalink":"/docs/integrations/github-copilot"}}');var d=n(5723),t=n(4056);const r={title:"Windsurf",sidebar_label:"Windsurf",description:"Use AddressZen inside Windsurf by pointing Cascade at our llms.txt context file."},l="Windsurf",o={},c=[{value:"Install",id:"install",level:2},{value:"Verify",id:"verify",level:2},{value:"API key",id:"api-key",level:2},{value:"Going deeper",id:"going-deeper",level:2},{value:"Need help?",id:"need-help",level:2}];function a(e){const s={a:"a",code:"code",h1:"h1",h2:"h2",header:"header",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,t.R)(),...e.components};return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)("img",{className:"page-icon",src:"/img/icons/integrations/windsurf.svg",alt:"",width:"64",height:"64"}),"\n",(0,d.jsx)(s.header,{children:(0,d.jsx)(s.h1,{id:"windsurf",children:"Windsurf"})}),"\n",(0,d.jsx)(s.p,{children:"Point Cascade at our full documentation as a single context file."}),"\n",(0,d.jsx)(s.h2,{id:"install",children:"Install"}),"\n",(0,d.jsxs)(s.p,{children:["Add ",(0,d.jsx)(s.code,{children:"llms.txt"})," as a context source in Windsurf:"]}),"\n",(0,d.jsxs)(s.ol,{children:["\n",(0,d.jsxs)(s.li,{children:["Open Windsurf settings \u2192 ",(0,d.jsx)(s.strong,{children:"Cascade"})," \u2192 ",(0,d.jsx)(s.strong,{children:"Context"}),"."]}),"\n",(0,d.jsxs)(s.li,{children:["Add a new URL context source: ",(0,d.jsx)(s.code,{children:"https://docs.addresszen.com/llms.txt"}),"."]}),"\n",(0,d.jsx)(s.li,{children:"Save. Cascade will pull the file on each session."}),"\n"]}),"\n",(0,d.jsxs)(s.p,{children:[(0,d.jsx)(s.code,{children:"llms.txt"})," is the full API reference, integration guides, and widget docs concatenated into one file, about the right size for a context source."]}),"\n",(0,d.jsx)(s.h2,{id:"verify",children:"Verify"}),"\n",(0,d.jsx)(s.p,{children:"In a fresh Cascade session:"}),"\n",(0,d.jsx)(s.pre,{children:(0,d.jsx)(s.code,{className:"language-text",children:"Add AddressZen Address Lookup to the shipping form.\n"})}),"\n",(0,d.jsxs)(s.p,{children:["The reply should reference ",(0,d.jsx)(s.code,{children:"@addresszen/address-lookup"})," and the ",(0,d.jsx)(s.code,{children:"AddressLookup.setup()"})," call."]}),"\n",(0,d.jsx)(s.h2,{id:"api-key",children:"API key"}),"\n",(0,d.jsxs)(s.ul,{children:["\n",(0,d.jsxs)(s.li,{children:["Quick test: ",(0,d.jsx)(s.code,{children:"ak_test"})," (capped at 5 lookups/day, public, breaks in production)."]}),"\n",(0,d.jsxs)(s.li,{children:["Real key: ",(0,d.jsx)(s.a,{href:"https://account.addresszen.com/users/sign_up",children:"sign up"})," for a free trial balance."]}),"\n",(0,d.jsxs)(s.li,{children:["Before deploy: restrict the key via ",(0,d.jsx)(s.a,{href:"/docs/guides/allowed-urls",children:"Allowed URLs"}),"."]}),"\n"]}),"\n",(0,d.jsx)(s.h2,{id:"going-deeper",children:"Going deeper"}),"\n",(0,d.jsxs)(s.ul,{children:["\n",(0,d.jsxs)(s.li,{children:["Per-page markdown: append ",(0,d.jsx)(s.code,{children:".md"})," to any docs URL (e.g. ",(0,d.jsx)(s.a,{href:"https://docs.addresszen.com/docs/address-lookup.md",children:(0,d.jsx)(s.code,{children:"/docs/address-lookup.md"})}),") when you want one specific page instead of the whole file."]}),"\n",(0,d.jsxs)(s.li,{children:["Full agent hub: ",(0,d.jsx)(s.a,{href:"/docs/guides/llms",children:"AI Assist"})]}),"\n"]}),"\n",(0,d.jsx)(s.h2,{id:"need-help",children:"Need help?"}),"\n",(0,d.jsxs)(s.ul,{children:["\n",(0,d.jsxs)(s.li,{children:["File an issue: ",(0,d.jsx)(s.a,{href:"https://github.com/addresszen/feedback/issues",children:"github.com/addresszen/feedback"})]}),"\n",(0,d.jsxs)(s.li,{children:["Email: ",(0,d.jsx)(s.a,{href:"mailto:[email protected]",children:"[email protected]"})]}),"\n"]})]})}function h(e={}){const{wrapper:s}={...(0,t.R)(),...e.components};return s?(0,d.jsx)(s,{...e,children:(0,d.jsx)(a,{...e})}):a(e)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.