[{"data":1,"prerenderedAt":1358},["ShallowReactive",2],{"navigation_docs":3,"-reference-web-ui-on-a-phone":639,"-reference-web-ui-on-a-phone-surround":1353},[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":335,"body":641,"description":1346,"extension":1347,"links":1348,"meta":1349,"navigation":1350,"path":336,"seo":1351,"stem":337,"__hash__":1352},"docs\u002F5.reference\u002F00.web-ui\u002F9.on-a-phone.md",{"type":642,"value":643,"toc":1330},"minimark",[644,652,657,665,668,713,728,731,767,770,803,813,820,824,827,927,950,955,961,972,995,1005,1009,1012,1173,1206,1210,1215,1237,1250,1267,1271,1275,1299,1303],[645,646,647,648,651],"p",{},"The phone layout switches on a screen narrower than 768 pixels, at the same address as the desktop, and each card and each stopped item offers its own buttons. To reach the board from a phone, see ",[649,650,113],"a",{"href":114},".",[653,654,656],"h2",{"id":655},"the-layout","The layout",[645,658,659],{},[660,661],"img",{"alt":662,"src":663,"width":664},"The board at a 390px phone viewport, with bottom tab navigation, status chips and Chain, Gate and Stop reason menus, and cards for an item at a gate whose Review button opens the review, and stopped items with Retry and Raise cap","\u002Fassets\u002Fmobile.png",300,[645,666,667],{},"The layout switches on its own when the window is narrower than 768 pixels, with\nno setting to turn on. It is the same app at the same address, so a link copied\non one opens on the other. Widening the window brings the desktop layout back on\nthe same page.",[669,670,671,692,705],"ul",{},[672,673,674,675,679,680,679,683,688,689,651],"li",{},"A bar at the bottom holds ",[676,677,678],"strong",{},"Board",", ",[676,681,682],{},"Search",[649,684,686],{"href":685},"\u002Freference\u002Fweb-ui\u002Fanalytics#on-a-phone",[676,687,331],{}," and ",[676,690,691],{},"More",[672,693,694,696,697,700,701,704],{},[676,695,691],{}," lists everything else: Chains, Library, Repos, Forge accounts and Harnesses, then\nPolicy, Auto-intake, Notifications, Access, Appearance, Board & code and About, then\nAnalytics and ",[676,698,699],{},"Archived",". An archived item opens from there, and ",[676,702,703],{},"Restore","\non the item puts it back on the board.",[672,706,707,708,712],{},"The phone has no first-run wizard. With no repo connected, the board says\n\"No repository is connected\": connect one from a computer, or run\n",[709,710,711],"code",{},"kraft repo connect"," in the repo on the machine Kraft runs on.",[645,714,715,716,718,719,679,723,727],{},"A phone screen the desktop has no page for lands on the nearest desktop page,\nwhen the window widens or a link sent from a phone opens on a laptop. ",[676,717,691],{},"\nlands on the board. One ",[649,720,722],{"href":721},"\u002Fconcepts\u002Fvocabulary#harness","harness",[649,724,726],{"href":725},"\u002Fconcepts\u002Fvocabulary#agent-profile","agent profile",",\nschedule or notification channel lands on its list, with the harness or agent\nprofile selected.",[653,729,335],{"id":730},"the-board-on-a-phone",[645,732,733,734,679,737,679,740,679,743,746,747,750,751,754,755,759,760,763,764,766],{},"The board filters by ",[676,735,736],{},"All",[676,738,739],{},"Needs you",[676,741,742],{},"Running",[676,744,745],{},"Not started"," and\n",[676,748,749],{},"Done",", the desktop board's groups. The ",[676,752,753],{},"+"," button files a new ",[649,756,758],{"href":757},"\u002Fconcepts\u002Fvocabulary#work-item","work item","\n(",[676,761,762],{},"New work item","), as ",[649,765,93],{"href":94},"\ndescribes.",[645,768,769],{},"A card that needs you carries its own buttons:",[669,771,772,781,787,793],{},[672,773,774,688,777,780],{},[676,775,776],{},"Approve",[676,778,779],{},"Request changes…"," for a gate;",[672,782,783,786],{},[676,784,785],{},"Answer…"," for a question;",[672,788,789,792],{},[676,790,791],{},"Retry…"," for a failed item;",[672,794,795,798,799,802],{},[676,796,797],{},"Raise cap"," for a cap and ",[676,800,801],{},"Raise budget"," for a dollar cap. Those two open\nthe item with its raise sheet over it, or on its card, which says why, when\nthe item can't raise it.",[645,804,805,806,808,809,812],{},"Tap the card for the item. ",[676,807,776],{}," asks first, naming the node the item\nmoves on to, since a passed gate isn't taken back. ",[676,810,811],{},"Open the review"," there\nreads the gate's document instead.",[645,814,815,816,819],{},"After ",[709,817,818],{},"kraft admin update"," installs a release under a running server, the board\nsays so in a line under its filters, as the desktop's sidebar does. Restart to\nfinish the update. For an older release installed over a newer one, read About\nfirst.",[653,821,823],{"id":822},"an-item-on-a-phone","An item on a phone",[645,825,826],{},"An item opens as its chain, node by node. Tap a node for its tasks, a task for\nits log.",[669,828,829,839,847,858,865,868,871,878,885,888,894,900,907,912],{},[672,830,831,832,746,835,838],{},"A node whose fix loop has gone past its first round shows a chip for each\nround. Tap one to see that round's tasks, and the loop's ",[676,833,834],{},"repair",[676,836,837],{},"judge"," for it. Each opens like any other task.",[672,840,841,842,846],{},"A node the chain ran again, after a gate rejection, a retry or a base change,\nshows a chip for each ",[649,843,845],{"href":844},"\u002Fconcepts\u002Fvocabulary#pass","pass"," above the rounds. Tap\none for that pass's rounds, tasks and logs. A task or scope opened from it\nsays which pass it is.",[672,848,849,850,853,854,857],{},"A gate asked more than once shows a chip for each round, such as\n",[676,851,852],{},"round 1 · changes requested",", wrapped onto as many lines as it needs. Tap\none for that round's decision, who made it and where it sent the work, with\nthe first paragraph of its note, rendered and clipped at three lines. When\nthe note has more, ",[676,855,856],{},"Read the note"," opens the whole note in a sheet. A gate\nasked once has no chips.",[672,859,860,861,864],{},"A review round, one with a review or review threads, also shows the review's\nsummary, the thread count line and its first three threads. The review's\noutcome shows only when it differs from how the round ended. The note stays\nbeside the review, unless it was the review-thread bounce's. ",[676,862,863],{},"Open in\nreview"," goes to that round, read-only, where each thread names its file and\nlines.",[672,866,867],{},"A task that ran more than once in a round offers its attempts. A test task\nthat picks scopes lists them instead, each with its command. When the item\nspans several repositories, each scope is under its repository's name.",[672,869,870],{},"Tap a scope for its command, the paths that select it, how the other rounds\ntreated it and, once it has run, its log.",[672,872,873,874,877],{},"A test task reads ",[676,875,876],{},"failed"," when one of its scopes failed, even if a later\none passed.",[672,879,880,881,884],{},"A sliced item's ",[676,882,883],{},"slices"," node lists its shared groundwork, each slice (tap\none to open its own item) and the join. Its row on the chain says how far the\nslices are, and turns amber when one needs you.",[672,886,887],{},"A slice's header names its parent first; tap it to go to the parent.",[672,889,890,893],{},[676,891,892],{},"Review"," opens the gate's document and diff.",[672,895,896,897,651],{},"Comments you added there and haven't sent are counted as pending, beside the\ndocument's name too, and each is marked ",[676,898,899],{},"pending",[672,901,902,903,906],{},"A thread names its lines as the desktop does (",[709,904,905],{},"lines −2 to +6",") and quotes\nthem. A thread on the whole change is listed above the files.",[672,908,909,911],{},[676,910,776],{}," asks first, since an approval can't be taken back; with pending\ncomments it asks before it sends them with the approval.",[672,913,914,915,918,919,922,923,926],{},"An item that hasn't started offers ",[676,916,917],{},"Start",". When its draft holds changes\nStart wouldn't apply, Start lists them and asks first: ",[676,920,921],{},"Apply and start",",\nor ",[676,924,925],{},"Start without them",". A spec or plan attached when it was filed is listed\nunder its title; tap one to read it.",[645,928,929,930,933,934,688,937,940,941,688,944,946,947,949],{},"A node's bar offers ",[676,931,932],{},"Retry node"," only once the item has stopped. On a paused\nitem it offers ",[676,935,936],{},"Skip node",[676,938,939],{},"Resume",". A node waiting on CI offers\n",[676,942,943],{},"Pause",[676,945,936],{},". A rate-limited node offers only ",[676,948,943],{},", so\npause it first to skip it.",[951,952,954],"h3",{"id":953},"sub-agents","Sub-agents",[645,956,957],{},[958,959,960],"em",{},"Added in 2.6",[645,962,963,964,967,968,971],{},"When Claude Code ran sub-agents in a task, their log lines start with ",[709,965,966],{},"↳"," and the\nsub-agent's description. A chip on its own row above the log, ",[676,969,970],{},"agent: All",",\nopens a sheet to show one sub-agent's lines, or only the main agent's.",[645,973,974,975,978,979,982,983,985,986,679,988,688,991,994],{},"While sub-agents run, the item's ",[676,976,977],{},"Log"," block says so, for example\n",[709,980,981],{},"2 sub-agents running: Explore codebase, Review diff","; tap it to open that task's\nOverview. There, a ",[676,984,954],{}," list groups them as ",[676,987,742],{},[676,989,990],{},"Didn't\nfinish",[676,992,993],{},"Finished",". Finished stays folded until you tap it, unless it is\nthe only group. Each row shows tokens, tool uses and time, with its last tool\nwhile it runs or the start of its answer when it is done.",[645,996,997,998,1001,1002,651],{},"Tap a row to open the log filtered to it, or ",[676,999,1000],{},"Prompt"," to read what it was\nasked. A sub-agent still running when its session ended reads ",[676,1003,1004],{},"cut off",[653,1006,1008],{"id":1007},"the-bar-on-a-stopped-item","The bar on a stopped item",[645,1010,1011],{},"A stopped item has an action bar at the bottom with one or two buttons, chosen\nby why it stopped:",[1013,1014,1015,1028],"table",{},[1016,1017,1018],"thead",{},[1019,1020,1021,1025],"tr",{},[1022,1023,1024],"th",{},"Why it stopped",[1022,1026,1027],{},"The bar offers",[1029,1030,1031,1043,1056,1068,1081,1093,1105,1116,1132,1142,1152,1161],"tbody",{},[1019,1032,1033,1037],{},[1034,1035,1036],"td",{},"At a gate",[1034,1038,1039,688,1041],{},[676,1040,779],{},[676,1042,892],{},[1019,1044,1045,1048],{},[1034,1046,1047],{},"A failure, or most other stops",[1034,1049,1050,688,1053],{},[676,1051,1052],{},"Escalate",[676,1054,1055],{},"Retry",[1019,1057,1058,1061],{},[1034,1059,1060],{},"A question",[1034,1062,1063,688,1065],{},[676,1064,1052],{},[676,1066,1067],{},"Answer",[1019,1069,1070,1073],{},[1034,1071,1072],{},"A merge conflict",[1034,1074,1075,688,1078],{},[676,1076,1077],{},"Cancel…",[676,1079,1080],{},"Review the conflicts",[1019,1082,1083,1086],{},[1034,1084,1085],{},"A closed merge request",[1034,1087,1088,688,1090],{},[676,1089,1077],{},[676,1091,1092],{},"Reopen MR",[1019,1094,1095,1098],{},[1034,1096,1097],{},"A cap that names its limit",[1034,1099,1100,688,1103],{},[676,1101,1102],{},"Steer",[676,1104,797],{},[1019,1106,1107,1110],{},[1034,1108,1109],{},"A cap that names no limit",[1034,1111,1112,688,1114],{},[676,1113,1102],{},[676,1115,1055],{},[1019,1117,1118,1125],{},[1034,1119,1120,1121,1124],{},"A dollar cap the item can raise (its own cap, or the item-wide ",[709,1122,1123],{},"budget_usd",")",[1034,1126,1127,1129,1130],{},[676,1128,801],{}," alone, with no ",[676,1131,1102],{},[1019,1133,1134,1137],{},[1034,1135,1136],{},"A daily, token or node-level cap",[1034,1138,1139,1141],{},[676,1140,1055],{}," alone",[1019,1143,1144,1147],{},[1034,1145,1146],{},"An escalation running",[1034,1148,1149,1151],{},[676,1150,1055],{},", which stops the escalation and retries the node",[1019,1153,1154,1157],{},[1034,1155,1156],{},"Waiting on a rate limit or on CI",[1034,1158,1159,1141],{},[676,1160,943],{},[1019,1162,1163,1166],{},[1034,1164,1165],{},"Blocked behind an unfinished item, which its card lists",[1034,1167,1168,688,1171],{},[676,1169,1170],{},"Unblock",[676,1172,943],{},[669,1174,1175,1186,1189,1195],{},[672,1176,1177,1179,1180,1182,1183,651],{},[676,1178,1102],{}," retries the node with your note. ",[676,1181,797],{}," opens a one-number\nsheet titled for that limit, such as ",[676,1184,1185],{},"Raise the running time cap",[672,1187,1188],{},"For a daily, token or node-level cap, the card says the item can't raise that\ncap, so raise it in the policy or the chain first.",[672,1190,1191,1192,1194],{},"While an escalation runs, its node bar offers ",[676,1193,932],{},". Pause, Steer and\nSkip wait until the escalation answers.",[672,1196,1197,1198,1201,1202,1205],{},"An item waiting on a rate limit or on CI is retried by Kraft itself. Its node\nreads ",[676,1199,1200],{},"waiting on CI"," or ",[676,1203,1204],{},"waiting · rate limit",", not running.",[653,1207,1209],{"id":1208},"approve-a-one-off-chain","Approve a one-off chain",[645,1211,1212],{},[958,1213,1214],{},"Added in 2.5",[645,1216,1217,1219,1220,1224,1225,1228,1229,1232,1233,1236],{},[676,1218,917],{}," on an item whose ",[649,1221,1223],{"href":1222},"\u002Fguides\u002Fday-to-day\u002Ffile-a-work-item#file-with-a-one-off-chain","one-off chain","\nholds custom content nobody approved opens a sheet, ",[676,1226,1227],{},"Approve this chain, then\nstart?",". It lists what the chain adds, overrides and removes, then each custom\npart in full. ",[676,1230,1231],{},"Approve and start"," approves what the sheet showed and starts the\nitem. Kraft records ",[709,1234,1235],{},"phone"," as the door.",[645,1238,1239,1240,1243,1244,1247,1248,651],{},"A sheet that opened without a tap, on a reload or ",[676,1241,1242],{},"Forward",", with nothing left\nto approve, asks ",[676,1245,1246],{},"Start this item?"," and starts nothing until you tap ",[676,1249,917],{},[645,1251,1252,1253,1256,1257,1260,1261,1264,1265,651],{},"The item screen's meta line says where the chain stands: ",[709,1254,1255],{},"one-off chain · approved by you on a phone · 5m ago"," once it is approved (",[709,1258,1259],{},"in the web UI"," for an\napproval on a computer), or ",[709,1262,1263],{},"one-off chain · custom content, not approved yet",".\nA one-off chain with no custom content shows only ",[709,1266,1223],{},[653,1268,1270],{"id":1269},"forge-accounts","Forge accounts",[645,1272,1273],{},[958,1274,1214],{},[645,1276,1277,1279,1280,1282,1283,1286,1287,1290,1291,1294,1295,1298],{},[676,1278,691],{}," > ",[676,1281,1270],{}," lists each account with its token source and the\nstate of its last check. Tap one to ",[676,1284,1285],{},"Test"," it, ",[676,1288,1289],{},"Paste a new token"," (an API\naccount that isn't set by a command), or ",[676,1292,1293],{},"Remove"," it. A token you paste is\nsent once and never shown again. Add an account or change its addresses on a\nwider screen, or with ",[709,1296,1297],{},"kraft admin forge"," in a terminal.",[653,1300,1302],{"id":1301},"related","Related",[669,1304,1305,1310,1315,1325],{},[672,1306,1307,1309],{},[649,1308,113],{"href":114},": make the server reachable and sign in.",[672,1311,1312,1314],{},[649,1313,303],{"href":304},": the desktop board's groups and rows, which the phone's filters mirror.",[672,1316,1317,1319,1320,688,1322,1324],{},[649,1318,105],{"href":106},": what ",[676,1321,797],{},[676,1323,801],{}," open.",[672,1326,1327,1329],{},[649,1328,331],{"href":685},": the Analytics tab on a phone.",{"title":1331,"searchDepth":1332,"depth":1332,"links":1333},"",2,[1334,1335,1336,1341,1342,1344,1345],{"id":655,"depth":1332,"text":656},{"id":730,"depth":1332,"text":335},{"id":822,"depth":1332,"text":823,"children":1337},[1338],{"id":953,"depth":1339,"text":1340},3,"Sub-​agents",{"id":1007,"depth":1332,"text":1008},{"id":1208,"depth":1332,"text":1343},"Approve a one-​off chain",{"id":1269,"depth":1332,"text":1270},{"id":1301,"depth":1332,"text":1302},"The phone layout, with its bottom bar, the board's filters and cards, an item's screens and the buttons on a stopped item.","md",null,{},true,{"title":335,"description":1346},"W7mHcbeEsPSqrRGwfazXiFkTJNBEg16tx0xzL_Wrwes",[1354,1356],{"title":331,"path":332,"stem":333,"description":1355,"children":-1},"What each figure, chart and table on the Analytics screen counts.",{"title":10,"path":340,"stem":341,"description":1357,"children":-1},"Every kraft verb, grouped by what it does, and found by what you want to do.",1794749045771]