[{"data":1,"prerenderedAt":1519},["ShallowReactive",2],{"navigation_docs":3,"-concepts-how-workers-and-machines-behave":639,"-concepts-how-workers-and-machines-behave-surround":1514},[4,32,71,234,285,600],{"title":5,"path":6,"stem":7,"children":8,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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,"page":-1},"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":68,"body":641,"description":1507,"extension":1508,"links":1509,"meta":1510,"navigation":1511,"path":69,"seo":1512,"stem":70,"__hash__":1513},"docs\u002F2.concepts\u002F8.how-workers-and-machines-behave.md",{"type":642,"value":643,"toc":1488},"minimark",[644,655,660,671,763,767,774,789,826,836,872,876,887,914,949,953,976,982,1013,1017,1026,1064,1068,1081,1091,1095,1140,1144,1147,1152,1187,1197,1204,1207,1211,1226,1237,1241,1256,1273,1279,1285,1289,1302,1315,1319,1332,1340,1350,1358,1361,1364,1367,1370,1374,1386,1390,1393,1440,1443,1447,1453,1460,1463,1467,1484],[645,646,647,648,651,652,654],"p",{},"This page is the run-time behaviour behind ",[649,650,483],"a",{"href":484},": what the\nlocal worker does, how a machine's limit and its groups decide where a step goes, and what happens when a\nmachine or the server goes away. For why a step goes through a worker at all, see\n",[649,653,56],{"href":57},".",[656,657,659],"h2",{"id":658},"the-local-worker","The local worker",[645,661,662,663,666,667,670],{},"Starting Kraft also starts the local worker, a second process on the same machine that runs every local step: agent sessions and the commands of test tasks. It needs no entry in ",[664,665,483],"code",{},", no token and no ",[664,668,669],{},"worker add",". The server finds it again after a restart, and starts a new one if it dies.",[672,673,674,702,716,723,730,740,750,753,756],"ul",{},[675,676,677,678,681,682,685,686,689,690,693,694,697,698,701],"li",{},"It appears as ",[664,679,680],{},"local"," in Settings › Workers and in ",[664,683,684],{},"kraft admin worker list",", with whether it is up, how many steps it runs and its Kraft version. It runs as many steps as ",[664,687,688],{},"local: capacity"," allows, and has no limit when that is unset; ",[664,691,692],{},"max_concurrent"," limits work items, not steps. It can't be removed, and ",[664,695,696],{},"enabled: false"," makes local steps wait (",[664,699,700],{},"waiting for local (disabled)",") while the ones running finish.",[675,703,704,705,708,709,712,713,654],{},"It listens on a unix socket under ",[664,706,707],{},"run\u002Flocal-worker\u002F"," (a private folder under ",[664,710,711],{},"\u002Ftmp"," when that path is too long for a socket), and only your user can reach it. Its log is ",[664,714,715],{},"run\u002Flogs\u002Flocal-worker.log",[675,717,718,719,722],{},"There is one worker for each installed Kraft, named by its version and a hash of where it is installed (",[664,720,721],{},"worker-\u003Cversion>-\u003Chash>.sock","). After an update the new server starts a worker of its own and takes over the running steps; the old one gets no new steps, reaps the processes it started and exits.",[675,724,725,726,729],{},"Stopping or restarting the server doesn't stop the worker. The steps of worktree items it runs carry on, and the next server picks them up; ",[664,727,728],{},"kraft admin stop --now"," stops them. Under a systemd service the worker starts outside the unit's cgroup, so stopping the unit leaves it running.",[675,731,732,733,735,736,739],{},"A step placed on ",[664,734,680],{},", or on nothing, waits while the worker isn't connected, and the board says ",[664,737,738],{},"waiting for local",". It is never run in the server instead.",[675,741,742,743,745,746,749],{},"A step beyond ",[664,744,688],{}," waits before it has a session. The board says ",[664,747,748],{},"waiting for local (2 of 2 running)",", the wait doesn't count against its time cap, and the step's log starts with how long it waited. Every local step counts, test commands included, so a low limit runs parallel test scopes one at a time. Steps the worker kept running through a restart count too, and a new one waits for them.",[675,751,752],{},"A step the worker started keeps running if the worker dies. The next worker takes it over, and the server goes on watching it.",[675,754,755],{},"It exits by itself a few seconds after the server is gone and nothing is running.",[675,757,758,759,762],{},"A worker on another machine and the server must run the same major version of Kraft. The handshake turns a machine on another major away with ",[664,760,761],{},"update kraft on this machine to X.y","; one on an older release of the same major keeps getting steps.",[656,764,766],{"id":765},"connecting-a-machine","Connecting a machine",[645,768,769,770,654],{},"The two modes, and what each value must be, are in ",[649,771,773],{"href":772},"\u002Freference\u002Fconfiguration\u002Fworkers#two-ways-to-connect","Two ways to connect",[645,775,776,780,781,784,785,788],{},[777,778,779],"strong",{},"Dial-in."," The machine opens the connection to the server, so it works behind a NAT and needs no inbound port. ",[664,782,783],{},"kraft admin worker add home-server"," prints a token once and the command to run on the machine, ",[664,786,787],{},"kraft admin worker serve --server URL --token TOKEN",", which redials by itself after a drop, a refusal or an unreachable server until you stop it.",[672,790,791,798,808,811],{},[675,792,793,794,797],{},"The connection route is ",[664,795,796],{},"\u002Fapi\u002Fworkers\u002Fconnect",". It is exempt from the login cookie: the machine proves itself with its token and nothing else. It still obeys the rest of the perimeter, so a server with no password refuses a peer that isn't local, token or not.",[675,799,800,801,804,805,654],{},"Kraft speaks plain WebSocket, so TLS is your reverse proxy's job. Put the ",[664,802,803],{},"https:\u002F\u002F"," address in ",[664,806,807],{},"--server",[675,809,810],{},"The token is on the command line, so it appears in the process list on the machine. Treat that machine as trusted with it.",[675,812,813,814,817,818,821,822,825],{},"After ",[664,815,816],{},"rotate-token",", steps running on the machine wait for it, up to its ",[664,819,820],{},"give_up_after",", until ",[664,823,824],{},"serve"," runs again with the new token.",[645,827,828,831,832,835],{},[777,829,830],{},"Ssh."," The server dials the machine with ",[664,833,834],{},"ssh HOST kraft admin worker serve --stdio"," and redials when the connection ends. Nothing runs on the machine until the server connects.",[672,837,838,849,855,865],{},[675,839,840,841,844,845,848],{},"A server started by ",[664,842,843],{},"launchd"," or ",[664,846,847],{},"systemd"," may not reach your SSH agent, so give it a key file with no passphrase prompt, or an agent socket it can see.",[675,850,851,852,854],{},"A failed connect from ",[664,853,669],{}," leaves the machine saved and exits 1, because a machine that is asleep or not yet reachable is still worth registering.",[675,856,857,858,861,862,654],{},"The machine keeps its state in a small background process, the machine daemon, so a step outlives the ssh session that started it. The first connection starts it, detached and later ones reuse it. It listens on a unix socket in ",[664,859,860],{},"$KRAFT_HOME\u002Fremote",", which only the machine's user can enter, and logs to ",[664,863,864],{},"$KRAFT_HOME\u002Fremote\u002Fdaemon.log",[675,866,867,868,871],{},"The daemon exits after ten minutes with no connection and no unfinished step. After an upgrade, the first connection from the newer Kraft retires the older daemon as soon as it holds no step. A dial-in machine doesn't use it: ",[664,869,870],{},"serve --server"," is already a long-running process.",[656,873,875],{"id":874},"the-machines-own-limit","The machine's own limit",[645,877,878,879,882,883,886],{},"A machine can set its own limit, so it never takes more than it can run whatever a server sends. Put it in ",[664,880,881],{},"machine.yaml"," in the config directory of the Kraft that runs the machine's steps (",[664,884,885],{},"$KRAFT_HOME\u002Fconfig","):",[888,889,895],"pre",{"className":890,"code":891,"filename":892,"language":893,"meta":894,"style":894},"language-yaml shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","capacity: 2\n","config\u002Fmachine.yaml on the machine","yaml","",[664,896,897],{"__ignoreMap":894},[898,899,902,906,910],"span",{"class":900,"line":901},"line",1,[898,903,905],{"class":904},"sb7M8","capacity",[898,907,909],{"class":908},"s7iLA",": ",[898,911,913],{"class":912},"ssYy9","2\n",[672,915,916,919,931,938,941,944],{},[675,917,918],{},"The machine reports the limit when it connects and again when the file changes. It rereads the file before each step and every 20 seconds, so a raised limit reaches the server within 20 seconds. A file that doesn't parse is logged and read as no limit.",[675,920,921,922,924,925,927,928,930],{},"The server uses the lower of its ",[664,923,905],{}," and the machine's, and ",[664,926,684],{}," and Settings › Workers say when the machine's is the lower. A machine that sets none, or an older one, is limited by the server's ",[664,929,905],{}," alone.",[675,932,933,934,937],{},"Before it builds a step for a machine that has a limit, the server asks the machine to hold a slot. A machine at its limit refuses, and the step goes to another free machine it may use (",[664,935,936],{},"any","), or waits for the named one. Nothing has been made for it yet, so a refusal leaves no session and sends no files.",[675,939,940],{},"A refusal doesn't count as a failure or a retry. The machine isn't asked again until it reports a new limit, one of its steps ends, or 30 seconds pass.",[675,942,943],{},"The limit belongs to the connection to one server. A machine used by several servers applies it to each; it isn't shared between them.",[675,945,946,948],{},[664,947,881],{}," is kept across a major update.",[656,950,952],{"id":951},"groups","Groups",[645,954,955,956,959,960,963,964,967,968,971,972,975],{},"A group is a name you choose for a set of machines. A step whose ",[664,957,958],{},"runner:"," names the group goes to one of its members, so you can say \"a GPU machine\" without picking which. A machine lists its groups in ",[664,961,962],{},"groups:",", and can be in several. The local worker joins groups with ",[664,965,966],{},"local: groups:",", and ",[664,969,970],{},"kraft admin worker add NAME --group G"," (repeatable) writes a machine's; ",[664,973,974],{},"edit NAME --group G"," replaces them.",[645,977,978,979,981],{},"Kraft takes the first member that is online, may work on every repo of the item, and has a free slot: remote members first, in name order, then the local worker. A group that includes the local worker therefore sends work to its machines first; an unlimited local worker would otherwise take every step. ",[664,980,936],{}," is a separate word: every remote machine, never the local worker.",[672,983,984,987,993,1000,1003,1006],{},[675,985,986],{},"The slot is taken when Kraft chooses, so two steps never both start on the one free slot, and a step is never held for one member while another is free.",[675,988,989,990,654],{},"A member at its own limit turns the step away, and Kraft goes on to the next member. See ",[649,991,875],{"href":992},"#the-machines-own-limit",[675,994,995,996,999],{},"With no member free, the board says ",[664,997,998],{},"waiting for a machine in gpu",". The step starts on the first member that frees, looked at again every 30 seconds. A group that loses its last member while steps wait for it refuses them at the next check.",[675,1001,1002],{},"A resumed session (a paused agent step, an escalation thread's later turn or a review reply) goes back to the machine it started on (or the local worker) and waits for it. Every other launch is placed afresh: a fix-loop relaunch, each test scope and a fallback harness each take whichever member is free.",[675,1004,1005],{},"A remote member can't take an in-place item or one with workspace members. Such an item runs on the local worker when it is a member. When it isn't, Kraft refuses the item when it is filed, naming the group.",[675,1007,1008,1009,1012],{},"A step that needs a capability a member lacks, a ",[664,1010,1011],{},"codex"," step needing Kraft's permission hook or a step of a Git LFS repo on a member without git-lfs, goes to a member that has it, else the local worker when it is a member.",[656,1014,1016],{"id":1015},"disabling-a-machine","Disabling a machine",[645,1018,1019,1022,1023,1025],{},[664,1020,1021],{},"kraft admin worker disable NAME"," (or ",[664,1024,696],{},") is for taking a machine out of rotation without forgetting it: it keeps its token or ssh entry, its slots and its connection.",[672,1027,1028,1031,1041,1047],{},[675,1029,1030],{},"Steps already running on it finish, hand in their results and give their slots back.",[675,1032,1033,1034,1037,1038,1040],{},"Nothing new starts on it. A step that names the machine waits, and the board says ",[664,1035,1036],{},"waiting for gpu-box (disabled)",", even when the machine is also offline. A group or ",[664,1039,936],{}," goes on to another member.",[675,1042,1043,1046],{},[664,1044,1045],{},"enable"," undoes it; the waiting steps start on the next check.",[675,1048,1049,1051,1052,1055,1056,1059,1060,1063],{},[664,1050,684],{}," shows ",[664,1053,1054],{},"disabled",", with ",[664,1057,1058],{},"· offline:"," and the reason after it when the machine is also out of reach. ",[664,1061,1062],{},"kraft admin doctor"," reports it as disabled, not as a warning.",[656,1065,1067],{"id":1066},"when-a-machine-is-offline","When a machine is offline",[645,1069,1070,1051,1072,1075,1076,1080],{},[664,1071,684],{},[664,1073,1074],{},"offline:"," and the reason; each reason is in ",[649,1077,1079],{"href":1078},"\u002Freference\u002Fconfiguration\u002Fworkers#offline-reasons","Offline reasons",". For an ssh machine the reason is the server's own attempt, not your shell's, so a failure there that your terminal doesn't show points to the SSH agent.",[645,1082,1083,1084,844,1087,1090],{},"A second connection from a machine replaces the first. A machine that is removed, or whose ",[664,1085,1086],{},"ssh",[664,1088,1089],{},"token_sha256"," changes, loses its connection at once.",[656,1092,1094],{"id":1093},"how-kraft-reads-the-file","How Kraft reads the file",[672,1096,1097,1104,1110,1131,1134],{},[675,1098,1099,1100,1103],{},"Kraft reads the file at startup and again on ",[664,1101,1102],{},"kraft admin reload",". A hand edit shows in Settings as waiting to be reloaded.",[675,1105,1106,1107,1109],{},"A file that doesn't load isn't used: at startup no machine is connected, and on a reload the running set is kept. ",[664,1108,1062],{}," names the problem.",[675,1111,1112,1115,1116,1115,1119,1115,1121,1115,1124,1126,1127,1130],{},[664,1113,1114],{},"kraft admin worker add",", ",[664,1117,1118],{},"edit",[664,1120,1045],{},[664,1122,1123],{},"disable",[664,1125,816],{}," and ",[664,1128,1129],{},"remove"," write the file themselves and apply it at once.",[675,1132,1133],{},"A Kraft session can't add, edit, rotate, list or remove a machine. Only a person, or an assistant a person is working with, can.",[675,1135,1136,1137,1139],{},"A new ",[664,1138,820],{}," is used by the server at once and reaches the machine the next time it connects.",[656,1141,1143],{"id":1142},"when-the-server-is-gone","When the server is gone",[645,1145,1146],{},"A step that finishes while the connection is down keeps its log, commits and documents on the machine and hands them in when it reconnects. Its log carries on from the byte the server has.",[645,1148,1149,1151],{},[664,1150,820],{}," is how long either side waits:",[672,1153,1154,1164,1178,1181],{},[675,1155,1156,1157,1159,1160,1163],{},"The machine stops the step it is running once it has had no connection for ",[664,1158,820],{},", and writes ",[664,1161,1162],{},"kraft: stopped on this machine after 2h without Kraft"," at the end of the step's log.",[675,1165,1166,1167,1170,1171,1173,1174,1177],{},"The server ends the step as ",[664,1168,1169],{},"unknown",", the status a process that vanished gets, once the machine has been out of reach for ",[664,1172,820],{},". It records ",[664,1175,1176],{},"remote_step_given_up",", and tells the machine to stop the step if it comes back. Whatever the machine hands in after that is thrown away.",[675,1179,1180],{},"Only time the server was awake counts. A laptop that sleeps for a night doesn't give up on a machine: the clock starts again on wake.",[675,1182,1183,1186],{},[664,1184,1185],{},"never"," turns both off for that machine. Its steps run to the end and wait, however long, to hand in. The board shows the step as unreachable since the time the connection dropped, until the machine returns or you cancel the step.",[645,1188,1189,1190,1193,1194,1196],{},"A machine that holds a step can't be removed: the server answers ",[664,1191,1192],{},"409",", naming the items, and says to disable the machine and remove it once the steps end. A step held by a machine that is offline is freed by pausing or cancelling its item, or by ",[664,1195,820],{},". Steps only waiting for the machine don't block its removal; they are refused at their next check. The local worker can't be removed at all.",[645,1198,1199,1200,1203],{},"The time cap and the idle-output limit of a step are enforced on the machine as well as on the server, since a sleeping laptop enforces nothing. Whichever side fires first stops the step with the same ",[664,1201,1202],{},"time_cap_reached"," event.",[645,1205,1206],{},"A machine drops its copy of an item, its working files and its job folders, when the item is archived or abandoned, and on reconnect for every item the server no longer lists. It keeps the copy of an item while one of the item's steps is still running there.",[656,1208,1210],{"id":1209},"running-a-step-on-a-machine","Running a step on a machine",[645,1212,1213,1214,1216,1217,1221,1222,1225],{},"Name a machine in a chain's ",[664,1215,958],{}," (see ",[649,1218,1220],{"href":1219},"\u002Freference\u002Fconfiguration\u002Flibrary-and-chains#placing-a-step-on-a-machine","Placing a step on a machine",") or give one item its own with ",[664,1223,1224],{},"kraft item create --runner NAME",". A step placed there runs on the machine; the board, gates, repos and the item's branch stay on the server.",[645,1227,1228,1229,1232,1233,1236],{},"An unsandboxed step has no session MCP endpoint (",[664,1230,1231],{},"\u002Fmcp",") on a machine, so it uses the ",[664,1234,1235],{},"kraft"," command. An escalation turn, a review reply or a gate review that runs on a machine gets the same worker rights and nothing wider.",[656,1238,1240],{"id":1239},"sandboxed-items-on-a-machine","Sandboxed items on a machine",[645,1242,1243,1244,1247,1248,1251,1252,654],{},"A step of a sandboxed item runs on a machine inside the sandbox the item was filed with, built by the machine. The server sends the ",[664,1245,1246],{},"sandbox"," value, the network lists and the credential declarations, never a secret: the secrets are read from the machine's own environment. A machine that can't build the sandbox stops the step as ",[664,1249,1250],{},"config_error",", naming itself and what is missing, and runs nothing. See ",[649,1253,1255],{"href":1254},"\u002Freference\u002Fconfiguration\u002Fsandbox#on-a-remote-machine","On a remote machine",[645,1257,1258,1261,1262,1265,1266,1126,1269,1272],{},[664,1259,1260],{},"kraft admin worker check"," shows one ",[664,1263,1264],{},"sandbox:"," row per backend, ",[664,1267,1268],{},"docker",[664,1270,1271],{},"os",", with its own health detail, and skips a backend that doesn't work there. When none works it warns that sandboxed items can't run on the machine.",[645,1274,1275,1276,1278],{},"A sandboxed worker's calls to Kraft, its permission requests over ",[664,1277,1231],{}," included, go out through the machine's egress proxy and across the connection. The machine refuses a call outside the worker's allowlist before it sends it, and the server checks it again.",[645,1280,1281,1282,1284],{},"A sandboxed ",[664,1283,1011],{}," step whose policy needs its permission hook can't run on a machine.",[656,1286,1288],{"id":1287},"codex-steps-on-a-machine","Codex steps on a machine",[645,1290,1291,1292,1295,1296,1298,1299,1301],{},"Codex skips a hook it doesn't trust and says nothing. When a step's tool policy needs Kraft's ",[649,1293,1294],{"href":560},"permission hook",", the machine's own ",[664,1297,1011],{}," trusts the hook, in the machine's copy of the worktree, just before the step starts. The server's ",[664,1300,1011],{}," is never asked, because another version may hash the hook another way. The hook runs with the machine's own Kraft.",[645,1303,1304,1305,1307,1308,1310,1311,1314],{},"If the machine's ",[664,1306,1011],{}," can't trust the hook, the step stops as ",[664,1309,1250],{}," with the reason in its log and runs nothing. A machine whose Kraft is too old to do this check is refused the same way, with ",[664,1312,1313],{},"update Kraft on that machine","; its other steps still run.",[656,1316,1318],{"id":1317},"git-lfs-repos-on-a-machine","Git LFS repos on a machine",[645,1320,1321,1322,1325,1326,1328,1329,654],{},"A step of an item in a Git LFS repo runs on a machine that has ",[664,1323,1324],{},"git-lfs",". A machine without it is never given the step: ",[664,1327,936],{}," and a group pass it over, and a named machine is refused with a message that starts ",[664,1330,1331],{},"the repo uses Git LFS: machine 'gpu-box' has no git-lfs; install git-lfs there",[645,1333,1334,1336,1337,1339],{},[664,1335,1260],{}," shows a ",[664,1338,1324],{}," row, skipped when it is missing. Kraft on the machine must be as new as the server's, or it doesn't list git-lfs.",[645,1341,1342,1343,1345,1346,1349],{},"The machine's worker looks for ",[664,1344,1324],{}," once, when it starts, and keeps the answer. If you install it later, the machine doesn't list it until its worker restarts: ",[664,1347,1348],{},"kraft admin worker serve"," for a dial-in machine, and for an ssh machine the background process the server's ssh talks to.",[645,1351,1352,1353,1357],{},"An ssh reconnect doesn't restart that process while it runs; it exits on its own after ",[649,1354,1356],{"href":1355},"#connecting-a-machine","about ten minutes"," with no job and no connection, and the next connection starts a fresh one.",[645,1359,1360],{},"The machine never fetches from the forge. The objects the step's head checks out travel through the server, beside the git bundle, one at a time. The server sends only those it holds, and only those the machine doesn't already have. Each item has its own copy on the machine, so an item's first step there receives every LFS object its head checks out: transfer time and disk, per item.",[645,1362,1363],{},"An object the server lacks stays a pointer file on the machine, as it would in a local worktree that couldn't fetch it.",[645,1365,1366],{},"The files the agent adds or changes come back the same way. Kraft checks each returned object against a pointer in the commits it came with, by hash and size, and refuses the whole result if one doesn't match, or if a new pointer has no object behind it. The branch then doesn't move.",[645,1368,1369],{},"What passes goes into the server's LFS store and is pushed with the branch, as a local step's would be. An object is sent again whole if the connection drops mid-transfer.",[656,1371,1373],{"id":1372},"waiting-and-capacity","Waiting and capacity",[645,1375,1376,1377,1126,1381,1385],{},"A waiting step holds no slot and never runs anywhere else: see ",[649,1378,1380],{"href":1379},"\u002Fconcepts\u002Fwhere-a-step-runs#waiting-and-refusals","Waiting, and refusals",[649,1382,1384],{"href":1383},"\u002Fconcepts\u002Fwhere-a-step-runs#resuming-goes-back","Resuming goes back",". Pause, skip and cancel work as usual on a waiting step.",[656,1387,1389],{"id":1388},"what-the-server-checks-on-a-result","What the server checks on a result",[645,1391,1392],{},"A machine is trusted to run a step, not to describe its result. Everything it sends back is checked before the server takes it:",[672,1394,1395,1401,1415,1424,1434],{},[675,1396,1397,1400],{},[777,1398,1399],{},"Commits."," The bundle must hold the item's branch and nothing else, and the server checks its objects as it fetches them. It must continue from the head the server sent. It may not add or change a submodule pointer (a gitlink), or add a nested repository.",[675,1402,1403,1406,1407,1410,1411,1414],{},[777,1404,1405],{},"The branch."," The server moves it only by compare-and-swap: only if it still points where the server expects. If the branch moved meanwhile, or the worktree has uncommitted changes to tracked files, the commits are kept under ",[664,1408,1409],{},"refs\u002Fkraft\u002Funsynced\u002F"," and the item records ",[664,1412,1413],{},"sandbox_branch_not_synced",". Nothing is overwritten.",[675,1416,1417,1420,1421,654],{},[777,1418,1419],{},"LFS objects."," Each returned object is checked against a pointer in the new commits: see ",[649,1422,1318],{"href":1423},"#git-lfs-repos-on-a-machine",[675,1425,1426,1429,1430,1433],{},[777,1427,1428],{},"Files."," The server writes files back only inside the places the step was given to write, never through a link. At most 5,000 files or 256 MiB go each way, and a refusal writes nothing. In ",[664,1431,1432],{},"docs\u002F",", a file you changed while the step ran keeps your version.",[675,1435,1436,1439],{},[777,1437,1438],{},"Calls and events."," A call outside a worker session's rights gets a 403. The machine may add only a fixed set of sandbox events to the item's history.",[645,1441,1442],{},"A result the server doesn't take fails the step, with the reason at the end of its log. The branch is left as it was.",[656,1444,1446],{"id":1445},"if-something-goes-wrong","If something goes wrong",[645,1448,1449,1450,654],{},"A result the server refuses is covered in ",[649,1451,1389],{"href":1452},"#what-the-server-checks-on-a-result",[645,1454,1455,1456,1459],{},"A document you edited while the step ran keeps your version; the step's copy is saved in the session's folder and ",[664,1457,1458],{},"remote_docs_conflict"," names it.",[645,1461,1462],{},"When the server restarts, a running step carries on and its log resumes without a gap.",[656,1464,1466],{"id":1465},"related","Related",[672,1468,1469,1474,1479],{},[675,1470,1471,1473],{},[649,1472,483],{"href":484},": every field, the connection modes, and each refusal.",[675,1475,1476,1478],{},[649,1477,56],{"href":57},": why a step runs through a worker, and what travels.",[675,1480,1481,1483],{},[649,1482,223],{"href":224},": set one up.",[1485,1486,1487],"style",{},"html pre.shiki code .sb7M8, html code.shiki .sb7M8{--shiki-light:#024C1A;--shiki-default:#024C1A;--shiki-dark:#72F088}html pre.shiki code .s7iLA, html code.shiki .s7iLA{--shiki-light:#0E1116;--shiki-default:#0E1116;--shiki-dark:#F0F3F6}html pre.shiki code .ssYy9, html code.shiki .ssYy9{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#91CBFF}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 .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 .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);}",{"title":894,"searchDepth":1489,"depth":1489,"links":1490},2,[1491,1492,1493,1494,1495,1496,1497,1498,1499,1500,1501,1502,1503,1504,1505,1506],{"id":658,"depth":1489,"text":659},{"id":765,"depth":1489,"text":766},{"id":874,"depth":1489,"text":875},{"id":951,"depth":1489,"text":952},{"id":1015,"depth":1489,"text":1016},{"id":1066,"depth":1489,"text":1067},{"id":1093,"depth":1489,"text":1094},{"id":1142,"depth":1489,"text":1143},{"id":1209,"depth":1489,"text":1210},{"id":1239,"depth":1489,"text":1240},{"id":1287,"depth":1489,"text":1288},{"id":1317,"depth":1489,"text":1318},{"id":1372,"depth":1489,"text":1373},{"id":1388,"depth":1489,"text":1389},{"id":1445,"depth":1489,"text":1446},{"id":1465,"depth":1489,"text":1466},"How the local worker and a remote machine run steps, share slots and groups, go offline, hand work back, and carry on when the server is gone.","md",null,{},true,{"title":68,"description":1507},"3lLeEf6pyqjWI-ItqlWhVdP8sJ3WsoTKPp2ROjQPp_Q",[1515,1517],{"title":64,"path":65,"stem":66,"description":1516,"children":-1},"What a repo's targeted test command is handed, how scopes that share a concurrency group queue on a machine, and how test-selection state carries from one worktree to the next.",{"title":10,"path":73,"stem":77,"description":1518,"children":-1},"Task-focused how-tos for driving, extending and reaching Kraft.",1794749025016]