[{"data":1,"prerenderedAt":1126},["ShallowReactive",2],{"manual-navigation":3,"page-\u002Fdevelopers\u002Fheadless":363},[4,48,108,131,205,264,307,328],{"title":5,"description":6,"icon":7,"status":8,"path":9,"stem":10,"children":11,"page":47},"Start here","Install Arx, bring your tabs over, learn the keys.","raycast:bolt","draft","\u002Fstart","1.start",[12,17,23,29,35,41],{"title":13,"path":14,"stem":15,"description":16,"icon":7,"status":8},"Getting started","\u002Fstart\u002Fgetting-started","1.start\u002F1.getting-started","What Arx is, what it runs on, and the four keys that do most of the work.",{"title":18,"path":19,"stem":20,"description":21,"icon":22,"status":8},"Bring in from another browser","\u002Fstart\u002Fbring-in","1.start\u002F2.bring-in","Move your profiles, spaces, pinned tabs, history and passwords from Arc, Chrome, Dia, Firefox, Zen, Safari and other browsers, or from a bookmarks file.","raycast:download",{"title":24,"path":25,"stem":26,"description":27,"icon":28,"status":8},"Export and import","\u002Fstart\u002Fexport-import","1.start\u002F3.export-import","Save your whole Arx setup to one file, or your tabs as bookmarks, and bring them into Arx on another Mac. Free, offline, no account.","raycast:arrow-clockwise",{"title":30,"path":31,"stem":32,"description":33,"icon":34,"status":8},"Keyboard shortcuts","\u002Fstart\u002Fkeyboard-shortcuts","1.start\u002F4.keyboard-shortcuts","Every default key in Arx, the commands you can bind yourself, and how to change any of them.","raycast:keyboard",{"title":36,"path":37,"stem":38,"description":39,"icon":40,"status":8},"Settings","\u002Fstart\u002Fsettings","1.start\u002F5.settings","What's in each Settings pane, and how appearance works per profile and per space.","raycast:switch",{"title":42,"path":43,"stem":44,"description":45,"icon":28,"status":46},"Updates","\u002Fstart\u002Fupdates","1.start\u002F6.updates","How Arx updates itself, the Stable and Beta channels, and What's New after an update.","ready",false,{"title":49,"description":50,"icon":51,"status":8,"path":52,"stem":53,"children":54,"page":47},"Tabs and windows","The sidebar, spaces, Peek, Split View and Little Arx.","raycast:app-window-sidebar-left","\u002Ftabs","2.tabs",[55,60,66,72,78,84,90,96,102],{"title":56,"path":57,"stem":58,"description":59,"icon":51,"status":8},"The sidebar","\u002Ftabs\u002Fsidebar","2.tabs\u002F1.sidebar","Tabs that stay where you put them. Favorites at the top, then pinned tabs and folders, then everything else.",{"title":61,"path":62,"stem":63,"description":64,"icon":65,"status":8},"Spaces","\u002Ftabs\u002Fspaces","2.tabs\u002F2.spaces","One space for each part of your day. Each keeps its own pinned tabs and open tabs, with its own icon and appearance.","raycast:layers",{"title":67,"path":68,"stem":69,"description":70,"icon":71,"status":8},"Peek","\u002Ftabs\u002Fpeek","2.tabs\u002F3.peek","Look at a link without losing your place. Shift-click or Force Click it, and it opens in a card over the page.","raycast:eye",{"title":73,"path":74,"stem":75,"description":76,"icon":77,"status":8},"Split View","\u002Ftabs\u002Fsplit-view","2.tabs\u002F4.split-view","Up to four pages in one window, side by side or stacked. A split is one row in the sidebar, in the open tabs, Pinned or a folder.","raycast:app-window-grid-2x2",{"title":79,"path":80,"stem":81,"description":82,"icon":83,"status":8},"Little Arx","\u002Ftabs\u002Flittle-arx","2.tabs\u002F5.little-arx","Quick links get a small window that doesn't touch your spaces. Read and close it, or move it into a space with ⌘O.","raycast:app-window",{"title":85,"path":86,"stem":87,"description":88,"icon":89,"status":8},"Gestures","\u002Ftabs\u002Fgestures","2.tabs\u002F6.gestures","Swipe back and forward, and keep swiping to pick any page from your history.","raycast:arrow-left",{"title":91,"path":92,"stem":93,"description":94,"icon":95,"status":8},"Tab Archive","\u002Ftabs\u002Farchive","2.tabs\u002F7.archive","Closed tabs go to the archive, searchable per profile, so you can close freely and bring anything back.","raycast:clock",{"title":97,"path":98,"stem":99,"description":100,"icon":101,"status":8},"Private windows","\u002Ftabs\u002Fprivate-windows","2.tabs\u002F8.private-windows","[object Object]","raycast:eye-disabled",{"title":103,"path":104,"stem":105,"description":106,"icon":107,"status":46},"History","\u002Ftabs\u002Fhistory","2.tabs\u002F9.history","Every page you visited in a profile, by day, with a search, in the Library. Open any of them again or delete what you don't want kept.","raycast:rotate-anti-clockwise",{"title":109,"description":110,"icon":111,"status":8,"path":112,"stem":113,"children":114,"page":47},"The command bar","One field for tabs, history, commands and the web.","raycast:command-symbol","\u002Fcommand-bar","3.command-bar",[115,119,125],{"title":109,"path":116,"stem":117,"description":118,"icon":111,"status":8},"\u002Fcommand-bar\u002Fcommand-bar","3.command-bar\u002F1.command-bar","Type what you want. Arx finds it. One field for open tabs, history, spaces, folders, commands, settings and the web.",{"title":120,"path":121,"stem":122,"description":123,"icon":124,"status":8},"Search and bangs","\u002Fcommand-bar\u002Fsearch-and-bangs","3.command-bar\u002F2.search-and-bangs","A search engine per profile, your own search shortcuts, and over 13,000 bangs that work offline.","raycast:magnifying-glass",{"title":126,"path":127,"stem":128,"description":129,"icon":130,"status":46},"Chat with the assistant","\u002Fcommand-bar\u002Fchat","3.command-bar\u002F3.chat","Type a question in the command bar and press Tab. Arx's assistant answers in a panel beside the page, on your own Claude or ChatGPT sign-in.","raycast:speech-bubble",{"title":132,"description":133,"icon":83,"status":8,"path":134,"stem":135,"children":136,"page":47},"Pages and media","Find in page, page capture, Picture in Picture, downloads and private windows.","\u002Fpages","4.pages",[137,142,148,154,159,165,170,176,181,187,193,199],{"title":138,"path":139,"stem":140,"description":141,"icon":124,"status":8},"Find in page","\u002Fpages\u002Ffind-in-page","4.pages\u002F01.find-in-page","Find text on the page you're reading with ⌘F, and step through the matches.",{"title":143,"path":144,"stem":145,"description":146,"icon":147,"status":8},"Capture a page","\u002Fpages\u002Fcapture","4.pages\u002F02.capture","Capture a block of the page, an area you draw, what's on screen or the whole page, right on the page.","raycast:camera",{"title":149,"path":150,"stem":151,"description":152,"icon":153,"status":8},"Media and Picture in Picture","\u002Fpages\u002Fmedia","4.pages\u002F03.media","Control audio and video from any tab, watch a page full screen, float a video in ArxPiP while you work, and cast to a TV.","raycast:play",{"title":155,"path":156,"stem":157,"description":158,"icon":22,"status":8},"Downloads","\u002Fpages\u002Fdownloads","4.pages\u002F04.downloads","Everything you download, per profile, with search, pause and resume, cancel, Copy Link and Show in Finder.",{"title":160,"path":161,"stem":162,"description":163,"icon":164,"status":46},"Site menu","\u002Fpages\u002Fsite-menu","4.pages\u002F05.site-menu","Share or capture the page, see the profile's extensions, change what the site may use, and clear its cookies or cache, from the button in the address bar.","raycast:lock",{"title":166,"path":167,"stem":168,"description":169,"icon":124,"status":46},"Zoom","\u002Fpages\u002Fzoom","4.pages\u002F06.zoom","Make a page bigger or smaller with ⌘+ and ⌘−, and go back to its normal size with ⌘0.",{"title":171,"path":172,"stem":173,"description":174,"icon":175,"status":46},"Content blocking","\u002Fpages\u002Fcontent-blocking","4.pages\u002F07.content-blocking","Arx blocks ads and trackers with uBlock Origin, built in. Turn it off for a site, block cookie banners, hide any element on a site, and pick filter lists.","raycast:shield-01",{"title":177,"path":178,"stem":179,"description":180,"icon":153,"status":46},"Netflix, Spotify and protected video","\u002Fpages\u002Fprotected-video","4.pages\u002F08.protected-video","Streaming services that protect their video and music play in WebKit pages, as in Safari, with your sign-in.",{"title":182,"path":183,"stem":184,"description":185,"icon":186,"status":46},"USB, Bluetooth and serial devices","\u002Fpages\u002Fdevices","4.pages\u002F09.devices","Let a site use a USB, HID, serial or Bluetooth device, such as a firmware flasher, a security key's setup page or an Arduino tool.","raycast:plug",{"title":188,"path":189,"stem":190,"description":191,"icon":192,"status":46},"Translate a page","\u002Fpages\u002Ftranslate","4.pages\u002F10.translate","Translate a page in place on your Mac with Apple's Translation, and keep translating as you scroll.","raycast:globe-01",{"title":194,"path":195,"stem":196,"description":197,"icon":198,"status":46},"Reading mode","\u002Fpages\u002Freading-mode","4.pages\u002F11.reading-mode","Read a page's article on its own, in a theme, size and width that suit you, and close it back to the page just as you left it.","raycast:paragraph",{"title":200,"path":201,"stem":202,"description":203,"icon":204,"status":46},"When a page stops or crashes","\u002Fpages\u002Ffrozen-pages","4.pages\u002F12.frozen-pages","What Arx does when a page's own script keeps it busy, why a page that stopped says what it says, and pages that keep crashing.","raycast:hourglass",{"title":206,"description":207,"icon":208,"status":8,"path":209,"stem":210,"children":211,"page":47},"Profiles, links and sync","Keep work and life apart, route links from other apps, and move your setup between Macs.","raycast:person","\u002Fprofiles","5.profiles",[212,217,223,229,235,240,247,252,258],{"title":213,"path":214,"stem":215,"description":216,"icon":208,"status":8},"Profiles","\u002Fprofiles\u002Fprofiles","5.profiles\u002F1.profiles","Profiles that never mix. Each has its own cookies, history, extensions, Favorites and search engine.",{"title":218,"path":219,"stem":220,"description":221,"icon":222,"status":8},"Air Traffic Control","\u002Fprofiles\u002Fair-traffic-control","5.profiles\u002F2.air-traffic-control","Routes for links that open from other apps, and App Links for a page's links to apps. Match a domain, a path or a local port, then open it in a space and a main window or Little Arx.","raycast:airplane",{"title":224,"path":225,"stem":226,"description":227,"icon":228,"status":8},"Copy, clean and proxy links","\u002Fprofiles\u002Flinks","5.profiles\u002F3.links","Copy a page's link as it is, without trackers, as Markdown, or through a Proxy Link rule that makes it preview well elsewhere.","raycast:link",{"title":230,"path":231,"stem":232,"description":233,"icon":234,"status":46},"Passwords","\u002Fprofiles\u002Fpasswords","5.profiles\u002F4.passwords","Arx saves the passwords you sign in with, separately for each profile, fills them when you pick an account, and lets you manage and import them in Settings.","raycast:key",{"title":236,"path":237,"stem":238,"description":239,"icon":186,"status":8},"Extensions","\u002Fprofiles\u002Fextensions","5.profiles\u002F5.extensions","Chrome extensions, per profile. Install them from the Chrome Web Store or a package, and what isn't supported yet.",{"title":241,"path":242,"stem":243,"description":244,"icon":245,"status":246},"Sync","\u002Fprofiles\u002Fsync","5.profiles\u002F6.sync","The same Arx on every Mac, through your own iCloud account. Planned for before 1.0.",null,"planned",{"title":248,"path":249,"stem":250,"description":251,"icon":175,"status":46},"Site settings","\u002Fprofiles\u002Fsite-settings","5.profiles\u002F7.site-settings","What each site may use (camera, microphone, location, notifications, pop-ups and the clipboard) and how far its pages are zoomed, separately for each profile.",{"title":253,"path":254,"stem":255,"description":256,"icon":257,"status":46},"Clear browsing data","\u002Fprofiles\u002Fclear-browsing-data","5.profiles\u002F8.clear-browsing-data","Remove a profile's history, download list, cookies, cache, autofill and site settings, from the last hour or all time, and see how much there is first.","raycast:trash",{"title":259,"path":260,"stem":261,"description":262,"icon":263,"status":46},"Addresses and cards","\u002Fprofiles\u002Faddresses-and-cards","5.profiles\u002F9.addresses-and-cards","Arx fills saved addresses and payment cards into checkout forms, separately for each profile, and asks for Touch ID before it fills a card.","raycast:credit-card",{"title":265,"description":100,"icon":245,"status":8,"path":266,"stem":267,"children":268,"page":47},"Assistants and MCP","\u002Fassistants","6.assistants",[269,274,279,284,290,296,301],{"title":270,"path":271,"stem":272,"description":273,"icon":245,"status":8},"Connect an assistant","\u002Fassistants\u002Fconnect","6.assistants\u002F1.connect","Arx has a local MCP server built in. Turn it on, connect Claude Code, Codex or Cursor with one command, then grant what it may see.",{"title":275,"path":276,"stem":277,"description":278,"icon":245,"status":8},"Grants and approvals","\u002Fassistants\u002Fgrants","6.assistants\u002F2.grants","Grant by capability, not all or nothing. Choose the context, the access classes and when Arx asks before a change.",{"title":280,"path":281,"stem":282,"description":283,"icon":245,"status":8},"Sign-ins stay with you","\u002Fassistants\u002Fsign-ins","6.assistants\u002F3.sign-ins","When a site needs you to sign in, the assistant hands the page to you. Every assistant pauses, and none of them sees what you type.",{"title":285,"path":286,"stem":287,"description":288,"icon":289,"status":8},"Working with pages","\u002Fassistants\u002Fworking-with-pages","6.assistants\u002F4.working-with-pages","For agent authors. How IDs, revisions, snapshots and references fit together, what results mean, and the errors to expect.","raycast:terminal",{"title":291,"path":292,"stem":293,"description":294,"icon":295,"status":8},"MCP tool reference","\u002Fassistants\u002Ftools","6.assistants\u002F5.tools","Every tool Arx's MCP server offers, the access classes it needs, and its main parameters.","raycast:code",{"title":297,"path":298,"stem":299,"description":300,"icon":245,"status":8},"Resources and notifications","\u002Fassistants\u002Fresources","6.assistants\u002F6.resources","MCP resources for granted tabs, page snapshots, downloads and browser events, and subscriptions that follow them.",{"title":302,"path":303,"stem":304,"description":305,"icon":306,"status":8},"The Arx browser skill","\u002Fassistants\u002Fskill","6.assistants\u002F7.skill","A guide for agents on working with Arx efficiently. arx setup installs it for Claude Code and Codex; other clients get a short version from the server.","raycast:book",{"title":308,"description":309,"icon":289,"status":8,"path":310,"stem":311,"children":312,"page":47},"Developers","DevTools, localhost, unpacked extensions and headless runs.","\u002Fdevelopers","7.developers",[313,318,323],{"title":314,"path":315,"stem":316,"description":317,"icon":245,"status":8},"Developer mode","\u002Fdevelopers\u002Fdeveloper-mode","7.developers\u002F1.developer-mode","Turn on developer mode in Settings and Arx adds DevTools docked in the page, a developer header on local pages, Inspect Element and unpacked extensions, without weakening its security.",{"title":319,"path":320,"stem":321,"description":322,"icon":245,"status":8},"Headless runs","\u002Fdevelopers\u002Fheadless","7.developers\u002F2.headless","Run Arx without windows from scripts, agents and CI, with a local MCP endpoint and only the grants you pass.",{"title":324,"path":325,"stem":326,"description":327,"icon":245,"status":8},"Shortcuts, AppleScript and arx:\u002F\u002F links","\u002Fdevelopers\u002Fautomation","7.developers\u002F3.automation","Open pages in a space or profile, open Little Arx, switch spaces, list and show tabs from the Shortcuts app, AppleScript, Raycast and other apps.",{"title":329,"description":330,"icon":331,"status":8,"path":332,"stem":333,"children":334,"page":47},"Help","Where Arx stands today, and everything that's planned.","raycast:question-mark-circle","\u002Fhelp","8.help",[335,340,346,351,357],{"title":336,"path":337,"stem":338,"description":339,"icon":331,"status":8},"Where Arx stands","\u002Fhelp\u002Ffaq","8.help\u002F1.faq","Availability, open source, Arc, the engine, assistants and passwords.",{"title":341,"path":342,"stem":343,"description":344,"icon":345,"status":8},"What's planned","\u002Fhelp\u002Fplanned","8.help\u002F2.planned","Everything this manual marks as Planned, in one place, with where it stands.","raycast:calendar",{"title":347,"path":348,"stem":349,"description":350,"icon":164,"status":46},"Privacy and security","\u002Fhelp\u002Fprivacy","8.help\u002F3.privacy","What Arx downloads on its own to keep certificate checks current, how it guards the key to your passwords and cookies, how it blocks known phishing and malware sites, and what it keeps when it crashes.",{"title":352,"path":353,"stem":354,"description":355,"icon":356,"status":46},"Release notes","\u002Fhelp\u002Frelease-notes","8.help\u002F4.release-notes","What changed in each version of Arx, newest first.","raycast:blank-document",{"title":358,"path":359,"stem":360,"description":361,"icon":362,"status":46},"Crash reports and problem reports","\u002Fhelp\u002Fcrash-reports","8.help\u002F5.crash-reports","What Arx keeps when it crashes, and how Report a Problem opens a GitHub issue for the Arx team.","raycast:bug",{"id":364,"title":319,"body":365,"description":322,"extension":1121,"icon":245,"meta":1122,"navigation":1123,"path":320,"seo":1124,"status":8,"stem":321,"__hash__":1125},"docs\u002F7.developers\u002F2.headless.md",{"type":366,"value":367,"toc":1113},"minimark",[368,380,385,420,543,550,554,557,759,881,887,890,896,917,920,924,1015,1019,1022,1070,1076,1088,1092,1095,1104,1109],[369,370,371,375,376,379],"p",{},[372,373,374],"code",{},"Arx --headless"," starts the browser without windows, a Dock icon or a menu bar. It runs the same browser and the same local MCP server as the app, and gives its own MCP client only the grants you pass. Every run ends with a clean ",[372,377,378],{},"stopped"," event.",[381,382,384],"h2",{"id":383},"start-a-run","Start a run",[386,387,392],"pre",{"className":388,"code":389,"language":390,"meta":391,"style":391},"language-bash shiki shiki-themes github-dark-high-contrast github-light github-dark-high-contrast","\u002FApplications\u002FArx.app\u002FContents\u002FMacOS\u002FArx --headless --allow read,screenshots,content --viewport 1280x800\n","bash","",[372,393,394],{"__ignoreMap":391},[395,396,399,403,407,410,414,417],"span",{"class":397,"line":398},"line",1,[395,400,402],{"class":401},"sSs9L","\u002FApplications\u002FArx.app\u002FContents\u002FMacOS\u002FArx",[395,404,406],{"class":405},"s4Jlk"," --headless",[395,408,409],{"class":405}," --allow",[395,411,413],{"class":412},"svBkC"," read,screenshots,content",[395,415,416],{"class":405}," --viewport",[395,418,419],{"class":412}," 1280x800\n",[421,422,423,436],"table",{},[424,425,426],"thead",{},[427,428,429,433],"tr",{},[430,431,432],"th",{},"Option",[430,434,435],{},"Meaning",[437,438,439,478,488,501,515,529],"tbody",{},[427,440,441,447],{},[442,443,444],"td",{},[372,445,446],{},"--allow",[442,448,449,450,453,454,457,458,457,461,457,464,467,468,470,471,473,474,477],{},"Comma-separated grants for the run's MCP client: ",[372,451,452],{},"read"," (required), ",[372,455,456],{},"screenshots",", ",[372,459,460],{},"content",[372,462,463],{},"interaction",[372,465,466],{},"manage",". Default ",[372,469,452],{},". The client sees the run's whole profile: every space, including spaces added while it runs, and its Favorites. ",[372,472,466],{}," approves changes in advance for the whole run, or until ",[372,475,476],{},"--timeout",".",[427,479,480,485],{},[442,481,482],{},[372,483,484],{},"--profile \u003Cabsolute path>",[442,486,487],{},"Use and keep a persistent profile. By default each run gets a fresh private profile that is deleted at exit.",[427,489,490,495],{},[442,491,492],{},[372,493,494],{},"--viewport \u003CW>x\u003CH>",[442,496,497,498,477],{},"Page size in points, 320×240 to 3840×2160. Default 1280×800. Screenshots are this size times the run's ",[372,499,500],{},"deviceScale",[427,502,503,508],{},[442,504,505],{},[372,506,507],{},"--timeout \u003Cseconds>",[442,509,510,511,514],{},"Optional deadline, 10 to 86,400. The run exits with ",[372,512,513],{},"75"," when it's reached. Default: none.",[427,516,517,522],{},[442,518,519],{},[372,520,521],{},"--mcp-configuration \u003Cabsolute path>",[442,523,524,525,528],{},"Where to write the MCP client configuration. The file must not exist yet; it's created readable only by you. Default: ",[372,526,527],{},"mcp.json"," in the run's directory.",[427,530,531,536],{},[442,532,533],{},[372,534,535],{},"--url \u003Curl>",[442,537,538,539,542],{},"First page for a new profile: http(s) or ",[372,540,541],{},"about:blank"," (default).",[369,544,545,546,549],{},"Start your MCP client with the ",[372,547,548],{},"mcpServers.arx"," entry of that configuration file. It launches Arx's bundled helper with the run's one-time credential.",[381,551,553],{"id":552},"events","Events",[369,555,556],{},"Stdout carries only events, one JSON object per line:",[421,558,559,569],{},[424,560,561],{},[427,562,563,566],{},[430,564,565],{},"Event",[430,567,568],{},"Fields",[437,570,571,602,634,651,695,712,724,746],{},[427,572,573,577],{},[442,574,575],{},[372,576,46],{},[442,578,579,457,582,457,585,457,588,457,590,457,593,457,596,457,599],{},[372,580,581],{},"configuration",[372,583,584],{},"profile",[372,586,587],{},"viewport",[372,589,500],{},[372,591,592],{},"grants",[372,594,595],{},"grantsExpireAt",[372,597,598],{},"timeoutSeconds",[372,600,601],{},"pid",[427,603,604,609],{},[442,605,606],{},[372,607,608],{},"stopping",[442,610,611,614,615,457,618,457,621,457,624,457,627,630,631],{},[372,612,613],{},"reason",": ",[372,616,617],{},"signal",[372,619,620],{},"timeout",[372,622,623],{},"failure",[372,625,626],{},"parentExited",[372,628,629],{},"launcherExited"," or ",[372,632,633],{},"inputClosed",[427,635,636,641],{},[442,637,638],{},[372,639,640],{},"error",[442,642,643,457,645,457,648],{},[372,644,372],{},[372,646,647],{},"message",[372,649,650],{},"exitCode",[427,652,653,658],{},[442,654,655],{},[372,656,657],{},"diagnostic",[442,659,660,662,663,666,667,670,671,674,675,666,678,681,682,684,685,457,688,630,691,694],{},[372,661,372],{},", for example ",[372,664,665],{},"shutdownSlow"," (with ",[372,668,669],{},"seconds","), ",[372,672,673],{},"authenticationProtected",", or ",[372,676,677],{},"startupSlow",[372,679,680],{},"phase"," and ",[372,683,669],{},") when the run isn't ready after 30 or 90 seconds: ",[372,686,687],{},"engine",[372,689,690],{},"window",[372,692,693],{},"automation"," says what it's still waiting for",[427,696,697,702],{},[442,698,699],{},[372,700,701],{},"rendererFailed",[442,703,704,707,708,711],{},[372,705,706],{},"tabID"," of a page whose renderer died. A ",[372,709,710],{},"reload"," recovers it.",[427,713,714,719],{},[442,715,716],{},[372,717,718],{},"authenticationRequired",[442,720,721,723],{},[372,722,706],{}," of a page that hit an HTTP authentication challenge",[427,725,726,731],{},[442,727,728],{},[372,729,730],{},"userActionRequired",[442,732,733,681,735,738,739,457,742,745],{},[372,734,706],{},[372,736,737],{},"prompts"," (",[372,740,741],{},"webAuthentication",[372,743,744],{},"federatedSignIn",")",[427,747,748,752],{},[442,749,750],{},[372,751,378],{},[442,753,754,457,756],{},[372,755,650],{},[372,757,758],{},"suppressedDialogs",[386,760,764],{"className":761,"code":762,"language":763,"meta":391,"style":391},"language-json shiki shiki-themes github-dark-high-contrast github-light github-dark-high-contrast","{\"event\":\"ready\",\"grants\":[\"read\",\"screenshots\",\"content\"],\"viewport\":\"1280x800\", …}\n{\"event\":\"stopping\",\"reason\":\"signal\"}\n{\"event\":\"stopped\",\"exitCode\":0,\"suppressedDialogs\":0}\n","json",[372,765,766,824,848],{"__ignoreMap":391},[395,767,768,772,776,779,782,785,788,791,794,796,799,801,804,807,810,812,815,817,821],{"class":397,"line":398},[395,769,771],{"class":770},"s5K0b","{",[395,773,775],{"class":774},"s4JO3","\"event\"",[395,777,778],{"class":770},":",[395,780,781],{"class":412},"\"ready\"",[395,783,784],{"class":770},",",[395,786,787],{"class":774},"\"grants\"",[395,789,790],{"class":770},":[",[395,792,793],{"class":412},"\"read\"",[395,795,784],{"class":770},[395,797,798],{"class":412},"\"screenshots\"",[395,800,784],{"class":770},[395,802,803],{"class":412},"\"content\"",[395,805,806],{"class":770},"],",[395,808,809],{"class":774},"\"viewport\"",[395,811,778],{"class":770},[395,813,814],{"class":412},"\"1280x800\"",[395,816,457],{"class":770},[395,818,820],{"class":819},"sT0Hw","…",[395,822,823],{"class":770},"}\n",[395,825,827,829,831,833,836,838,841,843,846],{"class":397,"line":826},2,[395,828,771],{"class":770},[395,830,775],{"class":774},[395,832,778],{"class":770},[395,834,835],{"class":412},"\"stopping\"",[395,837,784],{"class":770},[395,839,840],{"class":774},"\"reason\"",[395,842,778],{"class":770},[395,844,845],{"class":412},"\"signal\"",[395,847,823],{"class":770},[395,849,851,853,855,857,860,862,865,867,870,872,875,877,879],{"class":397,"line":850},3,[395,852,771],{"class":770},[395,854,775],{"class":774},[395,856,778],{"class":770},[395,858,859],{"class":412},"\"stopped\"",[395,861,784],{"class":770},[395,863,864],{"class":774},"\"exitCode\"",[395,866,778],{"class":770},[395,868,869],{"class":405},"0",[395,871,784],{"class":770},[395,873,874],{"class":774},"\"suppressedDialogs\"",[395,876,778],{"class":770},[395,878,869],{"class":405},[395,880,823],{"class":770},[369,882,883,884,886],{},"Wait for ",[372,885,46],{}," before connecting. Diagnostics from Arx and Chromium go to stderr.",[381,888,889],{"id":608},"Stopping",[369,891,892,893,895],{},"Send SIGTERM or SIGINT. A run without ",[372,894,476],{}," also stops when:",[897,898,899,903,914],"ul",{},[900,901,902],"li",{},"the process that started it exits;",[900,904,905,906,909,910,913],{},"an outer launcher in a chain such as ",[372,907,908],{},"npx"," → ",[372,911,912],{},"node"," → Arx exits;",[900,915,916],{},"stdin was a pipe at startup and reaches end of file. Keep the pipe open for as long as the run should last.",[369,918,919],{},"However it stops, a run on a persistent profile saves its tabs and history first, so a tab opened just before the stop is there next time.",[381,921,923],{"id":922},"exit-codes","Exit codes",[421,925,926,935],{},[424,927,928],{},[427,929,930,933],{},[430,931,932],{},"Code",[430,934,435],{},[437,936,937,946,956,966,984,994,1005],{},[427,938,939,943],{},[442,940,941],{},[372,942,869],{},[442,944,945],{},"Stopped on request",[427,947,948,953],{},[442,949,950],{},[372,951,952],{},"64",[442,954,955],{},"Invalid options",[427,957,958,963],{},[442,959,960],{},[372,961,962],{},"69",[442,964,965],{},"Engine or MCP endpoint unavailable",[427,967,968,973],{},[442,969,970],{},[372,971,972],{},"70",[442,974,975,976,979,980,983],{},"Startup failure (",[372,977,978],{},"startupFailed","), including no logged-in session and a key Arx can't read from the Keychain (",[372,981,982],{},"ARX_SAFE_STORAGE_UNAVAILABLE"," on stderr)",[427,985,986,991],{},[442,987,988],{},[372,989,990],{},"73",[442,992,993],{},"Profile in use or can't be created",[427,995,996,1000],{},[442,997,998],{},[372,999,513],{},[442,1001,1002,1004],{},[372,1003,476],{}," reached",[427,1006,1007,1012],{},[442,1008,1009],{},[372,1010,1011],{},"2",[442,1013,1014],{},"Shutdown hung and was forced to exit",[381,1016,1018],{"id":1017},"nobody-is-watching","Nobody is watching",[369,1020,1021],{},"A headless run never waits for a person:",[897,1023,1024,1029,1042,1050,1057,1060,1067],{},[900,1025,1026,1027,477],{},"A change outside the run's grant fails with ",[372,1028,730],{},[900,1030,1031,1032,457,1035,681,1038,1041],{},"Page ",[372,1033,1034],{},"alert",[372,1036,1037],{},"confirm",[372,1039,1040],{},"prompt"," dialogs get Chromium's default answer, and permission requests are denied.",[900,1043,1044,1045,1049],{},"HTTP authentication, passkey and federated sign-in prompts are cancelled and reported as events. ",[1046,1047,1048],"a",{"href":281},"Sign-in handoffs"," aren't available.",[900,1051,1052,1053,1056],{},"Arx writes no screenshot files. ",[372,1054,1055],{},"browser_capture"," returns the image to the client.",[900,1058,1059],{},"Casting is off. Arx doesn't look for Chromecasts on the network, and a site's Cast button fails at once.",[900,1061,1062,1063,1066],{},"Background tabs can be frozen, as in Chrome: once a loaded tab falls outside the five most recently shown or opened, its timers and scripts stop until it's selected or loads again. Reading, capturing or waiting on it doesn't wake it, so select a tab (",[372,1064,1065],{},"selectTab",") before waiting for it to change.",[900,1068,1069],{},"Arx doesn't ask sites for missing tab icons, since nobody sees the sidebar.",[369,1071,1072,1073,477],{},"A persistent profile is locked for the run: a second run on it, or Arx already open on it, is rejected with ",[372,1074,1075],{},"profileInUse",[1077,1078,1079],"warning",{},[369,1080,1081,1082,1084,1085,1087],{},"macOS draws pages through the window server, so a headless run needs a logged-in graphical session for the same user. It doesn't work from a plain SSH login with nobody logged in, or from a launchd daemon, so CI needs a runner that is logged in. Arx checks for the session before it starts anything: without one it reports ",[372,1083,978],{},", says it needs a logged-in macOS session, and exits with ",[372,1086,972],{}," at once.",[381,1089,1091],{"id":1090},"macs-without-a-display","Macs without a display",[369,1093,1094],{},"A display is optional. A headless run works on a Mac mini with no monitor, a MacBook with its lid closed, or a Mac you reach only through Screen Sharing, as long as someone stays logged in. Start it from that session, for example from Terminal or an agent running there.",[369,1096,1097,1098,1100,1101,1103],{},"Arx renders pages at the main screen's scale, whether the screen is a real display or the one macOS or Screen Sharing provides, and at 2× when there's no screen at all. The scale is fixed when the run starts and reported as ",[372,1099,500],{}," in ",[372,1102,46],{},", so screenshots keep their size while a Screen Sharing session connects or ends.",[246,1105,1106],{},[369,1107,1108],{},"Headless runs without a logged-in graphical session, such as from SSH or launchd.",[1110,1111,1112],"style",{},"html pre.shiki code .sSs9L, html code.shiki .sSs9L{--shiki-default:#FFB757;--shiki-light:#6F42C1;--shiki-dark:#FFB757}html pre.shiki code .s4Jlk, html code.shiki .s4Jlk{--shiki-default:#91CBFF;--shiki-light:#005CC5;--shiki-dark:#91CBFF}html pre.shiki code .svBkC, html code.shiki .svBkC{--shiki-default:#ADDCFF;--shiki-light:#032F62;--shiki-dark:#ADDCFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s5K0b, html code.shiki .s5K0b{--shiki-default:#F0F3F6;--shiki-light:#24292E;--shiki-dark:#F0F3F6}html pre.shiki code .s4JO3, html code.shiki .s4JO3{--shiki-default:#72F088;--shiki-light:#005CC5;--shiki-dark:#72F088}html pre.shiki code .sT0Hw, html code.shiki .sT0Hw{--shiki-default:#FFB1AF;--shiki-default-font-style:italic;--shiki-light:#B31D28;--shiki-light-font-style:italic;--shiki-dark:#FFB1AF;--shiki-dark-font-style:italic}",{"title":391,"searchDepth":850,"depth":850,"links":1114},[1115,1116,1117,1118,1119,1120],{"id":383,"depth":826,"text":384},{"id":552,"depth":826,"text":553},{"id":608,"depth":826,"text":889},{"id":922,"depth":826,"text":923},{"id":1017,"depth":826,"text":1018},{"id":1090,"depth":826,"text":1091},"md",{},true,{"title":319,"description":322},"UV8vW31S2xNl5czu5YE7Ui0FIXp9l6e5EDo6_rzJqZE",1795007307169]