[{"data":1,"prerenderedAt":1417},["ShallowReactive",2],{"navigation_docs":3,"-reference-http-api-connect-a-repo":639,"-reference-http-api-connect-a-repo-surround":1412},[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":581,"body":641,"description":1405,"extension":1406,"links":1407,"meta":1408,"navigation":1409,"path":582,"seo":1410,"stem":583,"__hash__":1411},"docs\u002F5.reference\u002F08.http-api\u002F5.connect-a-repo.md",{"type":642,"value":643,"toc":1395},"minimark",[644,659,731,737,740,776,844,849,852,964,969,1018,1023,1033,1075,1206,1230,1247,1315,1320,1337,1391],[645,646,647,648,652,653,658],"p",{},"A script that files work needs its repo connected first. These routes list, probe, connect and disconnect repos. Like the other board routes they can change in any release, and ",[649,650,651],"code",{},"kraft repo connect --json"," is the stable way to do the same. The routes that change a connected repo's settings are in ",[654,655,657],"a",{"href":656},"\u002Freference\u002Fhttp-api#the-schema","the schema",".",[660,661,662,675],"table",{},[663,664,665],"thead",{},[666,667,668,672],"tr",{},[669,670,671],"th",{},"Route",[669,673,674],{},"What it does",[676,677,678,692,705,718],"tbody",{},[666,679,680,689],{},[681,682,683],"td",{},[654,684,686],{"href":685},"#get-apirepos",[649,687,688],{},"GET \u002Fapi\u002Frepos",[681,690,691],{},"Lists the connected repos and workspaces.",[666,693,694,702],{},[681,695,696],{},[654,697,699],{"href":698},"#post-apireposprobe",[649,700,701],{},"POST \u002Fapi\u002Frepos\u002Fprobe",[681,703,704],{},"Reads a repository and proposes how to connect it.",[666,706,707,715],{},[681,708,709],{},[654,710,712],{"href":711},"#post-apirepos",[649,713,714],{},"POST \u002Fapi\u002Frepos",[681,716,717],{},"Connects a repository.",[666,719,720,728],{},[681,721,722],{},[654,723,725],{"href":724},"#delete-apirepospath",[649,726,727],{},"DELETE \u002Fapi\u002Frepos?path=",[681,729,730],{},"Disconnects a repository.",[732,733,735],"h2",{"id":734},"get-apirepos",[649,736,688],{},[645,738,739],{},"Answers the connected repos and workspaces, and the checkout the server was started in when it isn't connected yet.",[741,742,747],"pre",{"className":743,"code":744,"language":745,"meta":746,"style":746},"language-bash shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","curl -s http:\u002F\u002F127.0.0.1:8765\u002Fapi\u002Frepos | jq '.repos[].path'\n","bash","",[649,748,749],{"__ignoreMap":746},[750,751,754,758,762,766,770,773],"span",{"class":752,"line":753},"line",1,[750,755,757],{"class":756},"szw1H","curl",[750,759,761],{"class":760},"ssYy9"," -s",[750,763,765],{"class":764},"semJd"," http:\u002F\u002F127.0.0.1:8765\u002Fapi\u002Frepos",[750,767,769],{"class":768},"sklAV"," |",[750,771,772],{"class":756}," jq",[750,774,775],{"class":764}," '.repos[].path'\n",[660,777,778,791],{},[663,779,780],{},[666,781,782,785,788],{},[669,783,784],{},"Field",[669,786,787],{},"Type",[669,789,790],{},"Meaning",[676,792,793,811,828],{},[666,794,795,800,803],{},[681,796,797],{},[649,798,799],{},"repos",[681,801,802],{},"list",[681,804,805,806,810],{},"One entry per connected repo, as ",[654,807,808],{"href":388},[649,809,387],{}," holds it, defaults included.",[666,812,813,818,821],{},[681,814,815],{},[649,816,817],{},"workspaces",[681,819,820],{},"object",[681,822,823,824,827],{},"The ",[649,825,826],{},"workspaces:"," section, by workspace ID.",[666,829,830,835,841],{},[681,831,832],{},[649,833,834],{},"suggested",[681,836,837,838],{},"string or ",[649,839,840],{},"null",[681,842,843],{},"The git checkout the server was started in, when it isn't connected yet.",[732,845,847],{"id":846},"post-apireposprobe",[649,848,701],{},[645,850,851],{},"Reads a repository and changes nothing. The answer is the proposal that connecting would save.",[660,853,854,867],{},[663,855,856],{},[666,857,858,860,862,865],{},[669,859,784],{},[669,861,787],{},[669,863,864],{},"Default",[669,866,790],{},[676,868,869,885,921,940],{},[666,870,871,876,879,882],{},[681,872,873],{},[649,874,875],{},"path",[681,877,878],{},"string",[681,880,881],{},"required",[681,883,884],{},"The absolute path of the repository.",[666,886,887,892,895,900],{},[681,888,889],{},[649,890,891],{},"detect",[681,893,894],{},"boolean",[681,896,897],{},[649,898,899],{},"true",[681,901,902,903,906,907,909,910,909,913,916,917,658],{},"With ",[649,904,905],{},"false"," the route answers only what needs no detector table: the resolved ",[649,908,875],{},", ",[649,911,912],{},"name",[649,914,915],{},"branch",", submodules, beads and ",[654,918,920],{"href":919},"\u002Fconcepts\u002Fvocabulary#forge","forge",[666,922,923,928,930,933],{},[681,924,925],{},[649,926,927],{},"test_command",[681,929,878],{},[681,931,932],{},"none",[681,934,935,936,939],{},"The root's test command, in place of the proposed one. ",[649,937,938],{},"\"\""," declares that the repo has no tests.",[666,941,942,946,948,950],{},[681,943,944],{},[649,945,920],{},[681,947,878],{},[681,949,932],{},[681,951,952,955,956,959,960],{},[649,953,954],{},"github"," or ",[649,957,958],{},"gitlab",": the forge you already know for a host that names none, so the answer doesn't ask. ",[961,962,963],"em",{},"Added in 2.5",[645,965,966,968],{},[654,967,393],{"href":394}," says how a proposal is made and what limits the probe. The probe runs in a process of its own with a two-minute limit.",[660,970,971,981],{},[663,972,973],{},[666,974,975,978],{},[669,976,977],{},"Status",[669,979,980],{},"When",[676,982,983,996,1008],{},[666,984,985,990],{},[681,986,987],{},[649,988,989],{},"400",[681,991,992,993,995],{},"The path isn't a git repository, ",[649,994,397],{}," doesn't load, or the probe ran past two minutes.",[666,997,998,1003],{},[681,999,1000],{},[649,1001,1002],{},"422",[681,1004,1005,1007],{},[649,1006,875],{}," is relative.",[666,1009,1010,1015],{},[681,1011,1012],{},[649,1013,1014],{},"429",[681,1016,1017],{},"Two probes are already running. Try again shortly.",[732,1019,1021],{"id":1020},"post-apirepos",[649,1022,714],{},[645,1024,1025,1026,1028,1029,1032],{},"Connects a repository: it probes it, saves the entry to ",[649,1027,387],{},", and indexes the repo for search. It answers ",[649,1030,1031],{},"201"," with the saved entry and the probe's proposal.",[741,1034,1036],{"className":743,"code":1035,"language":745,"meta":746,"style":746},"curl -s -X POST http:\u002F\u002F127.0.0.1:8765\u002Fapi\u002Frepos \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"path\": \"\u002Fhome\u002Fme\u002Fsrc\u002Fapp\", \"test_command\": \"pytest -q\"}'\n",[649,1037,1038,1055,1066],{"__ignoreMap":746},[750,1039,1040,1042,1044,1047,1050,1052],{"class":752,"line":753},[750,1041,757],{"class":756},[750,1043,761],{"class":760},[750,1045,1046],{"class":760}," -X",[750,1048,1049],{"class":764}," POST",[750,1051,765],{"class":764},[750,1053,1054],{"class":768}," \\\n",[750,1056,1058,1061,1064],{"class":752,"line":1057},2,[750,1059,1060],{"class":760},"  -H",[750,1062,1063],{"class":764}," 'Content-Type: application\u002Fjson'",[750,1065,1054],{"class":768},[750,1067,1069,1072],{"class":752,"line":1068},3,[750,1070,1071],{"class":760},"  -d",[750,1073,1074],{"class":764}," '{\"path\": \"\u002Fhome\u002Fme\u002Fsrc\u002Fapp\", \"test_command\": \"pytest -q\"}'\n",[660,1076,1077,1089],{},[663,1078,1079],{},[666,1080,1081,1083,1085,1087],{},[669,1082,784],{},[669,1084,787],{},[669,1086,864],{},[669,1088,790],{},[676,1090,1091,1103,1117,1134,1151,1168,1187],{},[666,1092,1093,1097,1099,1101],{},[681,1094,1095],{},[649,1096,875],{},[681,1098,878],{},[681,1100,881],{},[681,1102,884],{},[666,1104,1105,1109,1111,1114],{},[681,1106,1107],{},[649,1108,912],{},[681,1110,878],{},[681,1112,1113],{},"the directory name",[681,1115,1116],{},"The repo's name.",[666,1118,1119,1124,1126,1131],{},[681,1120,1121],{},[649,1122,1123],{},"default_chain",[681,1125,878],{},[681,1127,1128],{},[649,1129,1130],{},"default",[681,1132,1133],{},"The chain its items run when none is named.",[666,1135,1136,1140,1142,1145],{},[681,1137,1138],{},[649,1139,927],{},[681,1141,878],{},[681,1143,1144],{},"the probe's proposal",[681,1146,1147,1148,1150],{},"The root's test command. ",[649,1149,938],{}," declares a repo with no tests.",[666,1152,1153,1158,1160,1162],{},[681,1154,1155],{},[649,1156,1157],{},"setup_command",[681,1159,878],{},[681,1161,1144],{},[681,1163,1164,1165,1167],{},"The command that prepares a worktree. ",[649,1166,938],{}," declares none.",[666,1169,1170,1175,1177,1184],{},[681,1171,1172],{},[649,1173,1174],{},"enabled",[681,1176,894],{},[681,1178,1179,1181,1182],{},[649,1180,899],{}," with a test command or test scopes, else ",[649,1183,905],{},[681,1185,1186],{},"Whether auto-intake and an agent may file work on the repo. A person can file on a disabled repo by hand.",[666,1188,1189,1194,1196,1198],{},[681,1190,1191],{},[649,1192,1193],{},"forge_account",[681,1195,878],{},[681,1197,932],{},[681,1199,823,1200,1203,1204],{},[654,1201,1202],{"href":488},"forge account"," the repo uses. ",[961,1205,963],{},[645,1207,1208,1209,909,1212,909,1214,909,1217,909,1220,1223,1224,1227,1228,658],{},"The body also takes ",[649,1210,1211],{},"test_scopes",[649,1213,920],{},[649,1215,1216],{},"project",[649,1218,1219],{},"models",[649,1221,1222],{},"deny_tools"," and ",[649,1225,1226],{},"steering",", the fields of the same names in ",[649,1229,387],{},[645,1231,1232,1233,1235,1236,955,1238,1240,1241,1243,1244,658],{},"Commands an agent gives are held for a person. When the request comes from a worker session or the MCP server and gives a ",[649,1234,927],{},", a non-empty ",[649,1237,1157],{},[649,1239,1211],{},", the repo is saved disabled, whatever ",[649,1242,1174],{}," says, and the answer carries ",[649,1245,1246],{},"held",[660,1248,1249,1257],{},[663,1250,1251],{},[666,1252,1253,1255],{},[669,1254,977],{},[669,1256,980],{},[676,1258,1259,1268,1282,1292],{},[666,1260,1261,1265],{},[681,1262,1263],{},[649,1264,989],{},[681,1266,1267],{},"The path isn't a git repository, or the probe fails and the body doesn't give both commands.",[666,1269,1270,1275],{},[681,1271,1272],{},[649,1273,1274],{},"403",[681,1276,1277,1279,1280],{},[649,1278,1193],{}," from a worker session or the MCP server: a repo's account is a person's choice. ",[961,1281,963],{},[666,1283,1284,1289],{},[681,1285,1286],{},[649,1287,1288],{},"409",[681,1290,1291],{},"The repo is already connected.",[666,1293,1294,1298],{},[681,1295,1296],{},[649,1297,1002],{},[681,1299,1300,1301,1304,1305,1307,1308,1310,1311,1314],{},"The path is relative, the repository has no commit yet, ",[649,1302,1303],{},"enabled: true"," has no test command or scopes, ",[649,1306,1193],{}," names no account, or ",[649,1309,387],{}," wouldn't load with the entry. ",[649,1312,1313],{},"detail"," says which.",[732,1316,1318],{"id":1317},"delete-apirepospath",[649,1319,727],{},[645,1321,1322,1323,1325,1326,1328,1329,1332,1333,1336],{},"Disconnects the repo at ",[649,1324,875],{},": it removes the entry from ",[649,1327,387],{}," and from the search index. No file of the repository is touched and no work item is dropped. ",[649,1330,1331],{},"kraft repo disconnect"," calls it. It answers ",[649,1334,1335],{},"204"," with no body.",[660,1338,1339,1347],{},[663,1340,1341],{},[666,1342,1343,1345],{},[669,1344,977],{},[669,1346,980],{},[676,1348,1349,1361,1370,1379],{},[666,1350,1351,1356],{},[681,1352,1353],{},[649,1354,1355],{},"404",[681,1357,1358,1360],{},[649,1359,875],{}," isn't a connected repo, or is relative.",[666,1362,1363,1367],{},[681,1364,1365],{},[649,1366,1288],{},[681,1368,1369],{},"The repo has open items, paused ones included. The answer gives the count: complete, cancel or abandon them first.",[666,1371,1372,1376],{},[681,1373,1374],{},[649,1375,1288],{},[681,1377,1378],{},"The repo's add-on library is still named by configuration, or an add-on is busy. The answer names where.",[666,1380,1381,1385],{},[681,1382,1383],{},[649,1384,1002],{},[681,1386,1387,1388,1390],{},"A workspace in ",[649,1389,387],{}," still names the repo.",[1392,1393,1394],"style",{},"html pre.shiki code .szw1H, html code.shiki .szw1H{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFB757}html pre.shiki code .ssYy9, html code.shiki .ssYy9{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#91CBFF}html pre.shiki code .semJd, html code.shiki .semJd{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#ADDCFF}html pre.shiki code .sklAV, html code.shiki .sklAV{--shiki-light:#A0111F;--shiki-default:#A0111F;--shiki-dark:#FF9492}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":746,"searchDepth":1057,"depth":1057,"links":1396},[1397,1399,1401,1403],{"id":734,"depth":1057,"text":1398},"GET \u002Fapi\u002F​repos",{"id":846,"depth":1057,"text":1400},"POST \u002Fapi\u002F​repos\u002F​probe",{"id":1020,"depth":1057,"text":1402},"POST \u002Fapi\u002F​repos",{"id":1317,"depth":1057,"text":1404},"DELETE \u002Fapi\u002F​repos?​path=","The routes a script calls to list the connected repos, probe a repository, connect it and disconnect it.","md",null,{},true,{"title":581,"description":1405},"65cz2na21QSwOrFoDLfKFizCE-1R8lfDh68___niKSQ",[1413,1415],{"title":577,"path":578,"stem":579,"description":1414,"children":-1},"The three shapes a work item answers in, its stored columns, and the fields that need an explanation, from its status and stop to its budget cap and plan progress.",{"title":585,"path":586,"stem":587,"description":1416,"children":-1},"Every tool the kraft MCP server serves, with its parameters and the kraft command that does the same.",1794749043263]