1:"$Sreact.fragment"
2:I[39756,["/_next/static/chunks/3fntmmi971322.js"],"default"]
3:I[37457,["/_next/static/chunks/3fntmmi971322.js"],"default"]
4:I[59973,["/_next/static/chunks/3fntmmi971322.js","/_next/static/chunks/2v6icscw2u98x.js"],"SupportNavigation"]
6:I[97367,["/_next/static/chunks/3fntmmi971322.js"],"OutletBoundary"]
7:"$Sreact.suspense"
a:I[97367,["/_next/static/chunks/3fntmmi971322.js"],"ViewportBoundary"]
c:I[97367,["/_next/static/chunks/3fntmmi971322.js"],"MetadataBoundary"]
e:I[68027,["/_next/static/chunks/3fntmmi971322.js"],"default",1]
:HL["/_next/static/chunks/0uu3n70ekaa_q.css","style"]
:HL["/_next/static/chunks/0b-w4aydaoki1.css","style"]
9:X
0:{"P":null,"c":["","support","mac-app-preview",""],"q":"","i":false,"f":[[["",{"children":["support",{"children":[["slug","mac-app-preview","d",[]],{"children":["__PAGE__",{},"$undefined","$undefined",4608]},"$undefined","$undefined",4608]},"$undefined","$undefined",4608]},"$undefined","$undefined",4624],[["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/0uu3n70ekaa_q.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","script","script-0",{"src":"/_next/static/chunks/3fntmmi971322.js","async":true,"nonce":"$undefined"}]],["$","html",null,{"lang":"en","children":["$","body",null,{"children":["$","$L2",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L3",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":{"fontFamily":"system-ui,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif,\"Apple Color Emoji\",\"Segoe UI Emoji\"","height":"100vh","textAlign":"center","display":"flex","flexDirection":"column","alignItems":"center","justifyContent":"center"},"children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":{"display":"inline-block","margin":"0 20px 0 0","padding":"0 23px 0 0","fontSize":24,"fontWeight":500,"verticalAlign":"top","lineHeight":"49px"},"children":404}],["$","div",null,{"style":{"display":"inline-block"},"children":["$","h2",null,{"style":{"fontSize":14,"fontWeight":400,"lineHeight":"49px","margin":0},"children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}]}]]}],{"children":[["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/0b-w4aydaoki1.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","script","script-0",{"src":"/_next/static/chunks/2v6icscw2u98x.js","async":true,"nonce":"$undefined"}]],["$","div",null,{"className":"docs-shell","children":[["$","a",null,{"className":"docs-skip","href":"#support-content","children":"Skip to content"}],["$","header",null,{"className":"docs-header","children":[["$","a",null,{"href":"/support/","className":"docs-brand","aria-label":"Handsfree support home","children":[["$","span",null,{"children":["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":22,"height":22,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-audio-lines","aria-hidden":"true","children":[["$","path","1fnikh",{"d":"M2 10v3"}],["$","path","11sgs0",{"d":"M6 6v11"}],["$","path","yhl04a",{"d":"M10 3v18"}],["$","path","3a1oy3",{"d":"M14 8v7"}],["$","path","123xd1",{"d":"M18 5v13"}],["$","path","154ddg",{"d":"M22 10v3"}],"$undefined"]}]}],"handsfree",["$","span",null,{"className":"docs-brand-period","children":"."}],["$","i",null,{}],["$","small",null,{"children":"Support"}]]}],["$","a",null,{"href":"/","className":"docs-open-app","children":["Open Handsfree ",["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":16,"height":16,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-arrow-up-right","aria-hidden":"true","children":[["$","path","1tivn9",{"d":"M7 7h10v10"}],["$","path","1vkiza",{"d":"M7 17 17 7"}],"$undefined"]}]]}]]}],["$","div",null,{"className":"docs-layout","children":[["$","$L4",null,{}],["$","$L2",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L3",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],["$","footer",null,{"className":"docs-footer","children":[["$","span",null,{"children":["Handsfree support ",["$","span",null,{"aria-hidden":"true","children":"·"}]," Your computer. Your context."]}],["$","a",null,{"href":"/privacy/","children":"Privacy"}]]}]]}]]}],{"children":[["$","$1","c",{"children":[null,["$","$L2",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L3",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":[["$","$1","c",{"children":["$L5",[["$","script","script-0",{"src":"/_next/static/chunks/2bw5iof_b--vu.js","async":true,"nonce":"$undefined"}]],["$","$L6",null,{"children":["$","$7",null,{"name":"Next.MetadataOutlet","children":"$@8"}]}]]}],{},null,false,null]},null,false,"$9"]},null,false,null]},null,false,null],["$","$1","h",{"children":[null,["$","$La",null,{"children":"$Lb"}],["$","div",null,{"hidden":true,"children":["$","$Lc",null,{"children":["$","$7",null,{"name":"Next.Metadata","children":"$Ld"}]}]}],null]}],false]],"m":"$undefined","G":["$e",[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/0uu3n70ekaa_q.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]]],"S":true,"h":null,"r":"$undefined","s":"$undefined","a":"$undefined","l":"$undefined","p":"$undefined","d":"$undefined","b":"mtyNzNz9MUZ_ooV9pJSu1"}
9:C
5:["$","div",null,{"className":"docs-article-layout","children":[["$","main",null,{"id":"support-content","className":"docs-article","children":[["$","nav",null,{"className":"docs-breadcrumb","aria-label":"Breadcrumb","children":[["$","a",null,{"href":"/support/","children":"Support"}],["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":13,"height":13,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-chevron-right","aria-hidden":"true","children":[["$","path","mthhwq",{"d":"m9 18 6-6-6-6"}],"$undefined"]}],["$","span",null,{"children":"Start here"}]]}],["$","div",null,{"className":"docs-article-meta","children":[["$","span",null,{"children":"Start here"}],["$","span",null,{"children":[["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":13,"height":13,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-clock","aria-hidden":"true","children":[["$","circle","1mglay",{"cx":"12","cy":"12","r":"10"}],["$","path","mmk7yg",{"d":"M12 6v6l4 2"}],"$undefined"]}],8," min read"]}]]}],["$","h1",null,{"children":"Set up the Mac app preview"}],["$","p",null,{"className":"docs-article-description","children":"Account, private connection, agents, projects, and your iPhone—without cloning a repository."}],["$","details",null,{"className":"docs-mobile-toc","children":[["$","summary",null,{"children":"On this page"}],["$","nav",null,{"aria-label":"On this page","children":[["$","a","before-you-start",{"href":"#before-you-start","className":"","children":"Before you start"}],["$","a","open-handsfree-on-your-mac",{"href":"#open-handsfree-on-your-mac","className":"","children":"Open Handsfree on your Mac"}],["$","a","1-your-account",{"href":"#1-your-account","className":"","children":"1. Your account"}],["$","a","2-private-connection",{"href":"#2-private-connection","className":"","children":"2. Private connection"}],["$","a","3-coding-agents",{"href":"#3-coding-agents","className":"","children":"3. Coding agents"}],["$","a","4-your-projects",{"href":"#4-your-projects","className":"","children":"4. Your projects"}],["$","a","5-your-iphone",{"href":"#5-your-iphone","className":"","children":"5. Your iPhone"}],["$","a","after-setup",{"href":"#after-setup","className":"","children":"After setup"}]]}]]}],["$","div",null,{"className":"docs-prose","children":[["$","p","p-0",{"children":"This guide is for the Handsfree Mac app preview. It replaces the clone-a-repository setup for people receiving a packaged Mac build. The first preview supports Apple silicon Macs and Claude Code. Codex installation and sign-in are detected, but Codex phone execution is not enabled yet."}],"\n",["$","p","p-1",{"children":["Get the current signed, notarized Mac installer from ",["$","a","a-0",{"href":"/downloads/","children":"Handsfree downloads"}],". You do not need repository access or a source clone. The iPhone app still requires a TestFlight invitation from your beta administrator; there is no public iPhone invitation link."]}],"\n",["$","h2","h2-0",{"id":"before-you-start","children":["Before you start",["$","a",null,{"className":"docs-heading-link","href":"#before-you-start","aria-label":"Link to this section","children":"#"}]]}],"\n",["$","p","p-2",{"children":"You need your Mac, your iPhone, access to Claude Code, and Tailscale on both devices. Your Handsfree account, Tailscale account, and coding-agent account are separate. Handsfree never asks you to copy a provider API key into the app."}],"\n",["$","p","p-3",{"children":"For the smoothest first connection, keep your Mac plugged in with its lid open. You can leave the Handsfree window closed after setup; its menu-bar item keeps the host available."}],"\n",["$","h2","h2-1",{"id":"open-handsfree-on-your-mac","children":["Open Handsfree on your Mac",["$","a",null,{"className":"docs-heading-link","href":"#open-handsfree-on-your-mac","aria-label":"Link to this section","children":"#"}]]}],"\n",["$","p","p-4",{"children":"Download the Mac installer, open its disk image, drag Handsfree into Applications, and open Handsfree from Applications. The app includes its own runtime; you do not need Node, npm, a terminal server, or a source checkout."}],"\n","$Lf","\n","$L10","\n","$L11","\n","$L12","\n","$L13","\n","$L14","\n","$L15","\n","$L16","\n","$L17","\n","$L18","\n","$L19","\n","$L1a","\n","$L1b","\n","$L1c","\n","$L1d","\n","$L1e","\n","$L1f","\n","$L20","\n","$L21","\n","$L22","\n","$L23","\n","$L24","\n","$L25","\n","$L26","\n","$L27","\n","$L28","\n","$L29"]}],"$L2a"]}],"$L2b"]}]
f:["$","p","p-5",{"children":"If macOS blocks the build as unverified, ask the sender for a signed, notarized build. Do not disable macOS security protections. Artifacts labeled unsigned or developer-only are not coworker installers."}]
10:["$","h2","h2-2",{"id":"1-your-account","children":["1. Your account",["$","a",null,{"className":"docs-heading-link","href":"#1-your-account","aria-label":"Link to this section","children":"#"}]]}]
11:["$","p","p-6",{"children":["Use this same account when ",["$","a","a-0",{"href":"/support/iphone-accounts/","children":"signing in on your iPhone"}],". Mac 0.2 and newer require the updated account-enabled iPhone build and a fresh pairing; older build 14 did not include phone account sign-in."]}]
12:["$","p","p-7",{"children":["Choose ",["$","strong","strong-0",{"children":"Sign in or create account"}],". Your browser opens a Handsfree sign-in page powered by Clerk. Continue with Google or use your email address and verification code. Allow the Mac app to read your Handsfree profile and email, then return to the app."]}]
13:["$","p","p-8",{"children":["The account card should show ",["$","strong","strong-0",{"children":"Signed in"}],". We intentionally use Clerk’s development environment for this internal pilot. A development label and an ",["$","code","code-0",{"children":"accounts.dev"}]," sign-in address are expected; you do not need to configure Clerk or buy a domain. Use your real email or Google account, not a shared test account. Your provider logins stay separate and local."]}]
14:["$","p","p-9",{"children":"If you close the browser accidentally, choose Cancel in Handsfree and start sign-in again. Signing out of Handsfree stops the host but does not sign you out of your coding agents."}]
15:["$","h2","h2-3",{"id":"2-private-connection","children":["2. Private connection",["$","a",null,{"className":"docs-heading-link","href":"#2-private-connection","aria-label":"Link to this section","children":"#"}]]}]
16:["$","p","p-10",{"children":["Install ",["$","a","a-0",{"href":"https://tailscale.com/download/mac","children":"Tailscale for Mac"}],", open it, and sign in. Allow the VPN connection if macOS asks. Use the same Tailscale account on your iPhone, or your company’s designated tailnet."]}]
17:["$","p","p-11",{"children":["Back in Handsfree, choose ",["$","strong","strong-0",{"children":"Check again"}],", then ",["$","strong","strong-1",{"children":"Set up private connection"}],". If Tailscale opens an approval page, approve private HTTPS and return to Handsfree to retry. Leave public sharing, called Funnel, off."]}]
18:["$","p","p-12",{"children":"Handsfree adds a private address while preserving existing Tailscale services. It checks that address after you start the host. If your company requires device or HTTPS approval, ask its Tailscale administrator; Handsfree cannot bypass that approval."}]
19:["$","h2","h2-4",{"id":"3-coding-agents","children":["3. Coding agents",["$","a",null,{"className":"docs-heading-link","href":"#3-coding-agents","aria-label":"Link to this section","children":"#"}]]}]
1a:["$","p","p-13",{"children":["Handsfree checks whether Claude Code and Codex are installed and signed in. If Claude is missing, use its Install button and follow the provider’s instructions, then choose ",["$","strong","strong-0",{"children":"Check agent installations again"}],". If it is signed out, use ",["$","strong","strong-1",{"children":"Sign in"}],"."]}]
1b:["$","p","p-14",{"children":["Choose ",["$","strong","strong-0",{"children":"Test connection"}]," to send a tiny, no-tools test. This uses a small amount of your Claude allowance without accessing your projects. Then select ",["$","strong","strong-1",{"children":"Use in Handsfree"}]," and review the agent-access checkbox."]}]
1c:["$","p","p-15",{"children":"Enabled agents can edit files and run commands as you. Selecting projects is not a security sandbox: it selects where work starts. Only pair phones you trust."}]
1d:["$","h2","h2-5",{"id":"4-your-projects","children":["4. Your projects",["$","a",null,{"className":"docs-heading-link","href":"#4-your-projects","aria-label":"Link to this section","children":"#"}]]}]
1e:["$","p","p-16",{"children":["Choose ",["$","strong","strong-0",{"children":"Find my projects"}]," to search common development folders. Check the projects you want on your phone. Nothing is uploaded or selected automatically. You can select several projects, search another folder, or use ",["$","strong","strong-1",{"children":"Browse"}]," to add a folder without Git."]}]
1f:["$","p","p-17",{"children":["Choose ",["$","strong","strong-0",{"children":"Save projects"}],", or Continue to save your selection and move on. If a folder cannot be read, use Browse to select it directly. If macOS requests folder access, allow it only for the folders you intend to use."]}]
20:["$","h2","h2-6",{"id":"5-your-iphone","children":["5. Your iPhone",["$","a",null,{"className":"docs-heading-link","href":"#5-your-iphone","aria-label":"Link to this section","children":"#"}]]}]
21:["$","p","p-18",{"children":["Install Apple’s ",["$","a","a-0",{"href":"https://apps.apple.com/app/testflight/id899247664","children":"TestFlight app"}],", then open the Handsfree invitation supplied by your beta administrator. A Handsfree account alone does not grant TestFlight access. There is no public invitation link in this preview."]}]
22:["$","p","p-19",{"children":["Install ",["$","a","a-0",{"href":"https://tailscale.com/download/ios","children":"Tailscale for iPhone"}]," and connect it to the same private network as your Mac."]}]
23:["$","p","p-20",{"children":["In the Mac wizard, choose ",["$","strong","strong-0",{"children":"Start host"}],", then ",["$","strong","strong-1",{"children":"Show connection code"}],". In Handsfree on your iPhone, choose ",["$","strong","strong-2",{"children":"Scan the QR shown on my computer"}]," and scan the displayed QR code. The code works once and expires after ten minutes. Get a fresh code if necessary."]}]
24:["$","p","p-21",{"children":["Once the Mac shows ",["$","strong","strong-0",{"children":"Your iPhone is connected"}],", start a conversation on the phone and type: “Reply with connection confirmed. Do not use tools.” Wait for the reply. Then try Start talking, allow microphone and speech access, and confirm you hear the response. The Mac separately checks that the phone connected and received a successful agent response."]}]
25:["$","h2","h2-7",{"id":"after-setup","children":["After setup",["$","a",null,{"className":"docs-heading-link","href":"#after-setup","aria-label":"Link to this section","children":"#"}]]}]
26:["$","p","p-22",{"children":"Keep Handsfree running in the menu bar and keep Tailscale connected. Closing the window is fine; quitting Handsfree stops the host. The keep-awake option does not wake a closed or powered-off Mac."}]
27:["$","p","p-23",{"children":"You can return to setup to change projects, stop the host, generate a new pairing code, or disconnect a paired device. Disconnecting a device prevents future access but does not cancel work it already submitted."}]
28:["$","p","p-24",{"children":["For help, use ",["$","strong","strong-0",{"children":"Copy safe diagnostics"}],". It includes app and provider versions and connection status, not credentials, project names, or conversations. Do not share your QR code or pairing code in a support message."]}]
29:["$","p","p-25",{"children":["Stuck on a step? Open ",["$","a","a-0",{"href":"/support/mac-setup-help/","children":"Mac setup troubleshooting"}],". Once connected, follow ",["$","a","a-1",{"href":"/support/first-conversation/","children":"Your first conversation"}],"."]}]
2a:["$","nav",null,{"className":"docs-pagination","aria-label":"Article navigation","children":[["$","a",null,{"href":"/support/iphone-accounts/","children":[["$","small",null,{"children":[["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":13,"height":13,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-arrow-left","aria-hidden":"true","children":[["$","path","1l729n",{"d":"m12 19-7-7 7-7"}],["$","path","x3x0zl",{"d":"M19 12H5"}],"$undefined"]}]," Previous article"]}],["$","strong",null,{"children":"Sign in on your iPhone"}]]}],["$","a",null,{"href":"/support/mac-setup-help/","className":"docs-next","children":[["$","small",null,{"children":["Next article ",["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":13,"height":13,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-arrow-right","aria-hidden":"true","children":[["$","path","1ays0h",{"d":"M5 12h14"}],["$","path","xquz4c",{"d":"m12 5 7 7-7 7"}],"$undefined"]}]]}],["$","strong",null,{"children":"Mac setup troubleshooting"}]]}]]}]
2b:["$","aside",null,{"className":"docs-toc","children":[["$","p",null,{"children":"On this page"}],"$5:props:children:0:props:children:4:props:children:1"]}]
b:[["$","meta","0",{"charSet":"utf-8"}],["$","meta","1",{"name":"viewport","content":"width=device-width, initial-scale=1, viewport-fit=cover"}],["$","meta","2",{"name":"theme-color","content":"#f7f8f5"}]]
2c:I[27201,["/_next/static/chunks/3fntmmi971322.js"],"IconMark"]
8:null
d:[["$","title","0",{"children":"Set up the Mac app preview · Handsfree support"}],["$","meta","1",{"name":"description","content":"Account, private connection, agents, projects, and your iPhone—without cloning a repository."}],["$","meta","2",{"name":"application-name","content":"Handsfree"}],["$","link","3",{"rel":"icon","href":"/icon.svg"}],["$","link","4",{"rel":"apple-touch-icon","href":"/icon.svg"}],["$","$L2c","5",{}]]
