[{"data":1,"prerenderedAt":1481},["ShallowReactive",2],{"navigation_docs":3,"-troubleshooting-forge-stops":639,"-troubleshooting-forge-stops-surround":1476},[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":254,"body":641,"description":1469,"extension":1470,"links":1471,"meta":1472,"navigation":1473,"path":255,"seo":1474,"stem":256,"__hash__":1475},"docs\u002F4.troubleshooting\u002F04.forge-stops.md",{"type":642,"value":643,"toc":1454},"minimark",[644,663,668,1053,1059,1195,1198,1213,1221,1233,1267,1273,1298,1303,1317,1335,1341,1344,1348,1365,1381,1398,1403,1408,1430,1433,1437,1450],[645,646,647,648,653,654,658,659,662],"p",{},"A ",[649,650,652],"a",{"href":651},"\u002Fconcepts\u002Fvocabulary#forge","forge"," task opens, syncs or merges the merge request, and git pushes and fetches the branch. The first column is the text the board and ",[655,656,657],"code",{},"kraft view show ID"," print. ",[655,660,661],{},"..."," stands for text that varies. A row either holds the whole fix or links to an entry below.",[664,665,667],"h2",{"id":666},"find-your-reason","Find your reason",[669,670,671,687],"table",{},[672,673,674],"thead",{},[675,676,677,681,684],"tr",{},[678,679,680],"th",{},"The reason says",[678,682,683],{},"What happened",[678,685,686],{},"Fix",[688,689,690,753,791,825,858,886,930,955,980,999,1027],"tbody",{},[675,691,692,716,734],{},[693,694,695,696,699,700,699,703,699,706,699,709,712,713],"td",{},"A forge task, or a git push or fetch, failed and the log shows ",[655,697,698],{},"HTTP 401",", ",[655,701,702],{},"Bad credentials",[655,704,705],{},"Authentication failed",[655,707,708],{},"could not read Username",[655,710,711],{},"Permission denied (publickey)"," or ",[655,714,715],{},"gh auth login",[693,717,718,719,722,723,726,727,699,730,733],{},"With ",[655,720,721],{},"client: cli"," or a ",[655,724,725],{},"git-credential"," token, Kraft holds no forge token, and the forge refused what ",[655,728,729],{},"gh",[655,731,732],{},"glab"," or git sent.",[693,735,736,737,739,740,743,744,747,748,752],{},"Run ",[655,738,715],{}," (",[655,741,742],{},"glab auth login"," for GitLab), then ",[655,745,746],{},"kraft item retry ID",". See ",[649,749,751],{"href":750},"#forge-authentication-fails","Forge authentication fails",".",[675,754,755,774,784],{},[693,756,757,758,761,762,765,766,769,770],{},"A forge task failed, and the stop's ",[655,759,760],{},"facts.cause"," is ",[655,763,764],{},"forge_auth"," with an ",[655,767,768],{},"sso_url"," fact ",[771,772,773],"em",{},"Added in 2.5",[693,775,776,777,779,780,783],{},"The forge accepted the token but wants it authorised for single sign-on. ",[655,778,768],{}," is the page that does it. Kraft keeps only a plain ",[655,781,782],{},"https:\u002F\u002F"," address.",[693,785,786,787,747,789,752],{},"Open the address and authorise the token, then run ",[655,788,746],{},[649,790,751],{"href":750},[675,792,793,804,814],{},[693,794,757,795,761,797,765,799,769,802],{},[655,796,760],{},[655,798,764],{},[655,800,801],{},"account",[771,803,773],{},[693,805,647,806,809,810,813],{},[655,807,808],{},"client: api"," account's token was refused or couldn't be read. ",[655,811,812],{},"facts.source"," says where it is read from.",[693,815,816,817,820,821,747,823,752],{},"Replace the token there, restart the server for an ",[655,818,819],{},"env"," one, then run ",[655,822,746],{},[649,824,751],{"href":750},[675,826,827,848,851],{},[693,828,829,830,833,834,837,838,841,842,845,846],{},"A forge task failed with ",[655,831,832],{},"HTTP 429",", or with ",[655,835,836],{},"HTTP 403"," and ",[655,839,840],{},"rate limit"," in the log, and the item shows ",[655,843,844],{},"rate_limited"," instead of a stop ",[771,847,773],{},[693,849,850],{},"The forge asked Kraft to wait. Kraft starts the item again when the forge allows it: at the time the forge named, else after a minute.",[693,852,853,854,752],{},"Nothing. See ",[649,855,857],{"href":856},"#a-forge-rate-limit","A forge rate limit",[675,859,860,878,881],{},[693,861,862,863,699,866,712,869,872,873,761,875,752],{},"The log shows ",[655,864,865],{},"Could not resolve host",[655,867,868],{},"Connection timed out",[655,870,871],{},"Connection refused"," on a forge or git call. The stop's ",[655,874,760],{},[655,876,877],{},"forge_unreachable",[693,879,880],{},"The machine the server runs on couldn't reach the forge.",[693,882,883,884,752],{},"Check that machine's network, DNS and proxy settings, then run ",[655,885,746],{},[675,887,888,906,909],{},[693,889,890,893,894,699,897,712,900,903,904],{},[655,891,892],{},"could not start ..."," with ",[655,895,896],{},"gh is not installed or not on PATH",[655,898,899],{},"glab could not start: ...",[655,901,902],{},"git cannot run in \u003Cfolder>: it does not exist"," ",[771,905,773],{},[693,907,908],{},"A forge task's CLI never started on the server's machine: it is missing or can't run there, or the item's worktree is gone.",[693,910,911,912,712,914,916,917,919,920,922,923,926,927,752],{},"Install ",[655,913,729],{},[655,915,732],{}," on that machine, set ",[655,918,808],{}," on the repo's forge account, or put the folder back, then run ",[655,921,746],{},". ",[655,924,925],{},"kraft admin doctor"," checks that the CLI is on ",[655,928,929],{},"PATH",[675,931,932,939,946],{},[693,933,934,893,936],{},[655,935,892],{},[655,937,938],{},"cannot run: backend: auto, but no forge is recorded for this repo",[693,940,941,942,945],{},"The repo had no GitHub or GitLab ",[655,943,944],{},"origin"," when you connected it.",[693,947,948,949,752],{},"See ",[649,950,952],{"href":951},"#no-forge-is-recorded-for-this-repo",[655,953,954],{},"no forge is recorded for this repo",[675,956,957,964,967],{},[693,958,959,903,962],{},[655,960,961],{},"forge account NAME: ...'s push URL is not on ORIGIN, the account's address, so Kraft will not send its token there",[771,963,773],{},[693,965,966],{},"The push URL points off the account's address.",[693,968,969,970,973,974,747,976,752],{},"Point ",[655,971,972],{},"pushurl"," at the account's address or an SSH address, then run ",[655,975,746],{},[649,977,979],{"href":978},"#kraft-wont-send-the-token-to-another-address","Kraft won't send the token to another address",[675,981,982,989,992],{},[693,983,984,903,987],{},[655,985,986],{},"forge account NAME: origin redirects elsewhere; point origin at the new address, then retry",[771,988,773],{},[693,990,991],{},"A git push or fetch with the account's token met a redirect. Kraft never follows one with the token.",[693,993,969,994,996,997,752],{},[655,995,944],{}," at the new address, then run ",[655,998,746],{},[675,1000,1001,1008,1011],{},[693,1002,1003,903,1006],{},[655,1004,1005],{},"forge account NAME: git could not verify origin's certificate; set ca_file on the account, or http.sslCAInfo in your global gitconfig, then retry",[771,1007,773],{},[693,1009,1010],{},"Kraft pins the CA git trusts for a call that sends the token, and none of its sources trusts the origin's certificate.",[693,1012,1013,1014,1017,1018,1020,1021,1024,1025,752],{},"Set ",[655,1015,1016],{},"ca_file"," on the account in ",[655,1019,487],{},", or ",[655,1022,1023],{},"http.sslCAInfo"," in your global gitconfig, then run ",[655,1026,746],{},[675,1028,1029,1037,1045],{},[693,1030,1031,1034,1035],{},[655,1032,1033],{},"repos.yaml does not load (...); fix it, then retry"," on a git call ",[771,1036,773],{},[693,1038,647,1039,1041,1042,1044],{},[655,1040,808],{}," account sends a token, and without ",[655,1043,387],{}," Kraft can't tell which repo uses it. SSH and local remotes aren't stopped.",[693,1046,1047,1048,1050,1051,752],{},"Fix ",[655,1049,387],{},", then run ",[655,1052,746],{},[664,1054,1056,1057],{"id":1055},"the-account-in-forgesyaml","The account in ",[655,1058,487],{},[669,1060,1061,1071],{},[672,1062,1063],{},[675,1064,1065,1067,1069],{},[678,1066,680],{},[678,1068,683],{},[678,1070,686],{},[688,1072,1073,1117,1148,1171],{},[675,1074,1075,1094,1109],{},[693,1076,1077,893,1080,699,1083,699,1086,712,1089,903,1092],{},[655,1078,1079],{},"cannot run: forge account \u003Cname> ...",[655,1081,1082],{},"was removed",[655,1084,1085],{},"now says forge: \u003Cf>, was \u003Cg>",[655,1087,1088],{},"now says client: \u003Capi or cli>, was client: \u003Ccli or api>",[655,1090,1091],{},"is pinned to \u003Ccli>, the repo now says forge: \u003Cf>",[771,1093,773],{},[693,1095,1096,1097,1099,1100,712,1102,1105,1106,1108],{},"The item keeps the ",[649,1098,487],{"href":488}," account it first used, and the config now differs: the account is gone, its ",[655,1101,652],{},[655,1103,1104],{},"client"," changed, or the repo's ",[655,1107,652],{}," changed.",[693,1110,736,1111,1113,1114,1116],{},[655,1112,746],{},". It re-pins the item to the current config. To keep the old one, restore the account or the repo's ",[655,1115,652],{}," first.",[675,1118,1119,1126,1137],{},[693,1120,1121,903,1124],{},[655,1122,1123],{},"cannot run: forge_account \u003Cname> names no account in forges.yaml",[771,1125,773],{},[693,1127,1128,1129,712,1131,1133,1134,1136],{},"The repo names an account the file lacks. A repo not yet pinned never falls back silently to ",[655,1130,729],{},[655,1132,732],{},"; a pinned repo keeps its pin. ",[655,1135,925],{}," names the account.",[693,1138,1139,1140,1143,1144,1050,1146,752],{},"Add the account, or fix ",[655,1141,1142],{},"forge_account"," in ",[655,1145,387],{},[655,1147,746],{},[675,1149,1150,1157,1162],{},[693,1151,1152,903,1155],{},[655,1153,1154],{},"cannot run: forge_account \u003Cname> says forge: \u003Cf>, the repo says forge: \u003Cg>",[771,1156,773],{},[693,1158,1159,1160,752],{},"The account the repo names is for another forge than the repo's own ",[655,1161,652],{},[693,1163,1164,1165,1143,1167,1050,1169,752],{},"Name an account for the repo's forge, or fix ",[655,1166,652],{},[655,1168,387],{},[655,1170,746],{},[675,1172,1173,1180,1186],{},[693,1174,1175,903,1178],{},[655,1176,1177],{},"cannot run: forges.yaml does not load (\u003Creason>); fix it, then retry",[771,1179,773],{},[693,1181,1182,1183,1116],{},"The server started with a forges.yaml it couldn't read, and the item had not yet pinned this repo. Pinned repos keep running. A repo naming an account says ",[655,1184,1185],{},"forge_account \u003Cname>: ...",[693,1187,1188,1189,1192,1193,752],{},"Fix the file named in the reason, run ",[655,1190,1191],{},"kraft admin reload",", then ",[655,1194,746],{},[664,1196,751],{"id":1197},"forge-authentication-fails",[645,1199,1200,1201,761,1203,1205,1206,1210,1211,752],{},"The forge refused the credentials Kraft sent, or couldn't read the token it was to send. The stop's ",[655,1202,760],{},[655,1204,764],{},", and the card reads ",[1207,1208,1209],"strong",{},"Failed"," with the fix under it. A forge that is only rate limiting Kraft isn't this: see ",[649,1212,857],{"href":856},[1214,1215,1217,1218,1220],"h3",{"id":1216},"on-a-client-cli-account","On a ",[655,1219,721],{}," account",[645,1222,1223,1224,1226,1227,1229,1230,1232],{},"Kraft holds no forge token here. It runs ",[655,1225,729],{}," (GitHub) or ",[655,1228,732],{}," (GitLab), and git, as the user the server runs as. Nothing in Settings › Repos can supply a token. On the machine the server runs on, sign the CLI in, then run ",[655,1231,746],{},":",[1234,1235,1241],"pre",{"className":1236,"code":1237,"language":1238,"meta":1239,"style":1240},"language-bash shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","gh auth login\nglab auth login\n","bash","each","",[655,1242,1243,1258],{"__ignoreMap":1240},[1244,1245,1248,1251,1255],"span",{"class":1246,"line":1247},"line",1,[1244,1249,729],{"class":1250},"szw1H",[1244,1252,1254],{"class":1253},"semJd"," auth",[1244,1256,1257],{"class":1253}," login\n",[1244,1259,1261,1263,1265],{"class":1246,"line":1260},2,[1244,1262,732],{"class":1250},[1244,1264,1254],{"class":1253},[1244,1266,1257],{"class":1253},[645,1268,1269,1270,1272],{},"Use ",[655,1271,732],{}," for a GitLab repo. If it still fails:",[1274,1275,1276,1291],"ol",{},[1277,1278,1279,1280,1283,1284,1287,1288,1290],"li",{},"If git itself can't authenticate, check its credentials: ",[655,1281,1282],{},"gh auth setup-git",", your SSH key or credential helper. ",[655,1285,1286],{},"gh auth status"," shows who the CLI is signed in as. ",[655,1289,925],{}," checks only that the CLI is installed, not that it is signed in.",[1277,1292,1293,1294,1297],{},"If the forge asks for single sign-on, authorise the CLI's token for the organisation on the forge's website. When the forge sent the address of that page, ",[655,1295,1296],{},"facts.sso_url"," carries it and the card ends its fix with it as a link: open it, authorise, then retry.",[1214,1299,1217,1301,1220],{"id":1300},"on-a-client-api-account",[655,1302,808],{},[645,1304,1305,1306,1309,1310,1312,1313,1316],{},"The card reads ",[655,1307,1308],{},"Forge account NAME could not sign in with its token (SOURCE)",". It names the account in ",[649,1311,487],{"href":488}," and where its token is read from, such as ",[655,1314,1315],{},"env CORP_GL"," or a file path. The token was refused, or couldn't be read at all. A git push or base fetch that the token can't authenticate stops the same way.",[1274,1318,1319,1325,1331],{},[1277,1320,1321,1322,1324],{},"Replace the token at that source, or paste a new one in Settings > Forge accounts. An ",[655,1323,819],{}," token is read when the server starts, so restart it.",[1277,1326,736,1327,1330],{},[655,1328,1329],{},"kraft admin forge test NAME"," to see the token accepted.",[1277,1332,736,1333,752],{},[655,1334,746],{},[645,1336,1337,1338,1340],{},"A git call with the token that meets a redirect stops the item, because Kraft never follows a redirect with the token: point ",[655,1339,944],{}," at the new address, then retry. GitHub answers a private repo it won't show a bad token with \"repository not found\", so when Kraft sent the token, that counts as a token problem. On an API account the card names the account whose token needs single sign-on.",[664,1342,857],{"id":1343},"a-forge-rate-limit",[645,1345,1346],{},[771,1347,773],{},[645,1349,1350,1351,1353,1354,1356,1357,1360,1361,1364],{},"The forge answered a call with ",[655,1352,832],{},", or with an ",[655,1355,836],{}," that says it is a rate limit: GitHub's ",[655,1358,1359],{},"X-RateLimit-Remaining: 0",", a ",[655,1362,1363],{},"Retry-After",", or a message naming a rate limit, which is all GitHub's secondary limit may send.",[645,1366,1367,1368,1360,1370,1373,1374,1376,1377,1380],{},"Nothing to do but wait. The forge hasn't refused your credentials, so the item doesn't stop for you: its status is ",[655,1369,844],{},[655,1371,1372],{},"rate_limit_hit"," event records when to come back, and Kraft starts the item again at that time. The time is the forge's ",[655,1375,1363],{}," when it sent one, else when GitHub's spent quota resets (",[655,1378,1379],{},"X-RateLimit-Reset","), else a minute.",[645,1382,1383,1384,712,1386,1388,1389,1391,1392,1395,1396,752],{},"If the limit keeps coming back, the account the server's ",[655,1385,729],{},[655,1387,732],{}," is signed in as, or on a ",[655,1390,808],{}," account its token, is spending its quota elsewhere. Sign in with another account, or give it a token with a higher limit. A ",[655,1393,1394],{},"403"," with none of these signs is still ",[649,1397,751],{"href":750},[664,1399,1401],{"id":1400},"no-forge-is-recorded-for-this-repo",[655,1402,954],{},[645,1404,941,1405,1407],{},[655,1406,944],{}," when you connected it, so Kraft doesn't know which forge CLI to run.",[1274,1409,1410,1426],{},[1277,1411,1013,1412,712,1415,1418,1419,1422,1423,1425],{},[655,1413,1414],{},"forge: github",[655,1416,1417],{},"forge: gitlab"," on the repo in Settings › Repos, then ",[1207,1420,1421],{},"Review & publish"," (or set it in ",[655,1424,387],{},").",[1277,1427,736,1428,752],{},[655,1429,746],{},[664,1431,979],{"id":1432},"kraft-wont-send-the-token-to-another-address",[645,1434,1435],{},[771,1436,773],{},[645,1438,1439,1440,1443,1444,1446,1447,1449],{},"The push URL isn't on the origin of the account's ",[655,1441,1442],{},"web_url",", so Kraft won't send its token there. Point ",[655,1445,972],{}," at the account's address, or at an SSH address, then run ",[655,1448,746],{},". A fetch isn't refused, but carries no token off the account's address.",[1451,1452,1453],"style",{},"html pre.shiki code .szw1H, html code.shiki .szw1H{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFB757}html pre.shiki code .semJd, html code.shiki .semJd{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#ADDCFF}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":1240,"searchDepth":1260,"depth":1260,"links":1455},[1456,1457,1459,1466,1467,1468],{"id":666,"depth":1260,"text":667},{"id":1055,"depth":1260,"text":1458},"The account in forges.​yaml",{"id":1197,"depth":1260,"text":751,"children":1460},[1461,1464],{"id":1216,"depth":1462,"text":1463},3,"On a client: cli account",{"id":1300,"depth":1462,"text":1465},"On a client: api account",{"id":1343,"depth":1260,"text":857},{"id":1400,"depth":1260,"text":954},{"id":1432,"depth":1260,"text":979},"Fix a work item that stopped because the forge refused its credentials, rate-limited it, couldn't be reached, or no longer matches the account the item first used.","md",null,{},true,{"title":254,"description":1469},"RB4toW0r_Pmwu9vHgdHknoYg2GWMfORAh13Oie-iQsE",[1477,1479],{"title":250,"path":251,"stem":252,"description":1478,"children":-1},"Fix a work item that stopped on a dollar, token or time cap, and one that waits on CI, a review, a gate or a machine and nothing moves.",{"title":258,"path":259,"stem":260,"description":1480,"children":-1},"Fix a work item that stopped on a rebase conflict, a worktree git won't rebase or commit in, a branch someone else pushed to, or a branch origin lost.",1794749047556]