[{"data":1,"prerenderedAt":1492},["ShallowReactive",2],{"navigation_docs":3,"-reference-cli-forge":639,"-reference-cli-forge-surround":1487},[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":369,"body":641,"description":1480,"extension":1481,"links":1482,"meta":1483,"navigation":1484,"path":370,"seo":1485,"stem":371,"__hash__":1486},"docs\u002F5.reference\u002F01.cli\u002F8.forge.md",{"type":642,"value":643,"toc":1468},"minimark",[644,677,682,779,783,787,818,824,830,834,849,873,1094,1104,1164,1169,1173,1182,1193,1302,1331,1352,1357,1361,1370,1373,1378,1382,1391,1394,1413,1418,1422,1431,1449],[645,646,647,651,652,654,655,659,660,663,664,667,668,671,672,676],"p",{},[648,649,650],"code",{},"kraft admin forge"," manages the accounts in ",[648,653,487],{},". The ",[656,657,658],"a",{"href":358},"server",", ",[656,661,662],{"href":362},"add-on"," and ",[656,665,666],{"href":366},"machine"," verbs are on their own pages. Every verb here accepts ",[648,669,670],{},"--json","; the exceptions are in ",[656,673,675],{"href":674},"\u002Freference\u002Fcli#output-format","Output format",".",[678,679,681],"h2",{"id":680},"verbs-at-a-glance","Verbs at a glance",[683,684,685,698],"table",{},[686,687,688],"thead",{},[689,690,691,695],"tr",{},[692,693,694],"th",{},"Verb",[692,696,697],{},"What it does",[699,700,701,719,734,749,764],"tbody",{},[689,702,703,712],{},[704,705,706],"td",{},[656,707,709],{"href":708},"\u002Freference\u002Fcli\u002Fforge#admin-forge-add",[648,710,711],{},"admin forge add",[704,713,714,715],{},"Names a forge account. ",[716,717,718],"em",{},"Added in 2.5",[689,720,721,729],{},[704,722,723],{},[656,724,726],{"href":725},"\u002Freference\u002Fcli\u002Fforge#admin-forge-edit",[648,727,728],{},"admin forge edit",[704,730,731,732],{},"Changes an account; only the flags given change. ",[716,733,718],{},[689,735,736,744],{},[704,737,738],{},[656,739,741],{"href":740},"\u002Freference\u002Fcli\u002Fforge#admin-forge-list",[648,742,743],{},"admin forge list",[704,745,746,747],{},"The accounts. ",[716,748,718],{},[689,750,751,759],{},[704,752,753],{},[656,754,756],{"href":755},"\u002Freference\u002Fcli\u002Fforge#admin-forge-remove",[648,757,758],{},"admin forge remove",[704,760,761,762],{},"Forgets an account. ",[716,763,718],{},[689,765,766,774],{},[704,767,768],{},[656,769,771],{"href":770},"\u002Freference\u002Fcli\u002Fforge#admin-forge-test",[648,772,773],{},"admin forge test",[704,775,776,777],{},"Checks an account's sign-in or token. ",[716,778,718],{},[678,780,782],{"id":781},"forge-accounts","Forge accounts",[645,784,785],{},[716,786,718],{},[645,788,789,790,792,793,796,797,800,801,663,804,807,808,811,812,814,815,676],{},"An account in ",[648,791,487],{}," records which forge a host runs and its web address, so ",[648,794,795],{},"kraft repo connect"," doesn't ask about a self-hosted host whose name doesn't say. A ",[648,798,799],{},"client: cli"," account holds no token: ",[648,802,803],{},"gh",[648,805,806],{},"glab"," keep their own sign-in. A ",[648,809,810],{},"client: api"," account reads one from a source; see ",[656,813,487],{"href":488},". A repo names an account with ",[648,816,817],{},"forge_account",[645,819,820,821,823],{},"Every verb asks the server, which owns the file, except a command source, which the CLI writes on disk as ",[648,822,711],{}," says.",[825,826,828],"h3",{"id":827},"admin-forge-add",[648,829,711],{},[645,831,832],{},[716,833,718],{},[835,836,842],"pre",{"className":837,"code":839,"language":840,"meta":841},[838],"language-text","kraft admin forge add [flags] NAME\n","text","",[648,843,844],{"__ignoreMap":841},[845,846,839],"span",{"className":847},[848],"line",[645,850,851,852,855,856,859,860,659,862,663,865,868,869,872],{},"Names a forge account: the host's forge and web address, and for ",[648,853,854],{},"--client api"," where its token comes from. ",[648,857,858],{},"NAME"," is lowercase letters, digits, ",[648,861,676],{},[648,863,864],{},"-",[648,866,867],{},"_",", starting with a letter or digit, so a web host such as ",[648,870,871],{},"code.corp.example"," works.",[683,874,875,891],{},[686,876,877],{},[689,878,879,882,885,888],{},[692,880,881],{},"Flag",[692,883,884],{},"Type",[692,886,887],{},"Default",[692,889,890],{},"Meaning",[699,892,893,915,933,949,965,1001,1021,1050,1069],{},[689,894,895,900,909,912],{},[704,896,897],{},[648,898,899],{},"--forge",[704,901,902,905,906],{},[648,903,904],{},"github"," or ",[648,907,908],{},"gitlab",[704,910,911],{},"none given: required",[704,913,914],{},"The host's forge.",[689,916,917,922,928,930],{},[704,918,919],{},[648,920,921],{},"--web-url",[704,923,924,927],{},[648,925,926],{},"https:\u002F\u002F"," URL",[704,929,911],{},[704,931,932],{},"The forge's web address.",[689,934,935,940,943,946],{},[704,936,937],{},[648,938,939],{},"--api-url",[704,941,942],{},"URL",[704,944,945],{},"the forge's usual one",[704,947,948],{},"Must share the web address's origin (host and port).",[689,950,951,956,959,962],{},[704,952,953],{},[648,954,955],{},"--default-for-host",[704,957,958],{},"switch",[704,960,961],{},"off",[704,963,964],{},"Makes the account the one repos on that host use unless they name another.",[689,966,967,972,980,988],{},[704,968,969],{},[648,970,971],{},"--client",[704,973,974,905,977],{},[648,975,976],{},"cli",[648,978,979],{},"api",[704,981,982,984,985,987],{},[648,983,976],{},", or ",[648,986,979],{}," with a token flag",[704,989,990,992,993,663,995,997,998,1000],{},[648,991,976],{},": ",[648,994,803],{},[648,996,806],{}," keep their own sign-in. ",[648,999,979],{},": Kraft reads a token.",[689,1002,1003,1008,1011,1018],{},[704,1004,1005],{},[648,1006,1007],{},"--ca-file",[704,1009,1010],{},"path",[704,1012,1013,1014,1017],{},"what git trusts for that address (",[648,1015,1016],{},"http.sslCAInfo","), then the system's CAs",[704,1019,1020],{},"The CA that signs a self-hosted forge's certificate, for the API client only. TLS verification is never turned off.",[689,1022,1023,1028,1042,1045],{},[704,1024,1025],{},[648,1026,1027],{},"--token-from",[704,1029,1030,659,1033,659,1036,905,1039],{},[648,1031,1032],{},"git-credential",[648,1034,1035],{},"env:NAME",[648,1037,1038],{},"file:PATH",[648,1040,1041],{},"command:CMD",[704,1043,1044],{},"none",[704,1046,1047,1048,676],{},"Where the token is read from. Implies ",[648,1049,854],{},[689,1051,1052,1057,1059,1061],{},[704,1053,1054],{},[648,1055,1056],{},"--token-stdin",[704,1058,958],{},[704,1060,961],{},[704,1062,1063,1064,1066,1067,676],{},"Reads the token from standard input, never from an argument, and the server writes it to a private file. Implies ",[648,1065,854],{},". Exclusive with ",[648,1068,1027],{},[689,1070,1071,1076,1087,1091],{},[704,1072,1073],{},[648,1074,1075],{},"--kind",[704,1077,1078,659,1081,905,1084],{},[648,1079,1080],{},"pat",[648,1082,1083],{},"oauth",[648,1085,1086],{},"unknown",[704,1088,1089],{},[648,1090,1086],{},[704,1092,1093],{},"Says what the token is.",[645,1095,1096,1097,1100,1101,1103],{},"A ",[648,1098,1099],{},"command"," source runs code as the server's user, so the server's API refuses it. The CLI writes it into ",[648,1102,487],{}," on the server's machine and reloads; elsewhere, or inside a worker, it refuses. A reload that refuses the file, or after which the server doesn't list the account, puts the old text back and exits 1.",[683,1105,1106,1116],{},[686,1107,1108],{},[689,1109,1110,1113],{},[692,1111,1112],{},"Refusal",[692,1114,1115],{},"Cause",[699,1117,1118,1129,1143],{},[689,1119,1120,1123],{},[704,1121,1122],{},"Refused",[704,1124,1125,1126,1128],{},"A second account with ",[648,1127,955],{}," for one host.",[689,1130,1131,1133],{},[704,1132,1122],{},[704,1134,1135,1138,1139,905,1141,676],{},[648,1136,1137],{},"--client cli"," with ",[648,1140,1027],{},[648,1142,1056],{},[689,1144,1145,1150],{},[704,1146,1147],{},[648,1148,1149],{},"403",[704,1151,1152,1153,1156,1157,1160,1161,1163],{},"The API refuses a write naming an ",[648,1154,1155],{},"env"," variable or ",[648,1158,1159],{},"file"," another account reads, or another account's pasted file; edit ",[648,1162,487],{}," by hand to share one.",[825,1165,1167],{"id":1166},"admin-forge-edit",[648,1168,728],{},[645,1170,1171],{},[716,1172,718],{},[835,1174,1177],{"className":1175,"code":1176,"language":840,"meta":841},[838],"kraft admin forge edit [flags] NAME\n",[648,1178,1179],{"__ignoreMap":841},[845,1180,1176],{"className":1181},[848],[645,1183,1184,1185,1188,1189,1192],{},"Changes the flags given on an account: its API address, ",[648,1186,1187],{},"ca_file",", client or token source. ",[648,1190,1191],{},"edit"," changes only the flags given.",[683,1194,1195,1207],{},[686,1196,1197],{},[689,1198,1199,1201,1203,1205],{},[692,1200,881],{},[692,1202,884],{},[692,1204,887],{},[692,1206,890],{},[699,1208,1209,1223,1244,1260,1283],{},[689,1210,1211,1215,1217,1220],{},[704,1212,1213],{},[648,1214,939],{},[704,1216,942],{},[704,1218,1219],{},"unchanged",[704,1221,1222],{},"Must share the web address's origin.",[689,1224,1225,1229,1235,1237],{},[704,1226,1227],{},[648,1228,971],{},[704,1230,1231,905,1233],{},[648,1232,976],{},[648,1234,979],{},[704,1236,1219],{},[704,1238,1239,1241,1242,676],{},[648,1240,1137],{}," drops the account's token and ",[648,1243,1187],{},[689,1245,1246,1250,1252,1254],{},[704,1247,1248],{},[648,1249,1007],{},[704,1251,1010],{},[704,1253,1219],{},[704,1255,1256,1257,676],{},"As for ",[648,1258,1259],{},"add",[689,1261,1262,1268,1273,1275],{},[704,1263,1264,659,1266],{},[648,1265,1027],{},[648,1267,1056],{},[704,1269,1270,1271],{},"as for ",[648,1272,1259],{},[704,1274,1219],{},[704,1276,1256,1277,1279,1280,1282],{},[648,1278,1259],{},". A pasted token's file is deleted once the account stops reading it. If the paste fails, ",[648,1281,1191],{}," puts the changed fields back.",[689,1284,1285,1289,1297,1299],{},[704,1286,1287],{},[648,1288,1075],{},[704,1290,1291,659,1293,905,1295],{},[648,1292,1080],{},[648,1294,1083],{},[648,1296,1086],{},[704,1298,1219],{},[704,1300,1301],{},"Says what the new token is.",[645,1303,1304,1305,1307,1308,1138,1310,659,1313,659,1316,905,1318,1320,1321,1323,1324,1326,1327,1330],{},"The same goes for changing an account that already reads a ",[648,1306,1099],{}," source: ",[648,1309,1191],{},[648,1311,1312],{},"--token-from env:…",[648,1314,1315],{},"file:…",[648,1317,1056],{},[648,1319,1137],{}," writes ",[648,1322,487],{}," on the server's machine too, because the API (and so Settings) refuses to replace a command. A ",[648,1325,1056],{}," token is written to a private file under ",[648,1328,1329],{},"$KRAFT_HOME\u002Fsecrets\u002F",", as the API does. Nothing is changed when the token is refused (too short, or holding whitespace).",[683,1332,1333,1341],{},[686,1334,1335],{},[689,1336,1337,1339],{},[692,1338,1112],{},[692,1340,1115],{},[699,1342,1343],{},[689,1344,1345,1347],{},[704,1346,1122],{},[704,1348,1349,1351],{},[648,1350,1075],{}," with no token flag.",[825,1353,1355],{"id":1354},"admin-forge-list",[648,1356,743],{},[645,1358,1359],{},[716,1360,718],{},[835,1362,1365],{"className":1363,"code":1364,"language":840,"meta":841},[838],"kraft admin forge list [flags]\n",[648,1366,1367],{"__ignoreMap":841},[845,1368,1364],{"className":1369},[848],[645,1371,1372],{},"Each account: forge, web address and whether it is the host's default. It takes no flags.",[825,1374,1376],{"id":1375},"admin-forge-remove",[648,1377,758],{},[645,1379,1380],{},[716,1381,718],{},[835,1383,1386],{"className":1384,"code":1385,"language":840,"meta":841},[838],"kraft admin forge remove [flags] NAME\n",[648,1387,1388],{"__ignoreMap":841},[845,1389,1385],{"className":1390},[848],[645,1392,1393],{},"Forgets an account. It takes no flags. A default account no repo names is removed anyway, and items pinned to it stop at their next forge node.",[683,1395,1396,1404],{},[686,1397,1398],{},[689,1399,1400,1402],{},[692,1401,1112],{},[692,1403,1115],{},[699,1405,1406],{},[689,1407,1408,1410],{},[704,1409,1122],{},[704,1411,1412],{},"A repo names the account.",[825,1414,1416],{"id":1415},"admin-forge-test",[648,1417,773],{},[645,1419,1420],{},[716,1421,718],{},[835,1423,1426],{"className":1424,"code":1425,"language":840,"meta":841},[838],"kraft admin forge test [flags] NAME\n",[648,1427,1428],{"__ignoreMap":841},[845,1429,1425],{"className":1430},[848],[645,1432,1433,1434,1436,1437,905,1439,1441,1442,1444,1445,1448],{},"Checks a ",[648,1435,799],{}," account's ",[648,1438,803],{},[648,1440,806],{}," sign-in, or a ",[648,1443,810],{}," account's token: who it signs in as, its scopes, expiry and the repos it sees. ",[648,1446,1447],{},"test"," exits 1 when it fails. It takes no flags.",[645,1450,1451,1452,1454,1455,1457,1458,905,1461,1464,1465,1467],{},"On a ",[648,1453,799],{}," account, ",[648,1456,1447],{}," runs ",[648,1459,1460],{},"gh auth status",[648,1462,1463],{},"glab auth status"," in the server for the account's host, without its port. On a ",[648,1466,810],{}," account it probes the token and never runs the CLI.",{"title":841,"searchDepth":1469,"depth":1469,"links":1470},2,[1471,1472],{"id":680,"depth":1469,"text":681},{"id":781,"depth":1469,"text":782,"children":1473},[1474,1476,1477,1478,1479],{"id":827,"depth":1475,"text":711},3,{"id":1166,"depth":1475,"text":728},{"id":1354,"depth":1475,"text":743},{"id":1375,"depth":1475,"text":758},{"id":1415,"depth":1475,"text":773},"The kraft admin forge verbs: name, edit, list, remove and test forge accounts.","md",null,{},true,{"title":369,"description":1480},"PZd1mI3P-uiCmigbAFRqJC8kiQKOwgYSrv9e9ZzZ_5w",[1488,1490],{"title":365,"path":366,"stem":367,"description":1489,"children":-1},"The kraft admin worker verbs: register, change and remove the machines that run steps, and run a machine's side.",{"title":373,"path":374,"stem":375,"description":1491,"children":-1},"The terminal UI that kraft console opens, for checking in on Kraft from a terminal, a tmux pane or over SSH.",1794749037288]