[{"data":1,"prerenderedAt":1193},["ShallowReactive",2],{"navigation_docs":3,"-troubleshooting-os-sandbox-refusals":639,"-troubleshooting-os-sandbox-refusals-surround":1188},[4,32,71,234,285,600],{"title":5,"path":6,"stem":7,"children":8},"Get started","\u002Fget-started","1.get-started",[9,12,16,20,24,28],{"title":10,"path":6,"stem":11},"Overview","1.get-started\u002Findex",{"title":13,"path":14,"stem":15},"Why Kraft","\u002Fget-started\u002Fwhy-kraft","1.get-started\u002F0.why-kraft",{"title":17,"path":18,"stem":19},"Install","\u002Fget-started\u002Finstall","1.get-started\u002F1.install",{"title":21,"path":22,"stem":23},"Your first work item","\u002Fget-started\u002Ffirst-work-item","1.get-started\u002F2.first-work-item",{"title":25,"path":26,"stem":27},"The real chain","\u002Fget-started\u002Fthe-real-chain","1.get-started\u002F3.the-real-chain",{"title":29,"path":30,"stem":31},"FAQ","\u002Fget-started\u002Ffaq","1.get-started\u002F4.faq",{"title":33,"path":34,"stem":35,"children":36},"Concepts","\u002Fconcepts","2.concepts",[37,39,43,47,51,55,59,63,67],{"title":10,"path":34,"stem":38},"2.concepts\u002Findex",{"title":40,"path":41,"stem":42},"How a work item runs","\u002Fconcepts\u002Fhow-a-work-item-runs","2.concepts\u002F1.how-a-work-item-runs",{"title":44,"path":45,"stem":46},"Caps and budgets","\u002Fconcepts\u002Fcaps-and-budgets","2.concepts\u002F2.caps-and-budgets",{"title":48,"path":49,"stem":50},"Why a permission gate","\u002Fconcepts\u002Fpermission-gate","2.concepts\u002F3.permission-gate",{"title":52,"path":53,"stem":54},"Vocabulary","\u002Fconcepts\u002Fvocabulary","2.concepts\u002F4.vocabulary",{"title":56,"path":57,"stem":58},"Where a step runs","\u002Fconcepts\u002Fwhere-a-step-runs","2.concepts\u002F5.where-a-step-runs",{"title":60,"path":61,"stem":62},"How review and CI waits settle","\u002Fconcepts\u002Fhow-review-and-ci-waits-settle","2.concepts\u002F6.how-review-and-ci-waits-settle",{"title":64,"path":65,"stem":66},"How test scopes run","\u002Fconcepts\u002Fhow-test-scopes-run","2.concepts\u002F7.how-test-scopes-run",{"title":68,"path":69,"stem":70},"How workers and machines behave","\u002Fconcepts\u002Fhow-workers-and-machines-behave","2.concepts\u002F8.how-workers-and-machines-behave",{"title":72,"path":73,"stem":74,"children":75},"Guides","\u002Fguides","3.guides",[76,78,120,146,168,230],{"title":10,"path":73,"stem":77},"3.guides\u002Findex",{"title":79,"path":80,"stem":81,"children":82},"Day to day","\u002Fguides\u002Fday-to-day","3.guides\u002F1.day-to-day\u002Findex",[83,84,88,92,96,100,104,108,112,116],{"title":10,"path":80,"stem":81},{"title":85,"path":86,"stem":87},"Split work into slices","\u002Fguides\u002Fday-to-day\u002Fsplit-work-into-slices","3.guides\u002F1.day-to-day\u002F1.split-work-into-slices",{"title":89,"path":90,"stem":91},"The setup wizard on first start","\u002Fguides\u002Fday-to-day\u002Ffirst-run","3.guides\u002F1.day-to-day\u002F2.first-run",{"title":93,"path":94,"stem":95},"File a work item","\u002Fguides\u002Fday-to-day\u002Ffile-a-work-item","3.guides\u002F1.day-to-day\u002F3.file-a-work-item",{"title":97,"path":98,"stem":99},"Use Kraft from your agent","\u002Fguides\u002Fday-to-day\u002Fagent-integration","3.guides\u002F1.day-to-day\u002F4.agent-integration",{"title":101,"path":102,"stem":103},"Reviewing a change","\u002Fguides\u002Fday-to-day\u002Freview-a-change","3.guides\u002F1.day-to-day\u002F5.review-a-change",{"title":105,"path":106,"stem":107},"Raise a cap on a stopped item","\u002Fguides\u002Fday-to-day\u002Fraise-a-cap","3.guides\u002F1.day-to-day\u002F6.raise-a-cap",{"title":109,"path":110,"stem":111},"Kraft for VS Code","\u002Fguides\u002Fday-to-day\u002Fvscode","3.guides\u002F1.day-to-day\u002F7.vscode",{"title":113,"path":114,"stem":115},"Reach the board from your phone","\u002Fguides\u002Fday-to-day\u002Fkraft-on-a-phone","3.guides\u002F1.day-to-day\u002F8.kraft-on-a-phone",{"title":117,"path":118,"stem":119},"Get notified when an item needs you","\u002Fguides\u002Fday-to-day\u002Fnotifications","3.guides\u002F1.day-to-day\u002F9.notifications",{"title":121,"path":122,"stem":123,"children":124},"Customize and automate","\u002Fguides\u002Fcustomize","3.guides\u002F2.customize\u002Findex",[125,126,130,134,138,142],{"title":10,"path":122,"stem":123},{"title":127,"path":128,"stem":129},"Write your own chain","\u002Fguides\u002Fcustomize\u002Fwrite-your-own-chain","3.guides\u002F2.customize\u002F1.write-your-own-chain",{"title":131,"path":132,"stem":133},"Add a security review or a gate reviewer","\u002Fguides\u002Fcustomize\u002Fadd-review-agents","3.guides\u002F2.customize\u002F2.add-review-agents",{"title":135,"path":136,"stem":137},"Schedule or webhook work","\u002Fguides\u002Fcustomize\u002Fschedule-and-webhook-work","3.guides\u002F2.customize\u002F3.schedule-and-webhook-work",{"title":139,"path":140,"stem":141},"Share chains with add-ons","\u002Fguides\u002Fcustomize\u002Fshare-chains-with-addons","3.guides\u002F2.customize\u002F4.share-chains-with-addons",{"title":143,"path":144,"stem":145},"Publish an add-on","\u002Fguides\u002Fcustomize\u002Fpublish-an-add-on","3.guides\u002F2.customize\u002F5.publish-an-add-on",{"title":147,"path":148,"stem":149,"children":150},"Agents and harnesses","\u002Fguides\u002Fharnesses","3.guides\u002F3.harnesses\u002Findex",[151,152,156,160,164],{"title":10,"path":148,"stem":149},{"title":153,"path":154,"stem":155},"Switch a task to another harness","\u002Fguides\u002Fharnesses\u002Fswitch-harness","3.guides\u002F3.harnesses\u002F1.switch-harness",{"title":157,"path":158,"stem":159},"Add or override a harness","\u002Fguides\u002Fharnesses\u002Fadding-a-harness","3.guides\u002F3.harnesses\u002F2.adding-a-harness",{"title":161,"path":162,"stem":163},"Build a worker Kit","\u002Fguides\u002Fharnesses\u002Fworker-kit","3.guides\u002F3.harnesses\u002F3.worker-kit",{"title":165,"path":166,"stem":167},"Give a worker its login","\u002Fguides\u002Fharnesses\u002Fgive-a-worker-its-login","3.guides\u002F3.harnesses\u002F4.give-a-worker-its-login",{"title":169,"path":170,"stem":171,"children":172},"Run the server","\u002Fguides\u002Frun","3.guides\u002F4.run\u002Findex",[173,174,178,182,186,190,194,198,202,206,210,214,218,222,226],{"title":10,"path":170,"stem":171},{"title":175,"path":176,"stem":177},"Remote access","\u002Fguides\u002Frun\u002Fremote-access","3.guides\u002F4.run\u002F01.remote-access",{"title":179,"path":180,"stem":181},"Put a proxy in front of Kraft","\u002Fguides\u002Frun\u002Fput-a-proxy-in-front-of-kraft","3.guides\u002F4.run\u002F02.put-a-proxy-in-front-of-kraft",{"title":183,"path":184,"stem":185},"Restart Kraft without ending running steps","\u002Fguides\u002Frun\u002Frestart-kraft","3.guides\u002F4.run\u002F03.restart-kraft",{"title":187,"path":188,"stem":189},"Back up and restore the database","\u002Fguides\u002Frun\u002Fback-up-and-restore","3.guides\u002F4.run\u002F04.back-up-and-restore",{"title":191,"path":192,"stem":193},"Find the logs","\u002Fguides\u002Frun\u002Ffind-the-logs","3.guides\u002F4.run\u002F05.find-the-logs",{"title":195,"path":196,"stem":197},"Run Kraft as a service","\u002Fguides\u002Frun\u002Frun-as-a-service","3.guides\u002F4.run\u002F06.run-as-a-service",{"title":199,"path":200,"stem":201},"Upgrade Kraft","\u002Fguides\u002Frun\u002Fupgrade-kraft","3.guides\u002F4.run\u002F07.upgrade-kraft",{"title":203,"path":204,"stem":205},"Move onto kraft-default","\u002Fguides\u002Frun\u002Fupgrade-your-configuration","3.guides\u002F4.run\u002F08.upgrade-your-configuration",{"title":207,"path":208,"stem":209},"Coming from 1.4","\u002Fguides\u002Frun\u002Fcoming-from-1-4","3.guides\u002F4.run\u002F09.coming-from-1-4",{"title":211,"path":212,"stem":213},"Free disk space","\u002Fguides\u002Frun\u002Ffree-disk-space","3.guides\u002F4.run\u002F10.free-disk-space",{"title":215,"path":216,"stem":217},"Rotate the token","\u002Fguides\u002Frun\u002Frotate-the-token","3.guides\u002F4.run\u002F11.rotate-the-token",{"title":219,"path":220,"stem":221},"Run items in your own checkout","\u002Fguides\u002Frun\u002Frun-items-in-place","3.guides\u002F4.run\u002F12.run-items-in-place",{"title":223,"path":224,"stem":225},"Run a step on another machine","\u002Fguides\u002Frun\u002Frun-a-step-on-another-machine","3.guides\u002F4.run\u002F13.run-a-step-on-another-machine",{"title":227,"path":228,"stem":229},"Use the console from another machine","\u002Fguides\u002Frun\u002Fuse-the-console-from-another-machine","3.guides\u002F4.run\u002F14.use-the-console-from-another-machine",{"title":231,"path":232,"stem":233},"Kraft Lite","\u002Fguides\u002Fkraft-lite","3.guides\u002F5.kraft-lite",{"title":235,"path":236,"stem":237,"children":238},"Troubleshooting","\u002Ftroubleshooting","4.troubleshooting",[239,241,245,249,253,257,261,265,269,273,277,281],{"title":10,"path":236,"stem":240},"4.troubleshooting\u002Findex",{"title":242,"path":243,"stem":244},"Failed tasks and fix loops","\u002Ftroubleshooting\u002Ffailed-tasks-and-fix-loops","4.troubleshooting\u002F01.failed-tasks-and-fix-loops",{"title":246,"path":247,"stem":248},"Launch and setup stops","\u002Ftroubleshooting\u002Flaunch-and-setup-stops","4.troubleshooting\u002F02.launch-and-setup-stops",{"title":250,"path":251,"stem":252},"Caps, budgets and waits","\u002Ftroubleshooting\u002Fcaps-budgets-and-waits","4.troubleshooting\u002F03.caps-budgets-and-waits",{"title":254,"path":255,"stem":256},"Forge stops","\u002Ftroubleshooting\u002Fforge-stops","4.troubleshooting\u002F04.forge-stops",{"title":258,"path":259,"stem":260},"Worktree and git stops","\u002Ftroubleshooting\u002Fworktree-and-git-stops","4.troubleshooting\u002F05.worktree-and-git-stops",{"title":262,"path":263,"stem":264},"Sandbox and Kit stops","\u002Ftroubleshooting\u002Fsandbox-and-kit-stops","4.troubleshooting\u002F06.sandbox-and-kit-stops",{"title":266,"path":267,"stem":268},"A kind: os sandbox is refused","\u002Ftroubleshooting\u002Fos-sandbox-refusals","4.troubleshooting\u002F07.os-sandbox-refusals",{"title":270,"path":271,"stem":272},"Doctor failures","\u002Ftroubleshooting\u002Fdoctor-failures","4.troubleshooting\u002F08.doctor-failures",{"title":274,"path":275,"stem":276},"Starting and reaching Kraft","\u002Ftroubleshooting\u002Fstarting-and-reaching-kraft","4.troubleshooting\u002F09.starting-and-reaching-kraft",{"title":278,"path":279,"stem":280},"Add-on problems","\u002Ftroubleshooting\u002Faddon-problems","4.troubleshooting\u002F10.addon-problems",{"title":282,"path":283,"stem":284},"Add-on validation messages","\u002Ftroubleshooting\u002Faddon-validate-messages","4.troubleshooting\u002F11.addon-validate-messages",{"title":286,"path":287,"stem":288,"children":289},"Reference","\u002Freference","5.reference",[290,292,338,372,376,380,490,532,558,562,566,584,588,592,596],{"title":10,"path":287,"stem":291},"5.reference\u002Findex",{"title":293,"path":294,"stem":295,"children":296},"Web UI","\u002Freference\u002Fweb-ui","5.reference\u002F00.web-ui\u002Findex",[297,298,302,306,310,314,318,322,326,330,334],{"title":10,"path":294,"stem":295},{"title":299,"path":300,"stem":301},"Sidebar, search and keyboard","\u002Freference\u002Fweb-ui\u002Fsidebar-search-and-keyboard","5.reference\u002F00.web-ui\u002F0.sidebar-search-and-keyboard",{"title":303,"path":304,"stem":305},"The board","\u002Freference\u002Fweb-ui\u002Fboard","5.reference\u002F00.web-ui\u002F1.board",{"title":307,"path":308,"stem":309},"An item's page","\u002Freference\u002Fweb-ui\u002Fitem-page","5.reference\u002F00.web-ui\u002F2.item-page",{"title":311,"path":312,"stem":313},"Fix loops and test scopes","\u002Freference\u002Fweb-ui\u002Ffix-loops-and-test-scopes","5.reference\u002F00.web-ui\u002F3.fix-loops-and-test-scopes",{"title":315,"path":316,"stem":317},"Config before an item starts","\u002Freference\u002Fweb-ui\u002Fconfig-before-start","5.reference\u002F00.web-ui\u002F4.config-before-start",{"title":319,"path":320,"stem":321},"The review page","\u002Freference\u002Fweb-ui\u002Freview-page","5.reference\u002F00.web-ui\u002F5.review-page",{"title":323,"path":324,"stem":325},"Templates","\u002Freference\u002Fweb-ui\u002Ftemplates","5.reference\u002F00.web-ui\u002F6.templates",{"title":327,"path":328,"stem":329},"Settings","\u002Freference\u002Fweb-ui\u002Fsettings","5.reference\u002F00.web-ui\u002F7.settings",{"title":331,"path":332,"stem":333},"Analytics","\u002Freference\u002Fweb-ui\u002Fanalytics","5.reference\u002F00.web-ui\u002F8.analytics",{"title":335,"path":336,"stem":337},"The board on a phone","\u002Freference\u002Fweb-ui\u002Fon-a-phone","5.reference\u002F00.web-ui\u002F9.on-a-phone",{"title":339,"path":340,"stem":341,"children":342},"CLI","\u002Freference\u002Fcli","5.reference\u002F01.cli\u002Findex",[343,344,348,352,356,360,364,368],{"title":10,"path":340,"stem":341},{"title":345,"path":346,"stem":347},"Item verbs","\u002Freference\u002Fcli\u002Fitem","5.reference\u002F01.cli\u002F2.item",{"title":349,"path":350,"stem":351},"View verbs","\u002Freference\u002Fcli\u002Fview","5.reference\u002F01.cli\u002F3.view",{"title":353,"path":354,"stem":355},"Repo verbs","\u002Freference\u002Fcli\u002Frepo","5.reference\u002F01.cli\u002F4.repo",{"title":357,"path":358,"stem":359},"Server verbs","\u002Freference\u002Fcli\u002Fserver","5.reference\u002F01.cli\u002F5.server",{"title":361,"path":362,"stem":363},"Add-on verbs","\u002Freference\u002Fcli\u002Faddon","5.reference\u002F01.cli\u002F6.addon",{"title":365,"path":366,"stem":367},"Machine verbs","\u002Freference\u002Fcli\u002Fworker","5.reference\u002F01.cli\u002F7.worker",{"title":369,"path":370,"stem":371},"Forge verbs","\u002Freference\u002Fcli\u002Fforge","5.reference\u002F01.cli\u002F8.forge",{"title":373,"path":374,"stem":375},"Console","\u002Freference\u002Fconsole","5.reference\u002F01.console",{"title":377,"path":378,"stem":379},"Work item statuses","\u002Freference\u002Fstatuses","5.reference\u002F02.statuses",{"title":381,"path":382,"stem":383,"children":384},"Configuration","\u002Freference\u002Fconfiguration","5.reference\u002F03.configuration\u002Findex",[385,386,404,408,412,416,420,424,428,466,470,474,478,482,486],{"title":10,"path":382,"stem":383},{"title":387,"path":388,"stem":389,"children":390},"repos.yaml","\u002Freference\u002Fconfiguration\u002Frepos","5.reference\u002F03.configuration\u002F02.repos\u002Findex",[391,392,396,400],{"title":10,"path":388,"stem":389},{"title":393,"path":394,"stem":395},"How connect proposes commands","\u002Freference\u002Fconfiguration\u002Frepos\u002Fconnect-proposals","5.reference\u002F03.configuration\u002F02.repos\u002F1.connect-proposals",{"title":397,"path":398,"stem":399},"detectors.yaml","\u002Freference\u002Fconfiguration\u002Frepos\u002Fdetectors","5.reference\u002F03.configuration\u002F02.repos\u002F2.detectors",{"title":401,"path":402,"stem":403},"Workspaces","\u002Freference\u002Fconfiguration\u002Frepos\u002Fworkspaces","5.reference\u002F03.configuration\u002F02.repos\u002F3.workspaces",{"title":405,"path":406,"stem":407},"policy.yaml","\u002Freference\u002Fconfiguration\u002Fpolicy","5.reference\u002F03.configuration\u002F03.policy",{"title":409,"path":410,"stem":411},"Library and chains","\u002Freference\u002Fconfiguration\u002Flibrary-and-chains","5.reference\u002F03.configuration\u002F04.library-and-chains",{"title":413,"path":414,"stem":415},"access.yaml","\u002Freference\u002Fconfiguration\u002Faccess","5.reference\u002F03.configuration\u002F06.access",{"title":417,"path":418,"stem":419},"intake.yaml","\u002Freference\u002Fconfiguration\u002Fintake","5.reference\u002F03.configuration\u002F07.intake",{"title":421,"path":422,"stem":423},"notify.yaml","\u002Freference\u002Fconfiguration\u002Fnotify","5.reference\u002F03.configuration\u002F08.notify",{"title":425,"path":426,"stem":427},"theme.yaml","\u002Freference\u002Fconfiguration\u002Ftheme","5.reference\u002F03.configuration\u002F09.theme",{"title":429,"path":430,"stem":431,"children":432},"Sandboxed workers","\u002Freference\u002Fconfiguration\u002Fsandbox","5.reference\u002F03.configuration\u002F10.sandbox\u002Findex",[433,434,438,442,446,450,454,458,462],{"title":10,"path":430,"stem":431},{"title":435,"path":436,"stem":437},"Resource limits","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fresource-limits","5.reference\u002F03.configuration\u002F10.sandbox\u002F1.resource-limits",{"title":439,"path":440,"stem":441},"Callbacks from a sandbox","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fcallbacks","5.reference\u002F03.configuration\u002F10.sandbox\u002F2.callbacks",{"title":443,"path":444,"stem":445},"Network policy","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fnetwork-policy","5.reference\u002F03.configuration\u002F10.sandbox\u002F3.network-policy",{"title":447,"path":448,"stem":449},"Credentials","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fcredentials","5.reference\u002F03.configuration\u002F10.sandbox\u002F4.credentials",{"title":451,"path":452,"stem":453},"Kits","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fkits","5.reference\u002F03.configuration\u002F10.sandbox\u002F5.kits",{"title":455,"path":456,"stem":457},"sandbox.yaml","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fsandbox-yaml","5.reference\u002F03.configuration\u002F10.sandbox\u002F6.sandbox-yaml",{"title":459,"path":460,"stem":461},"Git in a sandbox","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fgit-in-a-sandbox","5.reference\u002F03.configuration\u002F10.sandbox\u002F7.git-in-a-sandbox",{"title":463,"path":464,"stem":465},"The OS sandbox","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fos-sandbox","5.reference\u002F03.configuration\u002F10.sandbox\u002F8.os-sandbox",{"title":467,"path":468,"stem":469},"Environment variables","\u002Freference\u002Fconfiguration\u002Fenvironment-variables","5.reference\u002F03.configuration\u002F11.environment-variables",{"title":471,"path":472,"stem":473},"Add-ons and collections","\u002Freference\u002Fconfiguration\u002Faddons","5.reference\u002F03.configuration\u002F12.addons",{"title":475,"path":476,"stem":477},"Repo libraries","\u002Freference\u002Fconfiguration\u002Frepo-libraries","5.reference\u002F03.configuration\u002F13.repo-libraries",{"title":479,"path":480,"stem":481},"update.yaml","\u002Freference\u002Fconfiguration\u002Fupdate","5.reference\u002F03.configuration\u002F14.update",{"title":483,"path":484,"stem":485},"workers.yaml","\u002Freference\u002Fconfiguration\u002Fworkers","5.reference\u002F03.configuration\u002F15.workers",{"title":487,"path":488,"stem":489},"forges.yaml","\u002Freference\u002Fconfiguration\u002Fforges","5.reference\u002F03.configuration\u002F16.forges",{"title":491,"path":492,"stem":493,"children":494},"Chain file keys","\u002Freference\u002Fchain-nodes","5.reference\u002F04.chain-nodes\u002Findex",[495,496,500,504,508,512,516,520,524,528],{"title":10,"path":492,"stem":493},{"title":497,"path":498,"stem":499},"The shipped chains","\u002Freference\u002Fchain-nodes\u002Fshipped-chains","5.reference\u002F04.chain-nodes\u002F1.shipped-chains",{"title":501,"path":502,"stem":503},"Subprocess tasks","\u002Freference\u002Fchain-nodes\u002Fsubprocess-tasks","5.reference\u002F04.chain-nodes\u002F2.subprocess-tasks",{"title":505,"path":506,"stem":507},"Fix loop and judge","\u002Freference\u002Fchain-nodes\u002Ffix-loop","5.reference\u002F04.chain-nodes\u002F3.fix-loop",{"title":509,"path":510,"stem":511},"Result file","\u002Freference\u002Fchain-nodes\u002Fresult-file","5.reference\u002F04.chain-nodes\u002F4.result-file",{"title":513,"path":514,"stem":515},"Merge queue and train drops","\u002Freference\u002Fchain-nodes\u002Fmerge-queue-drops","5.reference\u002F04.chain-nodes\u002F5.merge-queue-drops",{"title":517,"path":518,"stem":519},"What the final review approves","\u002Freference\u002Fchain-nodes\u002Ffinal-review-approval","5.reference\u002F04.chain-nodes\u002F6.final-review-approval",{"title":521,"path":522,"stem":523},"Waiting for a pipeline by ID","\u002Freference\u002Fchain-nodes\u002Fwait-for-a-pipeline","5.reference\u002F04.chain-nodes\u002F7.wait-for-a-pipeline",{"title":525,"path":526,"stem":527},"read_only","\u002Freference\u002Fchain-nodes\u002Fread-only","5.reference\u002F04.chain-nodes\u002F8.read-only",{"title":529,"path":530,"stem":531},"Step outputs","\u002Freference\u002Fchain-nodes\u002Fstep-outputs","5.reference\u002F04.chain-nodes\u002F9.step-outputs",{"title":533,"path":534,"stem":535,"children":536},"Agent harnesses","\u002Freference\u002Fharnesses","5.reference\u002F05.harnesses\u002Findex",[537,538,542,546,550,554],{"title":10,"path":534,"stem":535},{"title":539,"path":540,"stem":541},"Unattended runs","\u002Freference\u002Fharnesses\u002Funattended-runs","5.reference\u002F05.harnesses\u002F2.unattended-runs",{"title":543,"path":544,"stem":545},"Agent profiles","\u002Freference\u002Fharnesses\u002Fagent-profiles","5.reference\u002F05.harnesses\u002F3.agent-profiles",{"title":547,"path":548,"stem":549},"Harness definition files and harness profiles","\u002Freference\u002Fharnesses\u002Fharness-files","5.reference\u002F05.harnesses\u002F4.harness-files",{"title":551,"path":552,"stem":553},"Fallback and escalation","\u002Freference\u002Fharnesses\u002Ffallback-and-escalation","5.reference\u002F05.harnesses\u002F5.fallback-and-escalation",{"title":555,"path":556,"stem":557},"Cost reporting","\u002Freference\u002Fharnesses\u002Fcost-reporting","5.reference\u002F05.harnesses\u002F6.cost-reporting",{"title":559,"path":560,"stem":561},"Permission gate","\u002Freference\u002Fpermissions","5.reference\u002F06.permissions",{"title":563,"path":564,"stem":565},"Inbound triggers","\u002Freference\u002Ftriggers","5.reference\u002F07.triggers",{"title":567,"path":568,"stem":569,"children":570},"HTTP API","\u002Freference\u002Fhttp-api","5.reference\u002F08.http-api\u002Findex",[571,572,576,580],{"title":10,"path":568,"stem":569},{"title":573,"path":574,"stem":575},"Filing, reading and deciding work items","\u002Freference\u002Fhttp-api\u002Fwork-items","5.reference\u002F08.http-api\u002F2.work-items",{"title":577,"path":578,"stem":579},"The work item object","\u002Freference\u002Fhttp-api\u002Fwork-item-object","5.reference\u002F08.http-api\u002F4.work-item-object",{"title":581,"path":582,"stem":583},"Connecting a repo","\u002Freference\u002Fhttp-api\u002Fconnect-a-repo","5.reference\u002F08.http-api\u002F5.connect-a-repo",{"title":585,"path":586,"stem":587},"MCP tools","\u002Freference\u002Fmcp-tools","5.reference\u002F09.mcp-tools",{"title":589,"path":590,"stem":591},"Events","\u002Freference\u002Fevents","5.reference\u002F10.events",{"title":593,"path":594,"stem":595},"VS Code extension","\u002Freference\u002Fvscode-extension","5.reference\u002F11.vscode-extension",{"title":597,"path":598,"stem":599},"Kraft Lite reference","\u002Freference\u002Fkraft-lite","5.reference\u002F12.kraft-lite",{"title":601,"path":602,"stem":603,"children":604},"Project","\u002Fproject","6.project",[605,607,611,615,619,623,627,631,635],{"title":10,"path":602,"stem":606},"6.project\u002Findex",{"title":608,"path":609,"stem":610},"Security","\u002Fproject\u002Fsecurity","6.project\u002F1.security",{"title":612,"path":613,"stem":614},"Security in depth","\u002Fproject\u002Fsecurity-in-depth","6.project\u002F1.security-in-depth",{"title":616,"path":617,"stem":618},"Data and privacy","\u002Fproject\u002Fdata-and-privacy","6.project\u002F2.data-and-privacy",{"title":620,"path":621,"stem":622},"What's new","\u002Fproject\u002Fwhats-new","6.project\u002F3.whats-new",{"title":624,"path":625,"stem":626},"Status and support","\u002Fproject\u002Fstatus-and-support","6.project\u002F4.status-and-support",{"title":628,"path":629,"stem":630},"Architecture","\u002Fproject\u002Farchitecture","6.project\u002F5.architecture",{"title":632,"path":633,"stem":634},"Source map","\u002Fproject\u002Fsource-map","6.project\u002F6.source-map",{"title":636,"path":637,"stem":638},"Contributing","\u002Fproject\u002Fcontributing","6.project\u002F7.contributing",{"id":640,"title":266,"body":641,"description":1181,"extension":1182,"links":1183,"meta":1184,"navigation":1185,"path":267,"seo":1186,"stem":268,"__hash__":1187},"docs\u002F4.troubleshooting\u002F07.os-sandbox-refusals.md",{"type":642,"value":643,"toc":1177},"minimark",[644,651,671,916,922,1118,1151,1161],[645,646,647],"p",{},[648,649,650],"em",{},"Added in 2.3",[645,652,653,654,658,659,662,663,666,667,670],{},"A repository with ",[655,656,657],"code",{},"sandbox: {kind: os}"," can't launch unless the host can run bubblewrap (Linux) or Seatbelt (a Mac). Kraft checks the host before a launch and in ",[655,660,661],{},"kraft admin doctor",", caches the answer for a minute, and ends the session as ",[655,664,665],{},"config_error"," with one of these messages in its log. Fix the host, then ",[655,668,669],{},"kraft item retry ID",".",[672,673,674,687],"table",{},[675,676,677],"thead",{},[678,679,680,684],"tr",{},[681,682,683],"th",{},"The message says",[681,685,686],{},"Fix",[688,689,690,704,714,727,738,750,760,774,788,806,828,858,875,888,904],"tbody",{},[678,691,692,698],{},[693,694,695],"td",{},[655,696,697],{},"kind: os runs on Linux and macOS only in this release",[693,699,700,701,670],{},"Run the repo on Linux or a Mac, or use ",[655,702,703],{},"kind: docker",[678,705,706,711],{},[693,707,708],{},[655,709,710],{},"kind: os does not run while Kraft runs as root",[693,712,713],{},"Run the Kraft server as an ordinary user.",[678,715,716,721],{},[693,717,718],{},[655,719,720],{},"kind: os supports x86_64 and aarch64, not \u003Carch>",[693,722,723,724,726],{},"Use ",[655,725,703],{}," on this machine.",[678,728,729,734],{},[693,730,731],{},[655,732,733],{},"kind: os supports arm64 and x86_64 Macs, not \u003Cmachine>",[693,735,723,736,726],{},[655,737,703],{},[678,739,740,745],{},[693,741,742],{},[655,743,744],{},"\u002Fusr\u002Fbin\u002Fsandbox-exec is missing (it ships with macOS): use kind: docker on this Mac",[693,746,747,748,670],{},"Repair or reinstall macOS, or use ",[655,749,703],{},[678,751,752,757],{},[693,753,754],{},[655,755,756],{},"Kraft is itself running inside a sandbox, so it cannot start one: run the Kraft server outside it",[693,758,759],{},"Start the server from a normal terminal or a launchd agent, not from a tool that sandboxes what it starts.",[678,761,762,767],{},[693,763,764],{},[655,765,766],{},"sandbox-exec cannot start a sandbox here: \u003Cerror>",[693,768,769,770,773],{},"The trial run of Kraft's profile failed for a reason Kraft has no fix for. Read the error, which is ",[655,771,772],{},"sandbox-exec","'s own.",[678,775,776,781],{},[693,777,778],{},[655,779,780],{},"bubblewrap is not installed (apt install bubblewrap)",[693,782,783,784,787],{},"Install ",[655,785,786],{},"bubblewrap"," with your package manager.",[678,789,790,803],{},[693,791,792,795,796,799,800],{},[655,793,794],{},"sh is not installed on this host (the `kraft` shim needs it)",", and the same for ",[655,797,798],{},"curl",", or ",[655,801,802],{},"sh and curl are not installed ...",[693,804,805],{},"Install what it names.",[678,807,808,813],{},[693,809,810],{},[655,811,812],{},"bwrap --help failed: \u003Cerror>",[693,814,815,816,819,820,823,824,827],{},"Fix the ",[655,817,818],{},"bwrap"," on ",[655,821,822],{},"PATH"," so that ",[655,825,826],{},"bwrap --help"," runs.",[678,829,830,835],{},[693,831,832],{},[655,833,834],{},"this bubblewrap lacks \u003Cflags>: install a newer bubblewrap",[693,836,837,838,841,842,841,845,841,848,841,851,854,855,670],{},"Install a newer bubblewrap. It must have ",[655,839,840],{},"--size",", ",[655,843,844],{},"--disable-userns",[655,846,847],{},"--as-pid-1",[655,849,850],{},"--cap-drop",[655,852,853],{},"--seccomp"," and ",[655,856,857],{},"--die-with-parent",[678,859,860,865],{},[693,861,862],{},[655,863,864],{},"bubblewrap cannot create a user namespace here: sysctl user.max_user_namespaces=15000",[693,866,867,868,871,872,670],{},"Run that ",[655,869,870],{},"sysctl"," as root, and persist it in ",[655,873,874],{},"\u002Fetc\u002Fsysctl.d\u002F",[678,876,877,882],{},[693,878,879],{},[655,880,881],{},"bubblewrap cannot create a user namespace here: sysctl kernel.unprivileged_userns_clone=1",[693,883,867,884,871,886,670],{},[655,885,870],{},[655,887,874],{},[678,889,890,895],{},[693,891,892],{},[655,893,894],{},"bubblewrap cannot create a user namespace here: install bubblewrap's AppArmor profile, or sysctl kernel.apparmor_restrict_unprivileged_userns=0",[693,896,897,898,900,901,903],{},"Install the distribution's bubblewrap AppArmor profile, which is the narrow fix. Setting the ",[655,899,870],{}," to 0 lifts the restriction for every program on the host, so persist it in ",[655,902,874],{}," only if you accept that.",[678,905,906,911],{},[693,907,908],{},[655,909,910],{},"bubblewrap cannot start a sandbox here: \u003Cerror>",[693,912,913,914,773],{},"The trial run, under the seccomp filter a session loads, failed for a reason Kraft has no fix for. Read the error, which is ",[655,915,818],{},[645,917,918,919,921],{},"These are refusals of a command or a path, with the same ",[655,920,665],{},":",[672,923,924,932],{},[675,925,926],{},[678,927,928,930],{},[681,929,683],{},[681,931,686],{},[688,933,934,958,972,984,1004,1021,1037,1066,1083,1102],{},[678,935,936,941],{},[693,937,938],{},[655,939,940],{},"'\u003Ccommand>' not found on the Kraft server's PATH; add its directory to the PATH the server starts with (expose does not add to PATH)",[693,942,943,944,947,948,950,951,954,955,957],{},"The sandbox searches ",[655,945,946],{},"\u002Fopt\u002Fkraft\u002Fbin",", then the server's ",[655,949,822],{},", never ",[655,952,953],{},"expose",". Put the command's directory on the ",[655,956,822],{}," the server starts with (a service's is in its unit), then restart the server.",[678,959,960,965],{},[693,961,962],{},[655,963,964],{},"'\u003Ccommand>' not found: \u003Cpath> does not exist",[693,966,967,968,971],{},"A path-named command (",[655,969,970],{},".\u002Fgradlew",") isn't where it says. Fix the command, or commit the file it names.",[678,973,974,979],{},[693,975,976],{},[655,977,978],{},"\u003Ccommand> leads to \u003Cpath>, outside the sandbox's view; add its directory to the sandbox's expose list",[693,980,967,981,983],{},[655,982,970],{},") is a symlink out of the worktree. Expose the target's directory.",[678,985,986,991],{},[693,987,988],{},[655,989,990],{},"cannot show \u003Cpath> to the sandbox: ...; add its toolchain with expose",[693,992,993,994,997,998,1000,1001,1003],{},"The command's directory is protected (your home directory itself, ",[655,995,996],{},"~\u002F.ssh","), and ",[655,999,953],{}," can't add it. Move the command to another directory on ",[655,1002,822],{},", which is mounted by itself.",[678,1005,1006,1011],{},[693,1007,1008],{},[655,1009,1010],{},"\u003Cpath> needs '\u003Cname>', which is not on the Kraft server's PATH; add its directory to the PATH the server starts with",[693,1012,1013,1014,1017,1018,1020],{},"A script's ",[655,1015,1016],{},"#!\u002Fusr\u002Fbin\u002Fenv \u003Cname>"," is looked up on the server's ",[655,1019,822],{},". Put the interpreter's directory there, then restart the server.",[678,1022,1023,1028],{},[693,1024,1025],{},[655,1026,1027],{},"\u003Cpath> needs \u003Cname>, which does not exist",[693,1029,1013,1030,1033,1034,1036],{},[655,1031,1032],{},"#!"," names an absolute interpreter that isn't on this host. Install it or fix the ",[655,1035,1032],{}," line.",[678,1038,1039,1044],{},[693,1040,1041],{},[655,1042,1043],{},"\u003Cpath> is under \u002Fusr or \u002Fetc, which every os sandbox mounts",[693,1045,1046,1047,1050,1051,1054,1055,1050,1058,1061,1062,1065],{},"A protected path (your Kraft home, or the run or config directory ",[655,1048,1049],{},"KRAFT_RUN_DIR"," or ",[655,1052,1053],{},"KRAFT_CONFIG_DIR"," names) lies under ",[655,1056,1057],{},"\u002Fusr",[655,1059,1060],{},"\u002Fetc",", which a ",[655,1063,1064],{},"kind: os"," sandbox always shows. Move it out.",[678,1067,1068,1073],{},[693,1069,1070],{},[655,1071,1072],{},"Kraft's python prefix cannot be shown to the sandbox: ...",[693,1074,1075,1076,1079,1080,1082],{},"The system ",[655,1077,1078],{},"python3"," is missing or older than 3.10, so the sandbox needs Kraft's own interpreter, whose prefix is protected. Install Python 3.10 or newer under ",[655,1081,1057],{},", or install Kraft elsewhere.",[678,1084,1085,1094],{},[693,1086,1087,1090,1091,1093],{},[655,1088,1089],{},"expose '\u003Cpath>' is protected: ...",", when ",[655,1092,387],{}," loads",[693,1095,1096,1097,670],{},"The entry is or holds a protected path, and the entry doesn't load. Remove it or narrow it. See ",[1098,1099,1101],"a",{"href":1100},"\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fos-sandbox#protected-paths","Protected paths",[678,1103,1104,1113],{},[693,1105,1106,799,1109,1112],{},[655,1107,1108],{},"expose path \u003Centry>: ...",[655,1110,1111],{},"expose path \u003Cpath> does not exist",", at launch",[693,1114,1115,1116,670],{},"Remove the entry or fix it. See ",[1098,1117,1101],{"href":1100},[645,1119,1120,1121,1124,1125,1128,1129,1132,1133,1135,1136,1138,1139,1142,1143,1146,1147,1150],{},"A command that isn't found once the session runs exits 127 with ",[655,1122,1123],{},"kraft: a command was not found inside the os sandbox; add its directory to the sandbox's expose list",": a tool the repo's own commands call (",[655,1126,1127],{},"uv"," in ",[655,1130,1131],{},"~\u002F.local\u002Fbin",", a Nix CLI) is in the same position. Add its directory to ",[655,1134,953],{},". A library a toolchain loads from outside ",[655,1137,1057],{}," needs the same: Homebrew's ",[655,1140,1141],{},"bash"," fails on ",[655,1144,1145],{},"libreadline"," until ",[655,1148,1149],{},"\u002Fopt\u002Fhomebrew"," is exposed.",[645,1152,1153,1154,1156,1157,1160],{},"After you edit ",[655,1155,953],{},", run ",[655,1158,1159],{},"kraft item retry ID --sandbox-from-config --yes"," to give the item the edited list.",[645,1162,1163,1164,1167,1168,1171,1172,1174,1175,670],{},"Exit 126 (",[655,1165,1166],{},"kraft: \u003Ccommand> is not executable",") is only a ",[655,1169,1170],{},"PermissionError"," on the exec, the file's mode; any other exec failure is 127. A command that can't start sends no started byte, so the session ends as ",[655,1173,665],{}," (launch_failed), not as a task failure. See ",[1098,1176,463],{"href":464},{"title":1178,"searchDepth":1179,"depth":1179,"links":1180},"",2,[],"Fix a work item that stopped because the host can't run a kind: os sandbox, or because a command or path a session needs isn't in the sandbox's view.","md",null,{},true,{"title":266,"description":1181},"y29hhsgkYXJ5LKnvWrN29xod717ojvUVRhMjieFPJHM",[1189,1191],{"title":262,"path":263,"stem":264,"description":1190,"children":-1},"Find the reason a sandboxed work item stopped, whether a sandbox with no network policy, the sandbox's memory limit, a Kit Kraft won't run, a workspace member Kraft can't check out, or a nested git repository Kraft didn't create, and the fix for each.",{"title":270,"path":271,"stem":272,"description":1192,"children":-1},"What each failing or warning row of kraft admin doctor means and how to clear it.",1794749047836]