[{"data":1,"prerenderedAt":1875},["ShallowReactive",2],{"navigation_docs":3,"-reference-cli-worker":639,"-reference-cli-worker-surround":1870},[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":365,"body":641,"description":1863,"extension":1864,"links":1865,"meta":1866,"navigation":1867,"path":366,"seo":1868,"stem":367,"__hash__":1869},"docs\u002F5.reference\u002F01.cli\u002F7.worker.md",{"type":642,"value":643,"toc":1844},"minimark",[644,674,679,866,870,874,887,918,957,963,967,982,1000,1147,1152,1156,1165,1178,1319,1341,1346,1350,1359,1365,1370,1374,1383,1393,1398,1402,1411,1417,1429,1452,1457,1461,1470,1473,1519,1526,1531,1535,1544,1547,1578,1583,1587,1596,1601,1666,1686,1691,1695,1704,1707,1751,1774,1779,1783,1792,1809,1814,1818,1827],[645,646,647,651,652,656,657,660,661,664,665,668,669,673],"p",{},[648,649,650],"code",{},"kraft admin worker"," registers machines and runs their side of the connection. The ",[653,654,655],"a",{"href":358},"server",", ",[653,658,659],{"href":362},"add-on"," and ",[653,662,663],{"href":370},"forge"," verbs are on their own pages. Every verb here accepts ",[648,666,667],{},"--json","; the exceptions are in ",[653,670,672],{"href":671},"\u002Freference\u002Fcli#output-format","Output format",".",[675,676,678],"h2",{"id":677},"verbs-at-a-glance","Verbs at a glance",[680,681,682,695],"table",{},[683,684,685],"thead",{},[686,687,688,692],"tr",{},[689,690,691],"th",{},"Verb",[689,693,694],{},"What it does",[696,697,698,716,731,746,761,776,791,806,821,836,851],"tbody",{},[686,699,700,709],{},[701,702,703],"td",{},[653,704,706],{"href":705},"\u002Freference\u002Fcli\u002Fworker#admin-worker-add",[648,707,708],{},"admin worker add",[701,710,711,712],{},"Registers a machine; a dial-in one gets a token. ",[713,714,715],"em",{},"Added in 2.4",[686,717,718,726],{},[701,719,720],{},[653,721,723],{"href":722},"\u002Freference\u002Fcli\u002Fworker#admin-worker-edit",[648,724,725],{},"admin worker edit",[701,727,728,729],{},"Changes a machine; the rest stays. ",[713,730,715],{},[686,732,733,741],{},[701,734,735],{},[653,736,738],{"href":737},"\u002Freference\u002Fcli\u002Fworker#admin-worker-enable",[648,739,740],{},"admin worker enable",[701,742,743,744],{},"Lets a machine take new steps again. ",[713,745,715],{},[686,747,748,756],{},[701,749,750],{},[653,751,753],{"href":752},"\u002Freference\u002Fcli\u002Fworker#admin-worker-disable",[648,754,755],{},"admin worker disable",[701,757,758,759],{},"Takes no new steps on a machine; running ones finish. ",[713,760,715],{},[686,762,763,771],{},[701,764,765],{},[653,766,768],{"href":767},"\u002Freference\u002Fcli\u002Fworker#admin-worker-rotate-token",[648,769,770],{},"admin worker rotate-token",[701,772,773,774],{},"A new token for a dial-in machine. ",[713,775,715],{},[686,777,778,786],{},[701,779,780],{},[653,781,783],{"href":782},"\u002Freference\u002Fcli\u002Fworker#admin-worker-list",[648,784,785],{},"admin worker list",[701,787,788,789],{},"The machines, online or offline and why. ",[713,790,715],{},[686,792,793,801],{},[701,794,795],{},[653,796,798],{"href":797},"\u002Freference\u002Fcli\u002Fworker#admin-worker-remove",[648,799,800],{},"admin worker remove",[701,802,803,804],{},"Forgets a machine and ends its connection. ",[713,805,715],{},[686,807,808,816],{},[701,809,810],{},[653,811,813],{"href":812},"\u002Freference\u002Fcli\u002Fworker#admin-worker-serve",[648,814,815],{},"admin worker serve",[701,817,818,819],{},"On a machine: connects to a server. ",[713,820,715],{},[686,822,823,831],{},[701,824,825],{},[653,826,828],{"href":827},"\u002Freference\u002Fcli\u002Fworker#admin-worker-check",[648,829,830],{},"admin worker check",[701,832,833,834],{},"On a machine: what it has for running steps. ",[713,835,715],{},[686,837,838,846],{},[701,839,840],{},[653,841,843],{"href":842},"\u002Freference\u002Fcli\u002Fworker#admin-worker-attach",[648,844,845],{},"admin worker attach",[701,847,848,849],{},"Run by Kraft: a remote step's local process. ",[713,850,715],{},[686,852,853,861],{},[701,854,855],{},[653,856,858],{"href":857},"\u002Freference\u002Fcli\u002Fworker#admin-worker-local",[648,859,860],{},"admin worker local",[701,862,863,864],{},"Run by the server: the local worker. ",[713,865,715],{},[675,867,869],{"id":868},"machines","Machines",[645,871,872],{},[713,873,715],{},[645,875,876,878,879,883,884,886],{},[648,877,650],{}," manages the machines that may run work item steps, listed in ",[653,880,881],{"href":484},[648,882,483],{},". A connected machine runs the steps that work items place on it. Kraft runs ",[648,885,845],{}," itself, as the local process of a step on a machine; you don't run it.",[645,888,889,656,892,656,895,656,898,656,901,656,904,660,907,910,911,660,914,917],{},[648,890,891],{},"add",[648,893,894],{},"edit",[648,896,897],{},"enable",[648,899,900],{},"disable",[648,902,903],{},"rotate-token",[648,905,906],{},"list",[648,908,909],{},"remove"," ask the running server, which owns the file. ",[648,912,913],{},"serve",[648,915,916],{},"check"," run on the machine itself.",[680,919,920,930],{},[683,921,922],{},[686,923,924,927],{},[689,925,926],{},"Refusal",[689,928,929],{},"Cause",[696,931,932],{},[686,933,934,939],{},[701,935,936],{},[648,937,938],{},"403",[701,940,941,942,656,944,656,946,656,948,656,950,656,952,954,955,673],{},"A Kraft session runs ",[648,943,891],{},[648,945,894],{},[648,947,897],{},[648,949,900],{},[648,951,903],{},[648,953,906],{}," or ",[648,956,909],{},[958,959,961],"h3",{"id":960},"admin-worker-add",[648,962,708],{},[645,964,965],{},[713,966,715],{},[968,969,975],"pre",{"className":970,"code":972,"language":973,"meta":974},[971],"language-text","kraft admin worker add [flags] NAME\n","text","",[648,976,977],{"__ignoreMap":974},[978,979,972],"span",{"className":980},[981],"line",[645,983,984,985,988,989,660,992,995,996,999],{},"Registers a machine. ",[648,986,987],{},"NAME"," is lowercase letters, digits, ",[648,990,991],{},"-",[648,993,994],{},"_",". A dial-in one prints its token once, then the command to run on it. With ",[648,997,998],{},"--ssh HOST"," the server connects once and exits 1 if it can't; the machine stays registered.",[680,1001,1002,1018],{},[683,1003,1004],{},[686,1005,1006,1009,1012,1015],{},[689,1007,1008],{},"Flag",[689,1010,1011],{},"Type",[689,1013,1014],{},"Default",[689,1016,1017],{},"Meaning",[696,1019,1020,1036,1057,1084,1100,1127],{},[686,1021,1022,1027,1030,1033],{},[701,1023,1024],{},[648,1025,1026],{},"--ssh",[701,1028,1029],{},"host or ssh config alias",[701,1031,1032],{},"none: the machine dials in",[701,1034,1035],{},"A host or ssh config alias for the server to dial.",[686,1037,1038,1043,1046,1054],{},[701,1039,1040],{},[648,1041,1042],{},"--capacity",[701,1044,1045],{},"integer",[701,1047,1048,1049,1053],{},"the machine's own ",[653,1050,1052],{"href":1051},"\u002Fconcepts\u002Fhow-workers-and-machines-behave#the-machines-own-limit","limit",", else 1",[701,1055,1056],{},"The most sessions it may run at once. The lower of this and the machine's own limit applies.",[686,1058,1059,1064,1067,1070],{},[701,1060,1061],{},[648,1062,1063],{},"--group",[701,1065,1066],{},"group name, repeatable",[701,1068,1069],{},"none",[701,1071,1072,1073,1076,1077,1081,1082],{},"Put it in group G, which a step's ",[648,1074,1075],{},"runner:"," can name. See ",[653,1078,1080],{"href":1079},"\u002Fconcepts\u002Fhow-workers-and-machines-behave#groups","Groups",". ",[713,1083,715],{},[686,1085,1086,1091,1094,1097],{},[701,1087,1088],{},[648,1089,1090],{},"--repos",[701,1092,1093],{},"repo IDs, names or directory names, comma-separated",[701,1095,1096],{},"every repo",[701,1098,1099],{},"Limit it to these connected repos.",[686,1101,1102,1107,1122,1124],{},[701,1103,1104],{},[648,1105,1106],{},"--give-up-after",[701,1108,1109,1110,656,1113,656,1116,954,1119],{},"duration: ",[648,1111,1112],{},"2h",[648,1114,1115],{},"30m",[648,1117,1118],{},"1d",[648,1120,1121],{},"never",[701,1123,1069],{},[701,1125,1126],{},"How long a vanished machine's work is waited for.",[686,1128,1129,1134,1137,1140],{},[701,1130,1131],{},[648,1132,1133],{},"--disabled",[701,1135,1136],{},"switch",[701,1138,1139],{},"off",[701,1141,1142,1143,1081,1145],{},"Register it taking no new steps, until ",[648,1144,897],{},[713,1146,715],{},[958,1148,1150],{"id":1149},"admin-worker-edit",[648,1151,725],{},[645,1153,1154],{},[713,1155,715],{},[968,1157,1160],{"className":1158,"code":1159,"language":973,"meta":974},[971],"kraft admin worker edit [flags] NAME\n",[648,1161,1162],{"__ignoreMap":974},[978,1163,1159],{"className":1164},[981],[645,1166,1167,1168,1171,1172,1174,1175,1177],{},"Changes a machine, or ",[648,1169,1170],{},"local",": only the flags you give, and applies from the next step. With no flag it exits 2. ",[648,1173,1170],{}," takes only ",[648,1176,1042],{}," and the groups.",[680,1179,1180,1192],{},[683,1181,1182],{},[686,1183,1184,1186,1188,1190],{},[689,1185,1008],{},[689,1187,1011],{},[689,1189,1014],{},[689,1191,1017],{},[696,1193,1194,1217,1241,1254,1270,1282,1306],{},[686,1195,1196,1200,1205,1208],{},[701,1197,1198],{},[648,1199,1042],{},[701,1201,1202,1203],{},"integer or ",[648,1204,1069],{},[701,1206,1207],{},"unchanged",[701,1209,1210,1211,1213,1214,1216],{},"The most sessions it may run at once. ",[648,1212,1069],{}," drops the cap: the machine's own limit applies (for ",[648,1215,1170],{},", no limit).",[686,1218,1219,1223,1233,1235],{},[701,1220,1221],{},[648,1222,1106],{},[701,1224,1109,1225,656,1227,656,1229,954,1231],{},[648,1226,1112],{},[648,1228,1115],{},[648,1230,1118],{},[648,1232,1121],{},[701,1234,1207],{},[701,1236,1237,1238,1240],{},"As for ",[648,1239,891],{},". The machine learns the new value the next time it connects; the server uses it at once.",[686,1242,1243,1247,1249,1251],{},[701,1244,1245],{},[648,1246,1063],{},[701,1248,1066],{},[701,1250,1207],{},[701,1252,1253],{},"Its groups become exactly these.",[686,1255,1256,1261,1263,1265],{},[701,1257,1258],{},[648,1259,1260],{},"--no-groups",[701,1262,1136],{},[701,1264,1139],{},[701,1266,1267,1268,673],{},"Take it out of every group. Not with ",[648,1269,1063],{},[686,1271,1272,1276,1278,1280],{},[701,1273,1274],{},[648,1275,1090],{},[701,1277,1093],{},[701,1279,1207],{},[701,1281,1099],{},[686,1283,1284,1289,1291,1293],{},[701,1285,1286],{},[648,1287,1288],{},"--every-repo",[701,1290,1136],{},[701,1292,1139],{},[701,1294,1295,1296,1081,1298,1301,1302,1305],{},"Lift the repo limit. Not with ",[648,1297,1090],{},[648,1299,1300],{},"--repos all"," would name a repo called ",[648,1303,1304],{},"all",", so this is a flag of its own.",[686,1307,1308,1312,1314,1316],{},[701,1309,1310],{},[648,1311,1026],{},[701,1313,1029],{},[701,1315,1207],{},[701,1317,1318],{},"A new host for a machine Kraft dials.",[680,1320,1321,1329],{},[683,1322,1323],{},[686,1324,1325,1327],{},[689,1326,926],{},[689,1328,929],{},[696,1330,1331],{},[686,1332,1333,1338],{},[701,1334,1335,1336],{},"A refused ",[648,1337,1026],{},[701,1339,1340],{},"The machine dials in, or a step runs on it, since a new host drops the connection.",[958,1342,1344],{"id":1343},"admin-worker-enable",[648,1345,740],{},[645,1347,1348],{},[713,1349,715],{},[968,1351,1354],{"className":1352,"code":1353,"language":973,"meta":974},[971],"kraft admin worker enable [flags] NAME\n",[648,1355,1356],{"__ignoreMap":974},[978,1357,1353],{"className":1358},[981],[645,1360,1361,1362,1364],{},"Lets a machine, or ",[648,1363,1170],{},", take new steps again. It takes no flags.",[958,1366,1368],{"id":1367},"admin-worker-disable",[648,1369,755],{},[645,1371,1372],{},[713,1373,715],{},[968,1375,1378],{"className":1376,"code":1377,"language":973,"meta":974},[971],"kraft admin worker disable [flags] NAME\n",[648,1379,1380],{"__ignoreMap":974},[978,1381,1377],{"className":1382},[981],[645,1384,1385,1386,1388,1389,673],{},"Stops new steps starting on a machine, or on ",[648,1387,1170],{},"; running steps finish, nothing new starts. It takes no flags. See ",[653,1390,1392],{"href":1391},"\u002Fconcepts\u002Fhow-workers-and-machines-behave#disabling-a-machine","Disabling a machine",[958,1394,1396],{"id":1395},"admin-worker-rotate-token",[648,1397,770],{},[645,1399,1400],{},[713,1401,715],{},[968,1403,1406],{"className":1404,"code":1405,"language":973,"meta":974},[971],"kraft admin worker rotate-token [flags] NAME\n",[648,1407,1408],{"__ignoreMap":974},[978,1409,1405],{"className":1410},[981],[645,1412,1413,1414,1416],{},"A new token for a dial-in machine, printed once with the ",[648,1415,913],{}," command. The old one stops working at once. It takes no flags.",[645,1418,1419,1421,1422,1425,1426,1428],{},[648,1420,903],{}," ends the machine's connection; steps running on it wait for it, up to its ",[648,1423,1424],{},"give_up_after",", until ",[648,1427,913],{}," runs with the new token.",[680,1430,1431,1439],{},[683,1432,1433],{},[686,1434,1435,1437],{},[689,1436,926],{},[689,1438,929],{},[696,1440,1441],{},[686,1442,1443,1446],{},[701,1444,1445],{},"Refused by the server",[701,1447,1448,1449,1451],{},"An ssh machine and ",[648,1450,1170],{}," have no token.",[958,1453,1455],{"id":1454},"admin-worker-list",[648,1456,785],{},[645,1458,1459],{},[713,1460,715],{},[968,1462,1465],{"className":1463,"code":1464,"language":973,"meta":974},[971],"kraft admin worker list [flags]\n",[648,1466,1467],{"__ignoreMap":974},[978,1468,1464],{"className":1469},[981],[645,1471,1472],{},"Each machine: mode, online or offline and why, slots, groups, repos, last seen and Kraft version. It takes no flags.",[645,1474,1475,1476,1081,1479,1482,1483,656,1486,1489,1490,1081,1493,1482,1496,656,1499,1502,1503,1506,1507,1081,1509,1511,1512,1518],{},"Columns ",[648,1477,1478],{},"NAME MODE STATE SLOTS GROUPS REPOS LAST SEEN VERSION",[648,1480,1481],{},"STATE",": ",[648,1484,1485],{},"online",[648,1487,1488],{},"offline:"," and why, or ",[648,1491,1492],{},"disabled",[648,1494,1495],{},"SLOTS",[648,1497,1498],{},"1 of 2",[648,1500,1501],{},"(machine)"," for a lower own limit, ",[648,1504,1505],{},"2 · no limit"," for ",[648,1508,1170],{},[648,1510,667],{}," prints the ",[653,1513,1515],{"href":1514},"\u002Freference\u002Fhttp-api#the-schema",[648,1516,1517],{},"GET \u002Fapi\u002Fworkers"," answer.",[645,1520,1521,1522,1525],{},"A disabled machine that is also out of reach reads ",[648,1523,1524],{},"disabled · offline:"," and the reason.",[958,1527,1529],{"id":1528},"admin-worker-remove",[648,1530,800],{},[645,1532,1533],{},[713,1534,715],{},[968,1536,1539],{"className":1537,"code":1538,"language":973,"meta":974},[971],"kraft admin worker remove [flags] NAME\n",[648,1540,1541],{"__ignoreMap":974},[978,1542,1538],{"className":1543},[981],[645,1545,1546],{},"Forgets the machine. Its token or ssh entry stops working and its connection ends. It takes no flags.",[680,1548,1549,1557],{},[683,1550,1551],{},[686,1552,1553,1555],{},[689,1554,926],{},[689,1556,929],{},[696,1558,1559,1567],{},[686,1560,1561,1564],{},[701,1562,1563],{},"Refused, naming the items",[701,1565,1566],{},"A step runs on the machine: disable it and remove it once they end. A step held by an offline machine is freed by pausing or cancelling its item.",[686,1568,1569,1572],{},[701,1570,1571],{},"Refused",[701,1573,1574,1575,1577],{},"The machine is ",[648,1576,1170],{},", which can't be removed.",[958,1579,1581],{"id":1580},"admin-worker-serve",[648,1582,815],{},[645,1584,1585],{},[713,1586,715],{},[968,1588,1591],{"className":1589,"code":1590,"language":973,"meta":974},[971],"kraft admin worker serve [flags]\n",[648,1592,1593],{"__ignoreMap":974},[978,1594,1590],{"className":1595},[981],[645,1597,1598,1599,673],{},"On a machine: connects to a server and stays connected. It takes no ",[648,1600,667],{},[680,1602,1603,1615],{},[683,1604,1605],{},[686,1606,1607,1609,1611,1613],{},[689,1608,1008],{},[689,1610,1011],{},[689,1612,1014],{},[689,1614,1017],{},[696,1616,1617,1632,1652],{},[686,1618,1619,1624,1627,1629],{},[701,1620,1621],{},[648,1622,1623],{},"--server",[701,1625,1626],{},"URL",[701,1628,1069],{},[701,1630,1631],{},"Dials that server and stays connected, redialling after a drop until you press Ctrl-C.",[686,1633,1634,1639,1641,1643],{},[701,1635,1636],{},[648,1637,1638],{},"--token",[701,1640,973],{},[701,1642,1069],{},[701,1644,1645,1646,1649,1650,673],{},"The token ",[648,1647,1648],{},"worker add"," printed, for ",[648,1651,1623],{},[686,1653,1654,1659,1661,1663],{},[701,1655,1656],{},[648,1657,1658],{},"--stdio",[701,1660,1136],{},[701,1662,1139],{},[701,1664,1665],{},"Speaks on standard input and output instead; the server runs it over ssh, and you don't run it by hand.",[645,1667,1668,1669,660,1671,1673,1674,656,1677,656,1680,954,1683,673],{},"Exactly one of ",[648,1670,1623],{},[648,1672,1658],{}," is required. It prints one line per outcome to stderr: ",[648,1675,1676],{},"connected as NAME",[648,1678,1679],{},"refused: ...",[648,1681,1682],{},"disconnected: ...",[648,1684,1685],{},"cannot connect: ...",[958,1687,1689],{"id":1688},"admin-worker-check",[648,1690,830],{},[645,1692,1693],{},[713,1694,715],{},[968,1696,1699],{"className":1697,"code":1698,"language":973,"meta":974},[971],"kraft admin worker check [flags]\n",[648,1700,1701],{"__ignoreMap":974},[978,1702,1698],{"className":1703},[981],[645,1705,1706],{},"On a machine: reports what it has for running steps, sandbox backends included.",[680,1708,1709,1721],{},[683,1710,1711],{},[686,1712,1713,1715,1717,1719],{},[689,1714,1008],{},[689,1716,1011],{},[689,1718,1014],{},[689,1720,1017],{},[696,1722,1723,1736],{},[686,1724,1725,1729,1731,1733],{},[701,1726,1727],{},[648,1728,1623],{},[701,1730,1626],{},[701,1732,1069],{},[701,1734,1735],{},"Also tries a handshake with that server.",[686,1737,1738,1742,1744,1746],{},[701,1739,1740],{},[648,1741,1638],{},[701,1743,973],{},[701,1745,1069],{},[701,1747,1748,1749,673],{},"The token for ",[648,1750,1623],{},[645,1752,1753,1755,1756,1762,1763,1766,1767,1770,1771,1773],{},[648,1754,916],{}," prints one line per finding, as ",[653,1757,1759],{"href":1758},"\u002Freference\u002Fcli\u002Fserver#what-doctor-checks",[648,1760,1761],{},"doctor"," does. It fails, and exits 1, when ",[648,1764,1765],{},"git"," is missing, when none of Kraft's agent CLIs is on ",[648,1768,1769],{},"PATH",", or when ",[648,1772,1623],{}," is given and the handshake fails. A missing credential variable or sandbox runtime is a warning only, because an agent CLI can keep its login in a store this check can't see.",[958,1775,1777],{"id":1776},"admin-worker-attach",[648,1778,845],{},[645,1780,1781],{},[713,1782,715],{},[968,1784,1787],{"className":1785,"code":1786,"language":973,"meta":974},[971],"kraft admin worker attach [flags]\n",[648,1788,1789],{"__ignoreMap":974},[978,1790,1786],{"className":1791},[981],[645,1793,1794,1795,1798,1799,1802,1803,1806,1807,673],{},"Run by Kraft, not by hand: the local process of a step that runs on a machine, carrying its log and signals. ",[648,1796,1797],{},"--run-dir"," (the server's run directory), ",[648,1800,1801],{},"--item"," (the work item ID) and ",[648,1804,1805],{},"--session"," (the session ID) are all required. It takes no ",[648,1808,667],{},[958,1810,1812],{"id":1811},"admin-worker-local",[648,1813,860],{},[645,1815,1816],{},[713,1817,715],{},[968,1819,1822],{"className":1820,"code":1821,"language":973,"meta":974},[971],"kraft admin worker local [flags]\n",[648,1823,1824],{"__ignoreMap":974},[978,1825,1821],{"className":1826},[981],[645,1828,1829,1830,1832,1833,1836,1837,1839,1840,673],{},"Run by the server, not by hand: the local worker that starts every local session. ",[648,1831,1797],{}," (the server's run directory) is required; ",[648,1834,1835],{},"--install"," names the install ID its socket is named for, the server's. It takes no ",[648,1838,667],{},". See ",[653,1841,1843],{"href":1842},"\u002Fconcepts\u002Fhow-workers-and-machines-behave#the-local-worker","The local worker",{"title":974,"searchDepth":1845,"depth":1845,"links":1846},2,[1847,1848],{"id":677,"depth":1845,"text":678},{"id":868,"depth":1845,"text":869,"children":1849},[1850,1852,1853,1854,1855,1857,1858,1859,1860,1861,1862],{"id":960,"depth":1851,"text":708},3,{"id":1149,"depth":1851,"text":725},{"id":1343,"depth":1851,"text":740},{"id":1367,"depth":1851,"text":755},{"id":1395,"depth":1851,"text":1856},"admin worker rotate-​token",{"id":1454,"depth":1851,"text":785},{"id":1528,"depth":1851,"text":800},{"id":1580,"depth":1851,"text":815},{"id":1688,"depth":1851,"text":830},{"id":1776,"depth":1851,"text":845},{"id":1811,"depth":1851,"text":860},"The kraft admin worker verbs: register, change and remove the machines that run steps, and run a machine's side.","md",null,{},true,{"title":365,"description":1863},"U2nYKGMihYASfIO6n581fNsC1iNVARWieh5biAgxXeI",[1871,1873],{"title":361,"path":362,"stem":363,"description":1872,"children":-1},"The kraft admin addon verbs: add collections, install, update, remove and validate add-ons.",{"title":369,"path":370,"stem":371,"description":1874,"children":-1},"The kraft admin forge verbs: name, edit, list, remove and test forge accounts.",1794749037824]