[{"data":1,"prerenderedAt":2935},["ShallowReactive",2],{"navigation_docs":3,"-reference-cli-server":639,"-reference-cli-server-surround":2930},[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":357,"body":641,"description":2924,"extension":2925,"links":2926,"meta":2927,"navigation":2261,"path":358,"seo":2928,"stem":359,"__hash__":2929},"docs\u002F5.reference\u002F01.cli\u002F5.server.md",{"type":642,"value":643,"toc":2888},"minimark",[644,680,685,931,934,940,955,963,1051,1080,1090,1125,1141,1146,1155,1160,1173,1184,1221,1237,1242,1251,1256,1262,1275,1333,1391,1395,1400,1409,1414,1428,1438,1454,1627,1645,1650,1655,1672,1690,1693,1697,1723,1769,1776,1779,1784,1835,1841,1891,1894,1899,1908,1929,1953,1967,1971,1976,1985,1988,1992,2018,2088,2122,2133,2138,2147,2150,2154,2165,2200,2267,2289,2294,2298,2303,2312,2315,2350,2367,2372,2381,2384,2414,2426,2454,2488,2514,2527,2532,2541,2544,2572,2577,2586,2616,2620,2625,2634,2641,2646,2655,2664,2669,2678,2680,2711,2716,2725,2730,2759,2764,2773,2778,2783,2792,2815,2849,2853],[645,646,647,648,652,653,656,657,660,661,663,664,666,667,670,671,674,675,679],"p",{},"Bare ",[649,650,651],"code",{},"kraft"," is the same as ",[649,654,655],{},"kraft admin start",". This page covers the server itself; ",[658,659,361],"a",{"href":362},", ",[658,662,365],{"href":366}," and ",[658,665,369],{"href":370}," cover the rest of ",[649,668,669],{},"kraft admin",". Every verb here accepts ",[649,672,673],{},"--json","; the exceptions are in ",[658,676,678],{"href":677},"\u002Freference\u002Fcli#output-format","Output format",".",[681,682,684],"h2",{"id":683},"verbs-at-a-glance","Verbs at a glance",[686,687,688,701],"table",{},[689,690,691],"thead",{},[692,693,694,698],"tr",{},[695,696,697],"th",{},"Verb",[695,699,700],{},"What it does",[702,703,704,721,734,747,760,773,786,807,820,840,853,866,879,892,905,918],"tbody",{},[692,705,706,715],{},[707,708,709],"td",{},[658,710,712],{"href":711},"\u002Freference\u002Fcli\u002Fserver#admin-start",[649,713,714],{},"admin start",[707,716,717,718,720],{},"Runs the server; bare ",[649,719,651],{}," does the same.",[692,722,723,731],{},[707,724,725],{},[658,726,728],{"href":727},"\u002Freference\u002Fcli\u002Fserver#admin-stop",[649,729,730],{},"admin stop",[707,732,733],{},"Stops the running server.",[692,735,736,744],{},[707,737,738],{},[658,739,741],{"href":740},"\u002Freference\u002Fcli\u002Fserver#admin-restart",[649,742,743],{},"admin restart",[707,745,746],{},"Stops the server, then starts it the same way.",[692,748,749,757],{},[707,750,751],{},[658,752,754],{"href":753},"\u002Freference\u002Fcli\u002Fserver#admin-health",[649,755,756],{},"admin health",[707,758,759],{},"The server's state; exits 1 when degraded.",[692,761,762,770],{},[707,763,764],{},[658,765,767],{"href":766},"\u002Freference\u002Fcli\u002Fserver#admin-doctor",[649,768,769],{},"admin doctor",[707,771,772],{},"Checks the whole install, one line per check.",[692,774,775,783],{},[707,776,777],{},[658,778,780],{"href":779},"\u002Freference\u002Fcli\u002Fserver#admin-update",[649,781,782],{},"admin update",[707,784,785],{},"Installs the newest release.",[692,787,788,796],{},[707,789,790],{},[658,791,793],{"href":792},"\u002Freference\u002Fcli\u002Fserver#admin-reload",[649,794,795],{},"admin reload",[707,797,798,799,660,801,660,803,663,805,679],{},"Rereads the library, ",[649,800,405],{},[649,802,417],{},[649,804,483],{},[649,806,487],{},[692,808,809,817],{},[707,810,811],{},[658,812,814],{"href":813},"\u002Freference\u002Fcli\u002Fserver#admin-reindex",[649,815,816],{},"admin reindex",[707,818,819],{},"Rescans documents into the search index.",[692,821,822,830],{},[707,823,824],{},[658,825,827],{"href":826},"\u002Freference\u002Fcli\u002Fserver#admin-install-service",[649,828,829],{},"admin install-service",[707,831,832,833,839],{},"Registers Kraft as an OS service; ",[658,834,836],{"href":835},"\u002Freference\u002Fcli\u002Fserver#admin-uninstall-service",[649,837,838],{},"admin uninstall-service"," removes it.",[692,841,842,850],{},[707,843,844],{},[658,845,847],{"href":846},"\u002Freference\u002Fcli\u002Fserver#admin-templates-lint",[649,848,849],{},"admin templates lint",[707,851,852],{},"Lints the library's chains.",[692,854,855,863],{},[707,856,857],{},[658,858,860],{"href":859},"\u002Freference\u002Fcli\u002Fserver#admin-templates-show",[649,861,862],{},"admin templates show",[707,864,865],{},"Shows one chain.",[692,867,868,876],{},[707,869,870],{},[658,871,873],{"href":872},"\u002Freference\u002Fcli\u002Fserver#admin-templates-library",[649,874,875],{},"admin templates library",[707,877,878],{},"Lists the library's components.",[692,880,881,889],{},[707,882,883],{},[658,884,886],{"href":885},"\u002Freference\u002Fcli\u002Fserver#admin-harnesses",[649,887,888],{},"admin harnesses",[707,890,891],{},"The harness profiles and the tasks that select each.",[692,893,894,902],{},[707,895,896],{},[658,897,899],{"href":898},"\u002Freference\u002Fcli\u002Fserver#admin-init",[649,900,901],{},"admin init",[707,903,904],{},"Registers Kraft's MCP server and skills with an agent.",[692,906,907,915],{},[707,908,909],{},[658,910,912],{"href":911},"\u002Freference\u002Fcli\u002Fserver#admin-mcp",[649,913,914],{},"admin mcp",[707,916,917],{},"Serves the MCP tools over stdio.",[692,919,920,928],{},[707,921,922],{},[658,923,925],{"href":924},"\u002Freference\u002Fcli\u002Fserver#admin-permission-hook",[649,926,927],{},"admin permission-hook",[707,929,930],{},"A Cursor or Codex worker's pre-tool hook; not run by hand.",[681,932,169],{"id":933},"run-the-server",[935,936,938],"h3",{"id":937},"admin-start",[649,939,714],{},[941,942,948],"pre",{"className":943,"code":945,"language":946,"meta":947},[944],"language-text","kraft admin start [flags]\n","text","",[649,949,950],{"__ignoreMap":947},[951,952,945],"span",{"className":953},[954],"line",[645,956,957,958,960,961,679],{},"Runs the server in the foreground; the same as bare ",[649,959,651],{},". It takes no ",[649,962,673],{},[686,964,965,981],{},[689,966,967],{},[692,968,969,972,975,978],{},[695,970,971],{},"Flag",[695,973,974],{},"Type",[695,976,977],{},"Default",[695,979,980],{},"Meaning",[702,982,983,1009,1032],{},[692,984,985,990,993,1001],{},[707,986,987],{},[649,988,989],{},"--host",[707,991,992],{},"bind address",[707,994,995,998,999],{},[649,996,997],{},"KRAFT_HOST",", else ",[649,1000,413],{},[707,1002,1003,1004,1006,1007,679],{},"Overrides ",[649,1005,997],{},", which overrides ",[649,1008,413],{},[692,1010,1011,1016,1019,1026],{},[707,1012,1013],{},[649,1014,1015],{},"--port",[707,1017,1018],{},"integer",[707,1020,1021,998,1024],{},[649,1022,1023],{},"KRAFT_PORT",[649,1025,413],{},[707,1027,1003,1028,1006,1030,679],{},[649,1029,1023],{},[649,1031,413],{},[692,1033,1034,1042,1045,1048],{},[707,1035,1036,660,1039],{},[649,1037,1038],{},"--detach",[649,1040,1041],{},"-d",[707,1043,1044],{},"switch",[707,1046,1047],{},"off",[707,1049,1050],{},"Forks the server into its own session and returns once it is up.",[686,1052,1053,1063],{},[689,1054,1055],{},[692,1056,1057,1060],{},[695,1058,1059],{},"Refusal",[695,1061,1062],{},"Cause",[702,1064,1065,1073],{},[692,1066,1067,1070],{},[707,1068,1069],{},"Refused to start",[707,1071,1072],{},"The address isn't loopback and no password is set.",[692,1074,1075,1077],{},[707,1076,1069],{},[707,1078,1079],{},"A server is already running against the same run directory.",[645,1081,1082,1083,1086,1087,1089],{},"The foreground server stops on Ctrl-C, which, like ",[649,1084,1085],{},"kraft admin stop",", leaves the local steps of worktree items running. Use ",[649,1088,1085],{}," for one you started elsewhere.",[645,1091,1092,1093,663,1095,1097,1098,1100,1101,1103,1104,1106,1107,1110,1111,1103,1114,1117,1118,1120,1121,1124],{},"The flags aren't saved: other commands still dial the host and port in ",[649,1094,997],{},[649,1096,1023],{},", or in ",[649,1099,413],{},". When ",[649,1102,989],{}," or ",[649,1105,1015],{}," differs from that value, ",[649,1108,1109],{},"start"," prints the ",[649,1112,1113],{},"KRAFT_HOST=H",[649,1115,1116],{},"KRAFT_PORT=N"," line they need. A wildcard ",[649,1119,989],{}," such as ",[649,1122,1123],{},"0.0.0.0"," needs none.",[645,1126,1127,1128,1130,1131,1133,1134,1137,1138,679],{},"With ",[649,1129,1038],{},", if the server exits instead, ",[649,1132,1109],{}," prints the error (such as ",[649,1135,1136],{},"RuntimeError: database schema vN is newer than code vM","), the end of that start's output, and the path of ",[649,1139,1140],{},"server.log",[935,1142,1144],{"id":1143},"admin-stop",[649,1145,730],{},[941,1147,1150],{"className":1148,"code":1149,"language":946,"meta":947},[944],"kraft admin stop [flags]\n",[649,1151,1152],{"__ignoreMap":947},[951,1153,1149],{"className":1154},[954],[645,1156,1157,1158,679],{},"Stops the running server. It takes no ",[649,1159,673],{},[645,1161,1162,1164,1165,1168,1169,1172],{},[649,1163,1085],{}," sends SIGTERM to the process in ",[649,1166,1167],{},"run\u002Fkraft.pid",", once it has checked that the process is this Kraft server. The local steps of worktree items keep running in the local worker, and the next start picks them up. ",[649,1170,1171],{},"stop"," says how many keep running, and that until Kraft is back nothing answers their permission prompts or enforces their caps.",[645,1174,1175,1176,1179,1180,679],{},"A step of an item that runs in place stops with the server, and that item stops with a ",[649,1177,1178],{},"reattach:"," failure when Kraft starts again; it doesn't resume by itself. See ",[658,1181,1183],{"href":1182},"\u002Fguides\u002Frun\u002Frestart-kraft#a-restart-leaves-local-steps-running","A restart leaves local steps running",[686,1185,1186,1198],{},[689,1187,1188],{},[692,1189,1190,1192,1194,1196],{},[695,1191,971],{},[695,1193,974],{},[695,1195,977],{},[695,1197,980],{},[702,1199,1200],{},[692,1201,1202,1207,1209,1211],{},[707,1203,1204],{},[649,1205,1206],{},"--now",[707,1208,1044],{},[707,1210,1047],{},[707,1212,1213,1214,1216,1217],{},"Stops every step, the local steps of worktree items included. Each of those items stops with a ",[649,1215,1178],{}," failure when Kraft starts again. ",[1218,1219,1220],"em",{},"Added in 2.4",[1222,1223,1224,1231,1234],"ul",{},[1225,1226,1227,1228,1230],"li",{},"A pidfile naming any other process is stale: ",[649,1229,1171],{}," removes it, says so and signals nothing.",[1225,1232,1233],{},"It lists the items it stops, without asking. A server that doesn't list them within 2 seconds is stopped anyway.",[1225,1235,1236],{},"A repo's setup command that is running is ended too, with everything it started, so it never runs beside the next server's own run of it. A server that is killed (SIGKILL) can't end it.",[935,1238,1240],{"id":1239},"admin-restart",[649,1241,743],{},[941,1243,1246],{"className":1244,"code":1245,"language":946,"meta":947},[944],"kraft admin restart [flags]\n",[649,1247,1248],{"__ignoreMap":947},[951,1249,1245],{"className":1250},[954],[645,1252,1253,1254,679],{},"Restarts the server. It takes no ",[649,1255,673],{},[645,1257,1258,1261],{},[649,1259,1260],{},"kraft admin restart"," stops the server, then starts it again the way it was running: through the service manager if one is installed, back into the background if it was detached.",[645,1263,1264,1265,660,1267,1270,1271,1274],{},"Like ",[649,1266,1171],{},[649,1268,1269],{},"restart"," leaves the local steps of worktree items running; the new server picks them up. It ends the step of an item that runs in place: pause those items first, and retry any item it stopped. It lists those items and, in a terminal, asks before going on; with none, it asks nothing. ",[649,1272,1273],{},"-y"," skips the question.",[686,1276,1277,1289],{},[689,1278,1279],{},[692,1280,1281,1283,1285,1287],{},[695,1282,971],{},[695,1284,974],{},[695,1286,977],{},[695,1288,980],{},[702,1290,1291,1307],{},[692,1292,1293,1300,1302,1304],{},[707,1294,1295,660,1297],{},[649,1296,1273],{},[649,1298,1299],{},"--yes",[707,1301,1044],{},[707,1303,1047],{},[707,1305,1306],{},"Doesn't ask about running in-place steps.",[692,1308,1309,1314,1316,1318],{},[707,1310,1311],{},[649,1312,1313],{},"--when-free",[707,1315,1044],{},[707,1317,1047],{},[707,1319,1320,1321,1324,1325,1329,1330],{},"Asks for one restart at the next free moment instead, whatever ",[649,1322,1323],{},"restart_when_free"," says. See ",[658,1326,1328],{"href":1327},"#update-when-kraft-is-free","Update when Kraft is free",". ",[1218,1331,1332],{},"Added in 2.3",[686,1334,1335,1345],{},[689,1336,1337],{},[692,1338,1339,1342],{},[695,1340,1341],{},"When",[695,1343,1344],{},"Then",[702,1346,1347,1358,1366,1376],{},[692,1348,1349,1352],{},[707,1350,1351],{},"The server runs attached to a terminal",[707,1353,1354,1355,1357],{},"It is stopped, with a note that only that terminal can bring it back, and ",[649,1356,1269],{}," exits 1, since no server is running after it.",[692,1359,1360,1363],{},[707,1361,1362],{},"You answer no",[707,1364,1365],{},"It exits 1 and says nothing was restarted.",[692,1367,1368,1371],{},[707,1369,1370],{},"No server is running",[707,1372,1373,1374,679],{},"It starts nothing: it says so and exits 1. Start one with ",[649,1375,655],{},[692,1377,1378,1381],{},[707,1379,1380],{},"The installed Kraft is a new major version and an item is active",[707,1382,1383,1384,663,1386,1329,1389],{},"It exits 1 before stopping anything, naming ",[649,1385,1313],{},[649,1387,1388],{},"stop --now",[1218,1390,1220],{},[681,1392,1394],{"id":1393},"update-and-reload","Update and reload",[935,1396,1398],{"id":1397},"admin-update",[649,1399,782],{},[941,1401,1404],{"className":1402,"code":1403,"language":946,"meta":947},[944],"kraft admin update [flags]\n",[649,1405,1406],{"__ignoreMap":947},[951,1407,1403],{"className":1408},[954],[645,1410,1411,1412,679],{},"Installs the newest release. It takes no ",[649,1413,673],{},[645,1415,1416,1419,1420,1423,1424,1427],{},[649,1417,1418],{},"kraft admin update"," installs the newest release with uv, keeping the ",[649,1421,1422],{},"vector"," extra and the Python it runs on, or runs ",[649,1425,1426],{},"brew upgrade"," if you installed with Homebrew. On a pipx or pip install, or a source checkout, it installs nothing and prints the command that updates that install.",[645,1429,1430,1431,1433,1434,1437],{},"It warns when another install of ",[649,1432,651],{}," sits ahead of this one on ",[649,1435,1436],{},"PATH",", since MCP servers and hooks run the first one.",[645,1439,1440,1441,1445,1446,1449,1450,1453],{},"Before it installs a release of another major version, it lists each loaded ",[658,1442,1444],{"href":1443},"\u002Fconcepts\u002Fvocabulary#add-on","Kraft add-on"," whose ",[649,1447,1448],{},"requires.kraft"," that release doesn't meet, and asks ",[649,1451,1452],{},"Install it anyway? [y\u002FN]",". Those add-ons stop loading until each publishes a version for the new major. Answering no, or running with no terminal, installs nothing and exits 1.",[686,1455,1456,1468],{},[689,1457,1458],{},[692,1459,1460,1462,1464,1466],{},[695,1461,971],{},[695,1463,974],{},[695,1465,977],{},[695,1467,980],{},[702,1469,1470,1484,1505,1522,1554,1585,1608],{},[692,1471,1472,1477,1479,1481],{},[707,1473,1474],{},[649,1475,1476],{},"--force",[707,1478,1044],{},[707,1480,1047],{},[707,1482,1483],{},"Installs even when current.",[692,1485,1486,1491,1493,1495],{},[707,1487,1488],{},[649,1489,1490],{},"--restart",[707,1492,1044],{},[707,1494,1047],{},[707,1496,1497,1498,1500,1501,1504],{},"Also restarts a running server, as ",[649,1499,1269],{}," does. It lists the in-place items and asks before installing anything; answering no exits 1. Across a major version it marks the release for ",[658,1502,1503],{"href":1327},"when Kraft is free"," instead.",[692,1506,1507,1511,1513,1515],{},[707,1508,1509],{},[649,1510,1206],{},[707,1512,1044],{},[707,1514,1047],{},[707,1516,1517,1518,1329,1520],{},"Installs and restarts at once, ending every running step, including those an update to a new major version would wait for. Implies ",[649,1519,1490],{},[1218,1521,1220],{},[692,1523,1524,1529,1544,1547],{},[707,1525,1526],{},[649,1527,1528],{},"--channel",[707,1530,1531,1532,660,1535,660,1538,660,1541],{},"one of ",[649,1533,1534],{},"stable",[649,1536,1537],{},"rc",[649,1539,1540],{},"beta",[649,1542,1543],{},"alpha",[707,1545,1546],{},"the channel of the installed release",[707,1548,1549,1550,679],{},"Takes releases from that channel. See ",[658,1551,1553],{"href":1552},"#channels","Channels",[692,1555,1556,1562,1564,1566],{},[707,1557,1558,660,1560],{},[649,1559,1273],{},[649,1561,1299],{},[707,1563,1044],{},[707,1565,1047],{},[707,1567,1568,1569,1572,1573,1576,1577,1581,1582,1584],{},"Answers yes to ",[649,1570,1571],{},"Install it?"," for the ",[649,1574,1575],{},"kraft-default"," change, accepts the ",[658,1578,1580],{"href":1579},"\u002Fguides\u002Frun\u002Fcoming-from-1-4#a-0x-home","template migration"," without asking, skips ",[649,1583,1490],{},"'s question, and installs a major release that leaves add-ons out.",[692,1586,1587,1591,1594,1597],{},[707,1588,1589],{},[649,1590,1313],{},[707,1592,1593],{},"optional release tag",[707,1595,1596],{},"off; with no tag, the newest release on the channel",[707,1598,1599,1600,1603,1604,1329,1606],{},"Marks the newest release on the channel, or ",[649,1601,1602],{},"TAG",", to install and restart once nothing is running. See ",[658,1605,1328],{"href":1327},[1218,1607,1332],{},[692,1609,1610,1615,1617,1619],{},[707,1611,1612],{},[649,1613,1614],{},"--cancel-when-free",[707,1616,1044],{},[707,1618,1047],{},[707,1620,1621,1622,1624,1625],{},"Drops a release marked with ",[649,1623,1313],{}," or on the About page. ",[1218,1626,1332],{},[645,1628,1629,1630,1633,1634,1637,1638,1640,1641,1644],{},"A Kraft home from 0.x holds a ",[649,1631,1632],{},"registry.yaml"," and no ",[649,1635,1636],{},"library.yaml",": the server starts degraded and refuses new work until you run ",[649,1639,1418],{},". See ",[658,1642,1643],{"href":1579},"A 0.x home"," for what the update changes.",[1646,1647,1649],"h4",{"id":1648},"what-an-update-changes-in-kraft-default","What an update changes in kraft-default",[645,1651,1652],{},[1218,1653,1654],{},"Added in 2.6",[645,1656,1657,1658,1660,1661,1663,1664,1667,1668,1671],{},"Before it installs, ",[649,1659,1418],{}," prints what the new release changes in the built-in ",[649,1662,1575],{}," add-on, or ",[649,1665,1666],{},"kraft-default: unchanged",". When there is a change, a break in one of your overrides or a note, it asks ",[649,1669,1670],{},"Install it? [y\u002FN]"," at a terminal; no installs nothing and exits 1. With no terminal it declines the same way.",[645,1673,1674,1675,1103,1677,1679,1680,1682,1683,1686,1687,1689],{},"An unattended update, ",[649,1676,1313],{},[649,1678,1490],{}," across a major version, doesn't ask. It holds when an override of yours would break or the comparison can't be made, installs nothing and records why: the ",[649,1681,1575],{}," row of ",[649,1684,1685],{},"kraft admin doctor"," says to run ",[649,1688,1418],{},", read the change and accept it.",[1646,1691,1328],{"id":1692},"update-when-kraft-is-free",[645,1694,1695],{},[1218,1696,1332],{},[645,1698,1699,663,1702,1705,1706,660,1709,660,1712,1103,1715,1718,1719,1722],{},[649,1700,1701],{},"kraft admin update --when-free",[649,1703,1704],{},"kraft admin restart --when-free"," ask the running server to do it once nothing is going on: no agent session is running, and no item is ",[649,1707,1708],{},"active",[649,1710,1711],{},"waiting",[649,1713,1714],{},"queued",[649,1716,1717],{},"rate_limited",". They answer at once; the server installs and restarts later, inside any ",[658,1720,1721],{"href":480},"allowed hours",". A mark survives a restart.",[1222,1724,1725,1735,1744,1756,1759],{},[1225,1726,1727,1728,1731,1732,1734],{},"Without a tag, ",[649,1729,1730],{},"update --when-free"," marks the newest release on the channel, ",[649,1733,1528],{}," choosing it. With a tag, it marks that release, a new major version included. It marks nothing when the install is already current.",[1225,1736,1737,1738,1740,1741,1743],{},"Both need a running server to hold the request. With none, they say so, exit 1 and name the command that works without one: ",[649,1739,1418],{}," installs now. ",[649,1742,1614],{}," needs one too.",[1225,1745,1746,1747,1750,1751,663,1753,1755],{},"Allowed hours apply to a mark and to ",[649,1748,1749],{},"restart --when-free",": they ask for \"when free\", not \"now\". ",[649,1752,1418],{},[649,1754,1260],{}," without the flag stay immediate.",[1225,1757,1758],{},"A dev install, and an install not made with uv, can't be marked: the server refuses and says why.",[1225,1760,1761,1764,1765,1768],{},[649,1762,1763],{},"update --restart"," across a major version marks the newest release the same way instead of restarting, and says so. ",[649,1766,1767],{},"update --now"," installs and restarts at once.",[645,1770,1771,1775],{},[658,1772,1774],{"href":1773},"\u002Fguides\u002Frun\u002Fupgrade-kraft#update-when-kraft-is-free","Update Kraft when it is free"," says what the server does when it gets there and what a failed update puts back.",[1646,1777,1553],{"id":1778},"channels",[645,1780,1781,1783],{},[649,1782,1528],{}," takes one of four values:",[686,1785,1786,1797],{},[689,1787,1788],{},[692,1789,1790,1794],{},[695,1791,1792],{},[649,1793,1528],{},[695,1795,1796],{},"Takes",[702,1798,1799,1808,1817,1826],{},[692,1800,1801,1805],{},[707,1802,1803],{},[649,1804,1534],{},[707,1806,1807],{},"Final releases only. It is how an rc or beta install goes back to finals.",[692,1809,1810,1814],{},[707,1811,1812],{},[649,1813,1537],{},[707,1815,1816],{},"Release candidates and finals.",[692,1818,1819,1823],{},[707,1820,1821],{},[649,1822,1540],{},[707,1824,1825],{},"Betas, release candidates and finals.",[692,1827,1828,1832],{},[707,1829,1830],{},[649,1831,1543],{},[707,1833,1834],{},"Anything.",[645,1836,1837,1838,1840],{},"Without ",[649,1839,1528],{},", the install follows the channel of the release it is:",[686,1842,1843,1852],{},[689,1844,1845],{},[692,1846,1847,1849],{},[695,1848,17],{},[695,1850,1851],{},"Follows",[702,1853,1854,1863,1872,1881],{},[692,1855,1856,1859],{},[707,1857,1858],{},"A release candidate",[707,1860,1861],{},[649,1862,1537],{},[692,1864,1865,1868],{},[707,1866,1867],{},"A beta",[707,1869,1870],{},[649,1871,1540],{},[692,1873,1874,1877],{},[707,1875,1876],{},"An alpha",[707,1878,1879],{},[649,1880,1543],{},[692,1882,1883,1886],{},[707,1884,1885],{},"A final release",[707,1887,1888,1890],{},[649,1889,1534],{},", which never takes a pre-release",[645,1892,1893],{},"Homebrew installs only track stable.",[935,1895,1897],{"id":1896},"admin-reload",[649,1898,795],{},[941,1900,1903],{"className":1901,"code":1902,"language":946,"meta":947},[944],"kraft admin reload [flags]\n",[649,1904,1905],{"__ignoreMap":947},[951,1906,1902],{"className":1907},[954],[645,1909,1910,1911,1915,1916,660,1920,660,1922,660,1924,663,1926,1928],{},"Rereads the ",[658,1912,1914],{"href":1913},"\u002Fconcepts\u002Fvocabulary#library","library",", the ",[658,1917,1919],{"href":1918},"\u002Fconcepts\u002Fvocabulary#chain","chains",[649,1921,405],{},[649,1923,417],{},[649,1925,483],{},[649,1927,487],{}," from disk, with no restart. It also clears the forge token cache, as a Settings save does. It takes no flags.",[645,1930,1931,1934,1935,660,1937,660,1939,663,1941,1943,1944,660,1946,660,1948,1103,1950,1952],{},[649,1932,1933],{},"kraft admin reload"," rereads the library, the chains, ",[649,1936,405],{},[649,1938,417],{},[649,1940,483],{},[649,1942,487],{},". A ",[649,1945,405],{},[649,1947,417],{},[649,1949,483],{},[649,1951,487],{}," that doesn't load is refused and the running one is kept. Reload names it and exits 1, as it does for a chain that doesn't resolve.",[645,1954,1955,1956,663,1959,1962,1963,679],{},"It also rereads ",[649,1957,1958],{},"addons.yaml",[649,1960,1961],{},"addons.lock",", and restores in the background any add-on store the lock names and this machine lacks. An add-on file that doesn't read is refused, and the server keeps the add-ons it has. See ",[658,1964,1966],{"href":1965},"\u002Freference\u002Fconfiguration\u002Faddons#what-loads","What loads",[681,1968,1970],{"id":1969},"check-the-server","Check the server",[935,1972,1974],{"id":1973},"admin-health",[649,1975,756],{},[941,1977,1980],{"className":1978,"code":1979,"language":946,"meta":947},[944],"kraft admin health [flags]\n",[649,1981,1982],{"__ignoreMap":947},[951,1983,1979],{"className":1984},[954],[645,1986,1987],{},"Prints the server's state and exits 1 when it is degraded, with the reasons on stdout. It takes no flags.",[1646,1989,1991],{"id":1990},"what-health-prints","What health prints",[645,1993,1994,1997,1998,2001,2002,2005,2006,2009,2010,2013,2014,2017],{},[649,1995,1996],{},"kraft admin health"," prints the server's state as ",[649,1999,2000],{},"key  value"," lines, and exits 1 unless ",[649,2003,2004],{},"status"," is ",[649,2007,2008],{},"ok",". The line after ",[649,2011,2012],{},"version"," and the lines after ",[649,2015,2016],{},"embeddings"," appear only when they apply:",[1222,2019,2020,2030,2042,2064,2076],{},[1225,2021,2022,2025,2026,2029],{},[649,2023,2024],{},"installed"," names the installed version with ",[649,2027,2028],{},"restart pending",", after an update the server hasn't restarted for. It isn't degraded.",[1225,2031,2032,660,2035,663,2038,2041],{},[649,2033,2034],{},"invalid template",[649,2036,2037],{},"invalid policy",[649,2039,2040],{},"invalid intake"," name each file that doesn't load, with the reason.",[1225,2043,2044,2047,2048,2051,2052,2055,2056,2059,2060,2063],{},[649,2045,2046],{},"storage"," shows worktree usage against ",[649,2049,2050],{},"storage.worktrees.limit",", and appears only when a limit is set. ",[649,2053,2054],{},"held"," makes the status ",[649,2057,2058],{},"degraded",", so the command exits 1. With ",[649,2061,2062],{},"auto_cleanup"," set, the line also says how many finished items ended too recently to clean up.",[1225,2065,2066,2069,2070,2073,2074,679],{},[649,2067,2068],{},"forge token"," names a ",[649,2071,2072],{},"client: api"," account whose token is refused, lacks rights, has no value or fails TLS, or expires within 7 days. It makes the status ",[649,2075,2058],{},[1225,2077,2078,660,2081,663,2084,2087],{},[649,2079,2080],{},"index error",[649,2082,2083],{},"reattached",[649,2085,2086],{},"orphaned sessions"," report the search index and the agent sessions found at startup.",[941,2089,2092],{"className":2090,"code":2091,"language":946,"meta":947},[944],"status         ok\nversion        2.0.0\nbind           127.0.0.1\ndocuments      214\nrepos scanned  3\nlast scan      4m ago\nembeddings     available\n",[649,2093,2094,2098,2102,2106,2110,2114,2118],{"__ignoreMap":947},[951,2095,2097],{"className":2096},[954],"status         ok\n",[951,2099,2101],{"className":2100},[954],"version        2.0.0\n",[951,2103,2105],{"className":2104},[954],"bind           127.0.0.1\n",[951,2107,2109],{"className":2108},[954],"documents      214\n",[951,2111,2113],{"className":2112},[954],"repos scanned  3\n",[951,2115,2117],{"className":2116},[954],"last scan      4m ago\n",[951,2119,2121],{"className":2120},[954],"embeddings     available\n",[645,2123,2124,1110,2126,2132],{},[649,2125,673],{},[658,2127,2129],{"href":2128},"\u002Freference\u002Fhttp-api#get-apihealth",[649,2130,2131],{},"GET \u002Fapi\u002Fhealth"," answer.",[935,2134,2136],{"id":2135},"admin-doctor",[649,2137,769],{},[941,2139,2142],{"className":2140,"code":2141,"language":946,"meta":947},[944],"kraft admin doctor [flags]\n",[649,2143,2144],{"__ignoreMap":947},[951,2145,2141],{"className":2146},[954],[645,2148,2149],{},"Runs every check in one pass. Exits 1 if any fails. It takes no flags.",[1646,2151,2153],{"id":2152},"what-doctor-checks","What doctor checks",[645,2155,2156,2158,2159,2161,2162,2164],{},[649,2157,1685],{}," runs every check in one pass, one line per check, and exits 1 if any fails. ",[649,2160,673],{}," prints the rows. ",[649,2163,1996],{}," checks only the server.",[645,2166,2167,2168,660,2170,660,2173,1103,2176,2179,2180,2182,2183,2185,2186,2188,2189,2191,2192,2195,2196,2199],{},"Each line starts with ",[649,2169,2008],{},[649,2171,2172],{},"warn",[649,2174,2175],{},"FAIL",[649,2177,2178],{},"skip",", then the check's name and what it found. With ",[649,2181,2050],{}," set, a ",[649,2184,2046],{}," row says how much the worktrees use of the limit: ",[649,2187,2008],{}," under the quota, ",[649,2190,2172],{}," over it, and over the limit a failing ",[649,2193,2194],{},"health"," row. A row about one repository carries its name, such as ",[649,2197,2198],{},"setup my-repo",". The last line counts them.",[941,2201,2204],{"className":2202,"code":2203,"language":946,"meta":947},[944],"ok    server            http:\u002F\u002F127.0.0.1:8765\nok    health            ok\n...\nok    restart           the server (pid 4242) runs the installed version (2.0.0)\nok    config            \u002FUsers\u002Fyou\u002F.kraft\u002Fconfig\nok    access.yaml       parses\n...\nok    spa bundle        \u002Fusr\u002Flib\u002Fkraft\u002F_bundled\u002Fweb\n...\nok    repo app          \u002FUsers\u002Fyou\u002Fcode\u002Fapp\nok    forge app         github · gh\nok    worktrees         \u002FUsers\u002Fyou\u002F.kraft\u002Frun\u002Fworktrees\nok    review bots       no review bot silent across 3 items\n\nall 26 checks passed\n",[649,2205,2206,2210,2214,2218,2222,2226,2230,2233,2237,2240,2244,2248,2252,2256,2263],{"__ignoreMap":947},[951,2207,2209],{"className":2208},[954],"ok    server            http:\u002F\u002F127.0.0.1:8765\n",[951,2211,2213],{"className":2212},[954],"ok    health            ok\n",[951,2215,2217],{"className":2216},[954],"...\n",[951,2219,2221],{"className":2220},[954],"ok    restart           the server (pid 4242) runs the installed version (2.0.0)\n",[951,2223,2225],{"className":2224},[954],"ok    config            \u002FUsers\u002Fyou\u002F.kraft\u002Fconfig\n",[951,2227,2229],{"className":2228},[954],"ok    access.yaml       parses\n",[951,2231,2217],{"className":2232},[954],[951,2234,2236],{"className":2235},[954],"ok    spa bundle        \u002Fusr\u002Flib\u002Fkraft\u002F_bundled\u002Fweb\n",[951,2238,2217],{"className":2239},[954],[951,2241,2243],{"className":2242},[954],"ok    repo app          \u002FUsers\u002Fyou\u002Fcode\u002Fapp\n",[951,2245,2247],{"className":2246},[954],"ok    forge app         github · gh\n",[951,2249,2251],{"className":2250},[954],"ok    worktrees         \u002FUsers\u002Fyou\u002F.kraft\u002Frun\u002Fworktrees\n",[951,2253,2255],{"className":2254},[954],"ok    review bots       no review bot silent across 3 items\n",[951,2257,2259],{"className":2258},[954],[951,2260,2262],{"emptyLinePlaceholder":2261},true,"\n",[951,2264,2266],{"className":2265},[954],"all 26 checks passed\n",[645,2268,2269,2270,2273,2274,2277,2278,2280,2281,2284,2285,2288],{},"The excerpt cuts the rows marked ",[649,2271,2272],{},"...",". The count is for a running server, the shipped chains with ",[649,2275,2276],{},"claude"," on ",[649,2279,1436],{},", and one connected repo, ",[649,2282,2283],{},"app",", with its commands declared. It grows with each connected repo and each harness profile the chains select. With no repo connected, a ",[649,2286,2287],{},"repos  none connected"," row stands in for the repo rows.",[645,2290,2291,2293],{},[658,2292,270],{"href":271}," lists every row with its fix.",[681,2295,2297],{"id":2296},"inspect-templates-and-harnesses","Inspect templates and harnesses",[935,2299,2301],{"id":2300},"admin-templates-lint",[649,2302,849],{},[941,2304,2307],{"className":2305,"code":2306,"language":946,"meta":947},[944],"kraft admin templates lint [flags]\n",[649,2308,2309],{"__ignoreMap":947},[951,2310,2306],{"className":2311},[954],[645,2313,2314],{},"Checks every chain in the library and exits 1 on any error.",[686,2316,2317,2329],{},[689,2318,2319],{},[692,2320,2321,2323,2325,2327],{},[695,2322,971],{},[695,2324,974],{},[695,2326,977],{},[695,2328,980],{},[702,2330,2331],{},[692,2332,2333,2338,2341,2344],{},[707,2334,2335],{},[649,2336,2337],{},"--dir",[707,2339,2340],{},"path",[707,2342,2343],{},"none: it asks the server",[707,2345,2346,2347,679],{},"Checks that directory in-process, with no server and no ",[649,2348,2349],{},"$KRAFT_HOME",[645,2351,2352,2355,2356,2359,2360,2363,2364,679],{},[649,2353,2354],{},"kraft admin templates lint"," checks every chain in the library, including that ",[649,2357,2358],{},"harnesses.yaml"," can launch each agent task (a task's ",[649,2361,2362],{},"profile:"," naming an agent profile with no model for its harness's provider is an error). It exits 1 on any error, printing each as ",[649,2365,2366],{},"file:line:column: message",[935,2368,2370],{"id":2369},"admin-templates-show",[649,2371,862],{},[941,2373,2376],{"className":2374,"code":2375,"language":946,"meta":947},[944],"kraft admin templates show [flags] ID\n",[649,2377,2378],{"__ignoreMap":947},[951,2379,2375],{"className":2380},[954],[645,2382,2383],{},"One chain as written.",[686,2385,2386,2398],{},[689,2387,2388],{},[692,2389,2390,2392,2394,2396],{},[695,2391,971],{},[695,2393,974],{},[695,2395,977],{},[695,2397,980],{},[702,2399,2400],{},[692,2401,2402,2407,2409,2411],{},[707,2403,2404],{},[649,2405,2406],{},"--resolved",[707,2408,1044],{},[707,2410,1047],{},[707,2412,2413],{},"Expands its library components, as a work item would get it.",[645,2415,2416,2419,2420,2422,2423,2425],{},[649,2417,2418],{},"kraft admin templates show ID"," asks the running server. A chain file you just added shows only after ",[649,2421,795],{},", and ",[649,2424,2406],{}," expands the version the server last loaded.",[645,2427,2428,2429,2433,2434,2436,2437,2440,2441,660,2444,1103,2447,2450,2451,2453],{},"For a chain that ",[658,2430,2432],{"href":2431},"\u002Freference\u002Fconfiguration\u002Flibrary-and-chains#extending-a-chain","extends"," another, ",[649,2435,2406],{}," heads the YAML with comment lines: ",[649,2438,2439],{},"# extends \u003Cparent>",", then each node as ",[649,2442,2443],{},"inherited",[649,2445,2446],{},"added",[649,2448,2449],{},"overridden"," (with its override paths), then each parent node it removes. Without ",[649,2452,2406],{},", the chain prints as written.",[645,2455,2456,2457,2460,2461,2463,2464,2467,2468,2471,2472,660,2475,1103,2478,2481,2482,2484,2485,679],{},"A chain that comes from an add-on is headed ",[649,2458,2459],{},"# \u003Cid> (\u003Caddon> \u003Cversion>)",", with or without ",[649,2462,2406],{},", and a ",[658,2465,2466],{"href":140},"child add-on's"," chain ends the parenthesis with ",[649,2469,2470],{},"; \u003Cmark>",": ",[649,2473,2474],{},"inherited from \u003Cparent>",[649,2476,2477],{},"overridden here",[649,2479,2480],{},"added here",". A root add-on's ",[649,2483,2406],{}," output starts with that header, then ",[649,2486,2487],{},"# extends",[941,2489,2492],{"className":2490,"code":2491,"language":946,"meta":947},[944],"# team-payments:default (team-payments@acme 1.0.0; overridden here)\n# extends plat:default\n#   verification: inherited\n#   pci_review: added; pci_review added here\n#   scan: inherited; security_scan overridden here\n",[649,2493,2494,2498,2502,2506,2510],{"__ignoreMap":947},[951,2495,2497],{"className":2496},[954],"# team-payments:default (team-payments@acme 1.0.0; overridden here)\n",[951,2499,2501],{"className":2500},[954],"# extends plat:default\n",[951,2503,2505],{"className":2504},[954],"#   verification: inherited\n",[951,2507,2509],{"className":2508},[954],"#   pci_review: added; pci_review added here\n",[951,2511,2513],{"className":2512},[954],"#   scan: inherited; security_scan overridden here\n",[645,2515,2516,2517,1103,2520,2523,2524,679],{},"A node line ends with ",[649,2518,2519],{},"\u003Ccomponent> overridden here",[649,2521,2522],{},"\u003Ccomponent> added here"," when it is built from a component the child overrides or adds. The parent is named as this instance serves it, here ",[649,2525,2526],{},"plat",[935,2528,2530],{"id":2529},"admin-templates-library",[649,2531,875],{},[941,2533,2536],{"className":2534,"code":2535,"language":946,"meta":947},[944],"kraft admin templates library [flags] [ID]\n",[649,2537,2538],{"__ignoreMap":947},[951,2539,2535],{"className":2540},[954],[645,2542,2543],{},"Every library component, its kind and the chains using it. With an ID, one component. It takes no flags.",[645,2545,2546,2549,2550,2553,2554,2557,2558,660,2561,1103,2564,2567,2568,2571],{},[649,2547,2548],{},"kraft admin templates library ID"," takes a component ID such as ",[649,2551,2552],{},"tasks.implementer",", or a unique bare name. A bare name two sections share is refused with each full ID. It prints the component's definition, its users and its lint issues. Without an ID, the ",[649,2555,2556],{},"ID"," column of a child add-on's component ends its parenthesis with ",[649,2559,2560],{},"; inherited from company",[649,2562,2563],{},"; overridden here",[649,2565,2566],{},"; added here",", and a single component's ",[649,2569,2570],{},"id"," row does the same.",[935,2573,2575],{"id":2574},"admin-harnesses",[649,2576,888],{},[941,2578,2581],{"className":2579,"code":2580,"language":946,"meta":947},[944],"kraft admin harnesses [flags] [ID]\n",[649,2582,2583],{"__ignoreMap":947},[951,2584,2580],{"className":2585},[954],[645,2587,2588,2589,2593,2594,2596,2597,2601,2602,2605,2606,2610,2611,2615],{},"Every ",[658,2590,2592],{"href":2591},"\u002Fconcepts\u002Fvocabulary#harness-profile","harness profile"," in ",[649,2595,2358],{},", its ",[658,2598,2600],{"href":2599},"\u002Fconcepts\u002Fvocabulary#provider","provider",", and the library tasks and chains selecting it (a chain's own ",[649,2603,2604],{},"harness:"," on a task included), then the ",[658,2607,2609],{"href":2608},"\u002Fconcepts\u002Fvocabulary#agent-profile","agent profiles",". With an ID, one ",[658,2612,2614],{"href":2613},"\u002Fconcepts\u002Fvocabulary#harness","harness"," profile in detail. It takes no flags.",[681,2617,2619],{"id":2618},"service-index-and-agents","Service, index and agents",[935,2621,2623],{"id":2622},"admin-install-service",[649,2624,829],{},[941,2626,2629],{"className":2627,"code":2628,"language":946,"meta":947},[944],"kraft admin install-service\n",[649,2630,2631],{"__ignoreMap":947},[951,2632,2628],{"className":2633},[954],[645,2635,2636,2637,1640,2639,679],{},"Registers Kraft as an OS service (a launchd agent on macOS, a systemd user unit on Linux) that restarts if it exits. Stop a running server first. It takes no flags and no ",[649,2638,673],{},[658,2640,195],{"href":196},[935,2642,2644],{"id":2643},"admin-uninstall-service",[649,2645,838],{},[941,2647,2650],{"className":2648,"code":2649,"language":946,"meta":947},[944],"kraft admin uninstall-service\n",[649,2651,2652],{"__ignoreMap":947},[951,2653,2649],{"className":2654},[954],[645,2656,2657,2658,2661,2662,679],{},"Removes the OS service that ",[649,2659,2660],{},"install-service"," registered. It takes no flags and no ",[649,2663,673],{},[935,2665,2667],{"id":2666},"admin-reindex",[649,2668,816],{},[941,2670,2673],{"className":2671,"code":2672,"language":946,"meta":947},[944],"kraft admin reindex [flags]\n",[649,2674,2675],{"__ignoreMap":947},[951,2676,2672],{"className":2677},[954],[645,2679,819],{},[686,2681,2682,2694],{},[689,2683,2684],{},[692,2685,2686,2688,2690,2692],{},[695,2687,971],{},[695,2689,974],{},[695,2691,977],{},[695,2693,980],{},[702,2695,2696],{},[692,2697,2698,2703,2705,2708],{},[707,2699,2700],{},[649,2701,2702],{},"--repo",[707,2704,2340],{},[707,2706,2707],{},"every repo",[707,2709,2710],{},"Limits it to one repo.",[935,2712,2714],{"id":2713},"admin-init",[649,2715,901],{},[941,2717,2720],{"className":2718,"code":2719,"language":946,"meta":947},[944],"kraft admin init [flags]\n",[649,2721,2722],{"__ignoreMap":947},[951,2723,2719],{"className":2724},[954],[645,2726,2727,2728,679],{},"Registers the MCP server and skills with an agent. See ",[658,2729,97],{"href":98},[686,2731,2732,2744],{},[689,2733,2734],{},[692,2735,2736,2738,2740,2742],{},[695,2737,971],{},[695,2739,974],{},[695,2741,977],{},[695,2743,980],{},[702,2745,2746],{},[692,2747,2748,2752,2754,2756],{},[707,2749,2750],{},[649,2751,2702],{},[707,2753,1044],{},[707,2755,1047],{},[707,2757,2758],{},"Installs into this repo, not your user config.",[935,2760,2762],{"id":2761},"admin-mcp",[649,2763,914],{},[941,2765,2768],{"className":2766,"code":2767,"language":946,"meta":947},[944],"kraft admin mcp\n",[649,2769,2770],{"__ignoreMap":947},[951,2771,2767],{"className":2772},[954],[645,2774,2775,2776,679],{},"Serves the MCP tools over stdio. It takes no flags and no ",[649,2777,673],{},[935,2779,2781],{"id":2780},"admin-permission-hook",[649,2782,927],{},[941,2784,2787],{"className":2785,"code":2786,"language":946,"meta":947},[944],"kraft admin permission-hook [flags] HARNESS\n",[649,2788,2789],{"__ignoreMap":947},[951,2790,2786],{"className":2791},[954],[645,2793,2794,2795,2799,2800,2803,2804,1103,2807,2810,2811,1640,2813,679],{},"What a Cursor or Codex ",[658,2796,2798],{"href":2797},"\u002Fconcepts\u002Fvocabulary#worker","worker","'s pre-tool hook runs, with ",[649,2801,2802],{},"HARNESS"," ",[649,2805,2806],{},"codex",[649,2808,2809],{},"cursor",". You don't run it by hand. It takes no ",[649,2812,673],{},[658,2814,559],{"href":560},[686,2816,2817,2829],{},[689,2818,2819],{},[692,2820,2821,2823,2825,2827],{},[695,2822,971],{},[695,2824,974],{},[695,2826,977],{},[695,2828,980],{},[702,2830,2831],{},[692,2832,2833,2838,2840,2846],{},[707,2834,2835],{},[649,2836,2837],{},"--fail-closed",[707,2839,1044],{},[707,2841,2842,2843],{},"off, or ",[649,2844,2845],{},"KRAFT_PERMISSION_FAIL_CLOSED=1",[707,2847,2848],{},"Denies rather than giving no opinion when Kraft can't answer.",[681,2850,2852],{"id":2851},"related","Related",[1222,2854,2855,2863,2870,2880],{},[1225,2856,2857,2859,2860,2862],{},[658,2858,270],{"href":271},": the fix for each row ",[649,2861,769],{}," can print.",[1225,2864,2865,2471,2867,2869],{},[658,2866,195],{"href":196},[649,2868,2660],{},", and keeping the server up across restarts.",[1225,2871,2872,2874,2875,663,2877,2879],{},[658,2873,183],{"href":184},": what ",[649,2876,1171],{},[649,2878,1269],{}," do to a running step, and how to keep one running.",[1225,2881,2882,2884,2885,2887],{},[658,2883,199],{"href":200},": when to run ",[649,2886,782],{},", and how to pin a version.",{"title":947,"searchDepth":2889,"depth":2889,"links":2890},2,[2891,2892,2898,2902,2906,2912,2923],{"id":683,"depth":2889,"text":684},{"id":933,"depth":2889,"text":169,"children":2893},[2894,2896,2897],{"id":937,"depth":2895,"text":714},3,{"id":1143,"depth":2895,"text":730},{"id":1239,"depth":2895,"text":743},{"id":1393,"depth":2889,"text":1394,"children":2899},[2900,2901],{"id":1397,"depth":2895,"text":782},{"id":1896,"depth":2895,"text":795},{"id":1969,"depth":2889,"text":1970,"children":2903},[2904,2905],{"id":1973,"depth":2895,"text":756},{"id":2135,"depth":2895,"text":769},{"id":2296,"depth":2889,"text":2297,"children":2907},[2908,2909,2910,2911],{"id":2300,"depth":2895,"text":849},{"id":2369,"depth":2895,"text":862},{"id":2529,"depth":2895,"text":875},{"id":2574,"depth":2895,"text":888},{"id":2618,"depth":2889,"text":2619,"children":2913},[2914,2916,2918,2919,2920,2921],{"id":2622,"depth":2895,"text":2915},"admin install-​service",{"id":2643,"depth":2895,"text":2917},"admin uninstall-​service",{"id":2666,"depth":2895,"text":816},{"id":2713,"depth":2895,"text":901},{"id":2761,"depth":2895,"text":914},{"id":2780,"depth":2895,"text":2922},"admin permission-​hook",{"id":2851,"depth":2889,"text":2852},"The kraft admin verbs that run this machine's server: start, stop, restart, update and reload it, check its health and inspect its templates and harnesses.","md",null,{},{"title":357,"description":2924},"lk95xAjxHev9VNrRRhDRb8ZJNTSaKkaRSL2aDO3Uy_I",[2931,2933],{"title":353,"path":354,"stem":355,"description":2932,"children":-1},"The kraft repo verbs: list, connect and disconnect repositories, review and take a repo's library, and reach their worktrees.",{"title":361,"path":362,"stem":363,"description":2934,"children":-1},"The kraft admin addon verbs: add collections, install, update, remove and validate add-ons.",1794749037597]