[{"data":1,"prerenderedAt":1875},["ShallowReactive",2],{"navigation_docs":3,"-reference-cli":504,"-reference-cli-surround":1870},[4,28,51,187,214,469],{"title":5,"path":6,"stem":7,"children":8},"Get started","\u002Fget-started","1.get-started",[9,12,16,20,24],{"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},"FAQ","\u002Fget-started\u002Ffaq","1.get-started\u002F3.faq",{"title":29,"path":30,"stem":31,"children":32},"Concepts","\u002Fconcepts","2.concepts",[33,35,39,43,47],{"title":10,"path":30,"stem":34},"2.concepts\u002Findex",{"title":36,"path":37,"stem":38},"How a work item runs","\u002Fconcepts\u002Fhow-a-work-item-runs","2.concepts\u002F1.how-a-work-item-runs",{"title":40,"path":41,"stem":42},"Caps and budgets","\u002Fconcepts\u002Fcaps-and-budgets","2.concepts\u002F2.caps-and-budgets",{"title":44,"path":45,"stem":46},"Why a permission gate","\u002Fconcepts\u002Fpermission-gate","2.concepts\u002F3.permission-gate",{"title":48,"path":49,"stem":50},"Vocabulary","\u002Fconcepts\u002Fvocabulary","2.concepts\u002F4.vocabulary",{"title":52,"path":53,"stem":54,"children":55},"Guides","\u002Fguides","3.guides",[56,58,96,113,134,183],{"title":10,"path":53,"stem":57},"3.guides\u002Findex",{"title":59,"path":60,"stem":61,"children":62,"page":95},"Day to day","\u002Fguides\u002Fday-to-day","3.guides\u002F1.day-to-day",[63,67,71,75,79,83,87,91],{"title":64,"path":65,"stem":66},"The setup wizard on first start","\u002Fguides\u002Fday-to-day\u002Ffirst-run","3.guides\u002F1.day-to-day\u002F2.first-run",{"title":68,"path":69,"stem":70},"File a work item","\u002Fguides\u002Fday-to-day\u002Ffile-a-work-item","3.guides\u002F1.day-to-day\u002F3.file-a-work-item",{"title":72,"path":73,"stem":74},"Use Kraft from your agent","\u002Fguides\u002Fday-to-day\u002Fagent-integration","3.guides\u002F1.day-to-day\u002F4.agent-integration",{"title":76,"path":77,"stem":78},"Reviewing a change","\u002Fguides\u002Fday-to-day\u002Freview-a-change","3.guides\u002F1.day-to-day\u002F5.review-a-change",{"title":80,"path":81,"stem":82},"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":84,"path":85,"stem":86},"Kraft for VS Code","\u002Fguides\u002Fday-to-day\u002Fvscode","3.guides\u002F1.day-to-day\u002F7.vscode",{"title":88,"path":89,"stem":90},"Kraft on a phone","\u002Fguides\u002Fday-to-day\u002Fkraft-on-a-phone","3.guides\u002F1.day-to-day\u002F8.kraft-on-a-phone",{"title":92,"path":93,"stem":94},"Get notified when an item needs you","\u002Fguides\u002Fday-to-day\u002Fnotifications","3.guides\u002F1.day-to-day\u002F9.notifications",false,{"title":97,"path":98,"stem":99,"children":100,"page":95},"Customize and automate","\u002Fguides\u002Fcustomize","3.guides\u002F2.customize",[101,105,109],{"title":102,"path":103,"stem":104},"Write your own chain","\u002Fguides\u002Fcustomize\u002Fwrite-your-own-chain","3.guides\u002F2.customize\u002F1.write-your-own-chain",{"title":106,"path":107,"stem":108},"Add a security review or a gate reviewer","\u002Fguides\u002Fcustomize\u002Fadd-review-agents","3.guides\u002F2.customize\u002F2.add-review-agents",{"title":110,"path":111,"stem":112},"Schedule or webhook work","\u002Fguides\u002Fcustomize\u002Fschedule-and-webhook-work","3.guides\u002F2.customize\u002F3.schedule-and-webhook-work",{"title":114,"path":115,"stem":116,"children":117,"page":95},"Agents and harnesses","\u002Fguides\u002Fharnesses","3.guides\u002F3.harnesses",[118,122,126,130],{"title":119,"path":120,"stem":121},"Switch a task to another harness","\u002Fguides\u002Fharnesses\u002Fswitch-harness","3.guides\u002F3.harnesses\u002F1.switch-harness",{"title":123,"path":124,"stem":125},"Add or override a harness","\u002Fguides\u002Fharnesses\u002Fadding-a-harness","3.guides\u002F3.harnesses\u002F2.adding-a-harness",{"title":127,"path":128,"stem":129},"Build a worker Kit","\u002Fguides\u002Fharnesses\u002Fworker-kit","3.guides\u002F3.harnesses\u002F3.worker-kit",{"title":131,"path":132,"stem":133},"Give a worker its login","\u002Fguides\u002Fharnesses\u002Fgive-a-worker-its-login","3.guides\u002F3.harnesses\u002F4.give-a-worker-its-login",{"title":135,"path":136,"stem":137,"children":138,"page":95},"Run the server","\u002Fguides\u002Frun","3.guides\u002F4.run",[139,143,147,151,155,159,163,167,171,175,179],{"title":140,"path":141,"stem":142},"Remote access","\u002Fguides\u002Frun\u002Fremote-access","3.guides\u002F4.run\u002F01.remote-access",{"title":144,"path":145,"stem":146},"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":148,"path":149,"stem":150},"Restart Kraft without ending running agents","\u002Fguides\u002Frun\u002Frestart-kraft","3.guides\u002F4.run\u002F03.restart-kraft",{"title":152,"path":153,"stem":154},"Back up and restore the database","\u002Fguides\u002Frun\u002Fback-up-and-restore","3.guides\u002F4.run\u002F04.back-up-and-restore",{"title":156,"path":157,"stem":158},"Logs and disk space","\u002Fguides\u002Frun\u002Flogs-and-disk-space","3.guides\u002F4.run\u002F05.logs-and-disk-space",{"title":160,"path":161,"stem":162},"Run Kraft as a service","\u002Fguides\u002Frun\u002Frun-as-a-service","3.guides\u002F4.run\u002F06.run-as-a-service",{"title":164,"path":165,"stem":166},"Upgrade Kraft","\u002Fguides\u002Frun\u002Fupgrade-kraft","3.guides\u002F4.run\u002F07.upgrade-kraft",{"title":168,"path":169,"stem":170},"Upgrade your configuration","\u002Fguides\u002Frun\u002Fupgrade-your-configuration","3.guides\u002F4.run\u002F08.upgrade-your-configuration",{"title":172,"path":173,"stem":174},"Upgrade from 1.4","\u002Fguides\u002Frun\u002Fupgrade-from-1-4","3.guides\u002F4.run\u002F09.upgrade-from-1-4",{"title":176,"path":177,"stem":178},"Upgrade from 0.x or a release candidate","\u002Fguides\u002Frun\u002Fupgrade-from-0-x-or-a-release-candidate","3.guides\u002F4.run\u002F10.upgrade-from-0-x-or-a-release-candidate",{"title":180,"path":181,"stem":182},"Roll back to 1.4","\u002Fguides\u002Frun\u002Froll-back","3.guides\u002F4.run\u002F11.roll-back",{"title":184,"path":185,"stem":186},"Kraft Lite","\u002Fguides\u002Fkraft-lite","3.guides\u002F5.kraft-lite",{"title":188,"path":189,"stem":190,"children":191},"Troubleshooting","\u002Ftroubleshooting","4.troubleshooting",[192,194,198,202,206,210],{"title":10,"path":189,"stem":193},"4.troubleshooting\u002Findex",{"title":195,"path":196,"stem":197},"Why did my item stop?","\u002Ftroubleshooting\u002Fwhy-did-my-item-stop","4.troubleshooting\u002F1.why-did-my-item-stop",{"title":199,"path":200,"stem":201},"Stop reasons in detail","\u002Ftroubleshooting\u002Fstop-reasons-in-detail","4.troubleshooting\u002F2.stop-reasons-in-detail",{"title":203,"path":204,"stem":205},"Starting and reaching Kraft","\u002Ftroubleshooting\u002Fstarting-and-reaching-kraft","4.troubleshooting\u002F3.starting-and-reaching-kraft",{"title":207,"path":208,"stem":209},"Doctor failures","\u002Ftroubleshooting\u002Fdoctor-failures","4.troubleshooting\u002F4.doctor-failures",{"title":211,"path":212,"stem":213},"Sandbox and Kit stops","\u002Ftroubleshooting\u002Fsandbox-and-kit-stops","4.troubleshooting\u002F5.sandbox-and-kit-stops",{"title":215,"path":216,"stem":217,"children":218},"Reference","\u002Freference","5.reference",[219,221,259,281,285,375,393,419,423,427,461,465],{"title":10,"path":216,"stem":220},"5.reference\u002Findex",{"title":222,"path":223,"stem":224,"children":225},"Web UI","\u002Freference\u002Fweb-ui","5.reference\u002F00.web-ui\u002Findex",[226,227,231,235,239,243,247,251,255],{"title":10,"path":223,"stem":224},{"title":228,"path":229,"stem":230},"Sidebar, search, and keyboard","\u002Freference\u002Fweb-ui\u002Fsidebar-search-and-keyboard","5.reference\u002F00.web-ui\u002F0.sidebar-search-and-keyboard",{"title":232,"path":233,"stem":234},"The board","\u002Freference\u002Fweb-ui\u002Fboard","5.reference\u002F00.web-ui\u002F1.board",{"title":236,"path":237,"stem":238},"An item's page","\u002Freference\u002Fweb-ui\u002Fitem-page","5.reference\u002F00.web-ui\u002F2.item-page",{"title":240,"path":241,"stem":242},"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":244,"path":245,"stem":246},"Config before an item starts","\u002Freference\u002Fweb-ui\u002Fconfig-before-start","5.reference\u002F00.web-ui\u002F4.config-before-start",{"title":248,"path":249,"stem":250},"The review page","\u002Freference\u002Fweb-ui\u002Freview-page","5.reference\u002F00.web-ui\u002F5.review-page",{"title":252,"path":253,"stem":254},"Templates and Settings","\u002Freference\u002Fweb-ui\u002Ftemplates-and-settings","5.reference\u002F00.web-ui\u002F6.templates-and-settings",{"title":256,"path":257,"stem":258},"Analytics","\u002Freference\u002Fweb-ui\u002Fanalytics","5.reference\u002F00.web-ui\u002F7.analytics",{"title":260,"path":261,"stem":262,"children":263},"CLI","\u002Freference\u002Fcli","5.reference\u002F01.cli\u002Findex",[264,265,269,273,277],{"title":10,"path":261,"stem":262},{"title":266,"path":267,"stem":268},"Item verbs","\u002Freference\u002Fcli\u002Fitem","5.reference\u002F01.cli\u002F2.item",{"title":270,"path":271,"stem":272},"View verbs","\u002Freference\u002Fcli\u002Fview","5.reference\u002F01.cli\u002F3.view",{"title":274,"path":275,"stem":276},"Repo verbs","\u002Freference\u002Fcli\u002Frepo","5.reference\u002F01.cli\u002F4.repo",{"title":278,"path":279,"stem":280},"Admin verbs","\u002Freference\u002Fcli\u002Fadmin","5.reference\u002F01.cli\u002F5.admin",{"title":282,"path":283,"stem":284},"Work item statuses","\u002Freference\u002Fstatuses","5.reference\u002F02.statuses",{"title":286,"path":287,"stem":288,"children":289},"Configuration","\u002Freference\u002Fconfiguration","5.reference\u002F03.configuration\u002Findex",[290,291,309,313,317,321,325,329,333,337,371],{"title":10,"path":287,"stem":288},{"title":292,"path":293,"stem":294,"children":295},"repos.yaml","\u002Freference\u002Fconfiguration\u002Frepos","5.reference\u002F03.configuration\u002F02.repos\u002Findex",[296,297,301,305],{"title":10,"path":293,"stem":294},{"title":298,"path":299,"stem":300},"How connect proposes commands","\u002Freference\u002Fconfiguration\u002Frepos\u002Fconnect-proposals","5.reference\u002F03.configuration\u002F02.repos\u002F1.connect-proposals",{"title":302,"path":303,"stem":304},"detectors.yaml","\u002Freference\u002Fconfiguration\u002Frepos\u002Fdetectors","5.reference\u002F03.configuration\u002F02.repos\u002F2.detectors",{"title":306,"path":307,"stem":308},"Workspaces","\u002Freference\u002Fconfiguration\u002Frepos\u002Fworkspaces","5.reference\u002F03.configuration\u002F02.repos\u002F3.workspaces",{"title":310,"path":311,"stem":312},"policy.yaml","\u002Freference\u002Fconfiguration\u002Fpolicy","5.reference\u002F03.configuration\u002F03.policy",{"title":314,"path":315,"stem":316},"Library and chains","\u002Freference\u002Fconfiguration\u002Flibrary-and-chains","5.reference\u002F03.configuration\u002F04.library-and-chains",{"title":318,"path":319,"stem":320},"harnesses.yaml","\u002Freference\u002Fconfiguration\u002Fharnesses-file","5.reference\u002F03.configuration\u002F05.harnesses-file",{"title":322,"path":323,"stem":324},"access.yaml","\u002Freference\u002Fconfiguration\u002Faccess","5.reference\u002F03.configuration\u002F06.access",{"title":326,"path":327,"stem":328},"intake.yaml","\u002Freference\u002Fconfiguration\u002Fintake","5.reference\u002F03.configuration\u002F07.intake",{"title":330,"path":331,"stem":332},"notify.yaml","\u002Freference\u002Fconfiguration\u002Fnotify","5.reference\u002F03.configuration\u002F08.notify",{"title":334,"path":335,"stem":336},"theme.yaml","\u002Freference\u002Fconfiguration\u002Ftheme","5.reference\u002F03.configuration\u002F09.theme",{"title":338,"path":339,"stem":340,"children":341},"Sandboxed workers","\u002Freference\u002Fconfiguration\u002Fsandbox","5.reference\u002F03.configuration\u002F10.sandbox\u002Findex",[342,343,347,351,355,359,363,367],{"title":10,"path":339,"stem":340},{"title":344,"path":345,"stem":346},"Resource limits","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fresource-limits","5.reference\u002F03.configuration\u002F10.sandbox\u002F1.resource-limits",{"title":348,"path":349,"stem":350},"Callbacks from a sandbox","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fcallbacks","5.reference\u002F03.configuration\u002F10.sandbox\u002F2.callbacks",{"title":352,"path":353,"stem":354},"Network policy","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fnetwork-policy","5.reference\u002F03.configuration\u002F10.sandbox\u002F3.network-policy",{"title":356,"path":357,"stem":358},"Credentials","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fcredentials","5.reference\u002F03.configuration\u002F10.sandbox\u002F4.credentials",{"title":360,"path":361,"stem":362},"Kits","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fkits","5.reference\u002F03.configuration\u002F10.sandbox\u002F5.kits",{"title":364,"path":365,"stem":366},"sandbox.yaml","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fsandbox-yaml","5.reference\u002F03.configuration\u002F10.sandbox\u002F6.sandbox-yaml",{"title":368,"path":369,"stem":370},"Git in a sandbox","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fgit-in-a-sandbox","5.reference\u002F03.configuration\u002F10.sandbox\u002F7.git-in-a-sandbox",{"title":372,"path":373,"stem":374},"Environment variables","\u002Freference\u002Fconfiguration\u002Fenvironment-variables","5.reference\u002F03.configuration\u002F11.environment-variables",{"title":376,"path":377,"stem":378,"children":379},"Chain file keys","\u002Freference\u002Fchain-nodes","5.reference\u002F04.chain-nodes\u002Findex",[380,381,385,389],{"title":10,"path":377,"stem":378},{"title":382,"path":383,"stem":384},"Subprocess tasks","\u002Freference\u002Fchain-nodes\u002Fsubprocess-tasks","5.reference\u002F04.chain-nodes\u002F2.subprocess-tasks",{"title":386,"path":387,"stem":388},"Fix loop and judge","\u002Freference\u002Fchain-nodes\u002Ffix-loop","5.reference\u002F04.chain-nodes\u002F3.fix-loop",{"title":390,"path":391,"stem":392},"Result file","\u002Freference\u002Fchain-nodes\u002Fresult-file","5.reference\u002F04.chain-nodes\u002F4.result-file",{"title":394,"path":395,"stem":396,"children":397},"Agent harnesses","\u002Freference\u002Fharnesses","5.reference\u002F05.harnesses\u002Findex",[398,399,403,407,411,415],{"title":10,"path":395,"stem":396},{"title":400,"path":401,"stem":402},"Unattended runs","\u002Freference\u002Fharnesses\u002Funattended-runs","5.reference\u002F05.harnesses\u002F2.unattended-runs",{"title":404,"path":405,"stem":406},"Agent profiles","\u002Freference\u002Fharnesses\u002Fagent-profiles","5.reference\u002F05.harnesses\u002F3.agent-profiles",{"title":408,"path":409,"stem":410},"Harness definition files","\u002Freference\u002Fharnesses\u002Fharness-files","5.reference\u002F05.harnesses\u002F4.harness-files",{"title":412,"path":413,"stem":414},"Fallback and escalation","\u002Freference\u002Fharnesses\u002Ffallback-and-escalation","5.reference\u002F05.harnesses\u002F5.fallback-and-escalation",{"title":416,"path":417,"stem":418},"Cost reporting","\u002Freference\u002Fharnesses\u002Fcost-reporting","5.reference\u002F05.harnesses\u002F6.cost-reporting",{"title":420,"path":421,"stem":422},"Permission gate","\u002Freference\u002Fpermissions","5.reference\u002F06.permissions",{"title":424,"path":425,"stem":426},"Inbound triggers","\u002Freference\u002Ftriggers","5.reference\u002F07.triggers",{"title":428,"path":429,"stem":430,"children":431},"HTTP API","\u002Freference\u002Fhttp-api","5.reference\u002F08.http-api\u002Findex",[432,433,437,441,445,449,453,457],{"title":10,"path":429,"stem":430},{"title":434,"path":435,"stem":436},"Filing, reading and changing work items","\u002Freference\u002Fhttp-api\u002Fwork-items","5.reference\u002F08.http-api\u002F2.work-items",{"title":438,"path":439,"stem":440},"Gates, run control, ending and retry","\u002Freference\u002Fhttp-api\u002Fgates-run-control-and-ending","5.reference\u002F08.http-api\u002F3.gates-run-control-and-ending",{"title":442,"path":443,"stem":444},"The work item object","\u002Freference\u002Fhttp-api\u002Fwork-item-object","5.reference\u002F08.http-api\u002F4.work-item-object",{"title":446,"path":447,"stem":448},"Budget, events, diff and documents","\u002Freference\u002Fhttp-api\u002Fbudget-and-events","5.reference\u002F08.http-api\u002F5.budget-and-events",{"title":450,"path":451,"stem":452},"Repos, chains, harnesses and the server","\u002Freference\u002Fhttp-api\u002Frepos-chains-harnesses-and-server","5.reference\u002F08.http-api\u002F6.repos-chains-harnesses-and-server",{"title":454,"path":455,"stem":456},"Drafts","\u002Freference\u002Fhttp-api\u002Fdrafts","5.reference\u002F08.http-api\u002F7.drafts",{"title":458,"path":459,"stem":460},"Ops for each draft area","\u002Freference\u002Fhttp-api\u002Fdraft-ops","5.reference\u002F08.http-api\u002F8.draft-ops",{"title":462,"path":463,"stem":464},"MCP tools","\u002Freference\u002Fmcp-tools","5.reference\u002F09.mcp-tools",{"title":466,"path":467,"stem":468},"Events","\u002Freference\u002Fevents","5.reference\u002F10.events",{"title":470,"path":471,"stem":472,"children":473},"Security and project","\u002Fproject","6.project",[474,476,480,484,488,492,496,500],{"title":10,"path":471,"stem":475},"6.project\u002Findex",{"title":477,"path":478,"stem":479},"Security","\u002Fproject\u002Fsecurity","6.project\u002F1.security",{"title":481,"path":482,"stem":483},"Data and privacy","\u002Fproject\u002Fdata-and-privacy","6.project\u002F2.data-and-privacy",{"title":485,"path":486,"stem":487},"What's new in 2.0","\u002Fproject\u002Fwhats-new","6.project\u002F3.whats-new",{"title":489,"path":490,"stem":491},"Status and support","\u002Fproject\u002Fstatus-and-support","6.project\u002F4.status-and-support",{"title":493,"path":494,"stem":495},"Architecture","\u002Fproject\u002Farchitecture","6.project\u002F5.architecture",{"title":497,"path":498,"stem":499},"Source map","\u002Fproject\u002Fsource-map","6.project\u002F6.source-map",{"title":501,"path":502,"stem":503},"Contributing","\u002Fproject\u002Fcontributing","6.project\u002F7.contributing",{"id":505,"title":260,"body":506,"description":1863,"extension":1864,"links":1865,"meta":1866,"navigation":1867,"path":261,"seo":1868,"stem":262,"__hash__":1869},"docs\u002F5.reference\u002F01.cli\u002Findex.md",{"type":507,"value":508,"toc":1845},"minimark",[509,543,554,559,562,567,706,710,846,850,1012,1016,1203,1207,1381,1396,1400,1411,1476,1479,1589,1595,1725,1733,1778,1794,1798,1819,1823],[510,511,512,516,517,520,521,524,525,528,529,534,535,538,539,542],"p",{},[513,514,515],"code",{},"kraft"," with no arguments starts the server. Every other command talks to a\nrunning server. Verbs live in four groups: ",[513,518,519],{},"item"," acts, ",[513,522,523],{},"view"," reads, ",[513,526,527],{},"repo","\nmanages repositories and their ",[530,531,533],"a",{"href":532},"\u002Fconcepts\u002Fvocabulary#worktree","worktrees",", and ",[513,536,537],{},"admin"," runs this machine's\nserver. Typing an old flat verb (",[513,540,541],{},"kraft list",") prints where it moved.",[510,544,545,548,549,553],{},[513,546,547],{},"kraft \u003Cgroup> \u003Cverb> --help"," prints every flag for one verb. Each group page\ndescribes its verbs and the flags that change what they do. Wherever a\ncommand takes a ",[530,550,552],{"href":551},"\u002Fconcepts\u002Fvocabulary#work-item","work item"," ID, you can omit it when you run the command from\ninside that item's worktree.",[555,556,558],"h2",{"id":557},"find-a-verb-by-what-you-want-to-do","Find a verb by what you want to do",[510,560,561],{},"Each command links to its entry.",[563,564,566],"h3",{"id":565},"filing-work","Filing work",[568,569,570,583],"table",{},[571,572,573],"thead",{},[574,575,576,580],"tr",{},[577,578,579],"th",{},"I want to",[577,581,582],{},"Command",[584,585,586,600,613,626,638,651,663,676,693],"tbody",{},[574,587,588,592],{},[589,590,591],"td",{},"Connect a repo to Kraft",[589,593,594],{},[530,595,597],{"href":596},"\u002Freference\u002Fcli\u002Frepo#connect-a-repo",[513,598,599],{},"kraft repo connect",[574,601,602,605],{},[589,603,604],{},"Check that a repo's setup and test commands work",[589,606,607],{},[530,608,610],{"href":609},"\u002Freference\u002Fcli\u002Frepo#verify-a-repos-commands",[513,611,612],{},"kraft repo connect --verify",[574,614,615,618],{},[589,616,617],{},"Stop tracking a repo",[589,619,620],{},[530,621,623],{"href":622},"\u002Freference\u002Fcli\u002Frepo#disconnect-a-repo",[513,624,625],{},"kraft repo disconnect",[574,627,628,630],{},[589,629,68],{},[589,631,632],{},[530,633,635],{"href":634},"\u002Freference\u002Fcli\u002Fitem#filing-a-work-item",[513,636,637],{},"kraft item create \"title\"",[574,639,640,643],{},[589,641,642],{},"File it with a spec or plan I wrote",[589,644,645],{},[530,646,648],{"href":647},"\u002Freference\u002Fcli\u002Fitem#attach-a-spec-or-plan",[513,649,650],{},"kraft item create \"title\" --spec PATH --plan PATH",[574,652,653,656],{},[589,654,655],{},"File it and start it at once",[589,657,658],{},[530,659,660],{"href":634},[513,661,662],{},"kraft item create \"title\" --autostart",[574,664,665,668],{},[589,666,667],{},"Revise a spec or plan before the item starts",[589,669,670],{},[530,671,673],{"href":672},"\u002Freference\u002Fcli\u002Fitem#change-an-items-setup",[513,674,675],{},"kraft item set-attachments",[574,677,678,686],{},[589,679,680,681,685],{},"Switch the ",[530,682,684],{"href":683},"\u002Fconcepts\u002Fvocabulary#chain","chain"," of an item that has not started",[589,687,688],{},[530,689,690],{"href":672},[513,691,692],{},"kraft item set-chain",[574,694,695,698],{},[589,696,697],{},"Start an item that was filed paused",[589,699,700],{},[530,701,703],{"href":702},"\u002Freference\u002Fcli\u002Fitem#approve-reject-pause-resume-retry-raise-a-budget",[513,704,705],{},"kraft item resume",[563,707,709],{"id":708},"watching","Watching",[568,711,712,720],{},[571,713,714],{},[574,715,716,718],{},[577,717,579],{},[577,719,582],{},[584,721,722,735,748,760,777,790,803,815,828],{},[574,723,724,727],{},[589,725,726],{},"See the board",[589,728,729],{},[530,730,732],{"href":731},"\u002Freference\u002Fcli\u002Fview#reading-the-board",[513,733,734],{},"kraft view list",[574,736,737,740],{},[589,738,739],{},"See where one item stands",[589,741,742],{},[530,743,745],{"href":744},"\u002Freference\u002Fcli\u002Fview#what-view-show-prints",[513,746,747],{},"kraft view show",[574,749,750,753],{},[589,751,752],{},"Find a spec, plan or summary",[589,754,755],{},[530,756,757],{"href":731},[513,758,759],{},"kraft view search \"query\"",[574,761,762,765],{},[589,763,764],{},"List an item's specs, plans and summaries, or read one",[589,766,767],{},[530,768,770,773,774],{"href":769},"\u002Freference\u002Fcli\u002Fview#reviewing-before-you-approve",[513,771,772],{},"kraft view docs",", ",[513,775,776],{},"kraft view doc ID",[574,778,779,782],{},[589,780,781],{},"Follow the agent's log",[589,783,784],{},[530,785,787],{"href":786},"\u002Freference\u002Fcli\u002Fview#read-a-sessions-log",[513,788,789],{},"kraft view logs -f",[574,791,792,795],{},[589,793,794],{},"See what happened to an item, in order",[589,796,797],{},[530,798,800],{"href":799},"\u002Freference\u002Fcli\u002Fview#following-a-running-item",[513,801,802],{},"kraft view events",[574,804,805,808],{},[589,806,807],{},"Watch the board live",[589,809,810],{},[530,811,812],{"href":799},[513,813,814],{},"kraft view watch",[574,816,817,820],{},[589,818,819],{},"See the repos Kraft knows",[589,821,822],{},[530,823,825],{"href":824},"\u002Freference\u002Fcli\u002Frepo#what-repo-list-prints",[513,826,827],{},"kraft repo list",[574,829,830,833],{},[589,831,832],{},"Go to an item's worktree",[589,834,835,840,841],{},[530,836,837],{"href":275},[513,838,839],{},"kraft repo path"," or ",[530,842,843],{"href":275},[513,844,845],{},"kraft repo open",[563,847,849],{"id":848},"at-a-gate","At a gate",[568,851,852,860],{},[571,853,854],{},[574,855,856,858],{},[577,857,579],{},[577,859,582],{},[584,861,862,879,891,904,916,928,941,954,970,986,999],{},[574,863,864,872],{},[589,865,866,867,871],{},"Read the document the ",[530,868,870],{"href":869},"\u002Fconcepts\u002Fvocabulary#gate","gate"," is about",[589,873,874],{},[530,875,876],{"href":769},[513,877,878],{},"kraft view artifact",[574,880,881,884],{},[589,882,883],{},"Read the change",[589,885,886],{},[530,887,888],{"href":769},[513,889,890],{},"kraft view diff",[574,892,893,896],{},[589,894,895],{},"Compare two attempts, or the change since my last review",[589,897,898],{},[530,899,901],{"href":900},"\u002Freference\u002Fcli\u002Fview#reviewing-threads-and-comparing-attempts",[513,902,903],{},"kraft view compare",[574,905,906,909],{},[589,907,908],{},"Approve",[589,910,911],{},[530,912,913],{"href":702},[513,914,915],{},"kraft item approve",[574,917,918,921],{},[589,919,920],{},"Reject, and say why",[589,922,923],{},[530,924,925],{"href":702},[513,926,927],{},"kraft item reject --note \"why\"",[574,929,930,933],{},[589,931,932],{},"Comment on a line of the change",[589,934,935],{},[530,936,938],{"href":937},"\u002Freference\u002Fcli\u002Fitem#comment-on-a-change",[513,939,940],{},"kraft item comment",[574,942,943,946],{},[589,944,945],{},"Send my comments with an outcome",[589,947,948],{},[530,949,951],{"href":950},"\u002Freference\u002Fcli\u002Fitem#send-a-review",[513,952,953],{},"kraft item review",[574,955,956,963],{},[589,957,958,959],{},"List ",[530,960,962],{"href":961},"\u002Fconcepts\u002Fvocabulary#review-thread","review threads",[589,964,965],{},[530,966,967],{"href":900},[513,968,969],{},"kraft view threads",[574,971,972,975],{},[589,973,974],{},"Mark a thread resolved, or reopen it",[589,976,977],{},[530,978,980,773,983],{"href":979},"\u002Freference\u002Fcli\u002Fitem#reviewing-a-change",[513,981,982],{},"kraft item resolve",[513,984,985],{},"kraft item reopen",[574,987,988,991],{},[589,989,990],{},"Pass a gate without running it",[589,992,993],{},[530,994,996],{"href":995},"\u002Freference\u002Fcli\u002Fitem#skip-escalate-end-or-drop-an-item",[513,997,998],{},"kraft item skip",[574,1000,1001,1004],{},[589,1002,1003],{},"Label an item's merge request",[589,1005,1006],{},[530,1007,1009],{"href":1008},"\u002Freference\u002Fcli\u002Fitem#label-the-merge-request",[513,1010,1011],{},"kraft item mr-label",[563,1013,1015],{"id":1014},"when-it-stops","When it stops",[568,1017,1018,1026],{},[571,1019,1020],{},[574,1021,1022,1024],{},[577,1023,579],{},[577,1025,582],{},[584,1027,1028,1045,1062,1078,1091,1108,1120,1132,1145,1156,1176,1191],{},[574,1029,1030,1033],{},[589,1031,1032],{},"See why it stopped",[589,1034,1035,1039,1040],{},[530,1036,1037],{"href":744},[513,1038,747],{},", then ",[530,1041,1042],{"href":786},[513,1043,1044],{},"kraft view logs",[574,1046,1047,1055],{},[589,1048,1049,1050,1054],{},"Run the stopped ",[530,1051,1053],{"href":1052},"\u002Fconcepts\u002Fvocabulary#node","node"," again",[589,1056,1057],{},[530,1058,1059],{"href":702},[513,1060,1061],{},"kraft item retry",[574,1063,1064,1067],{},[589,1065,1066],{},"Redo one step or task, or the whole chain",[589,1068,1069],{},[530,1070,1072,773,1075],{"href":1071},"\u002Freference\u002Fcli\u002Fitem#addressing-work-by-path",[513,1073,1074],{},"kraft item retry --path PATH",[513,1076,1077],{},"--restart",[574,1079,1080,1083],{},[589,1081,1082],{},"Give it more budget",[589,1084,1085],{},[530,1086,1088],{"href":1087},"\u002Freference\u002Fcli\u002Fitem#raise-a-cap-that-stopped-an-item",[513,1089,1090],{},"kraft item raise-budget --usd N",[574,1092,1093,1100],{},[589,1094,1095,1096],{},"Raise a time or token ",[530,1097,1099],{"href":1098},"\u002Fconcepts\u002Fvocabulary#cap","cap",[589,1101,1102],{},[530,1103,1105],{"href":1104},"\u002Freference\u002Fcli\u002Fitem#a-work-items-own-policy",[513,1106,1107],{},"kraft item set-policy",[574,1109,1110,1113],{},[589,1111,1112],{},"Steer an agent that is paused",[589,1114,1115],{},[530,1116,1117],{"href":1071},[513,1118,1119],{},"kraft item resume --steer \"...\"",[574,1121,1122,1125],{},[589,1123,1124],{},"Pause a running item",[589,1126,1127],{},[530,1128,1129],{"href":702},[513,1130,1131],{},"kraft item pause",[574,1133,1134,1137],{},[589,1135,1136],{},"Ask an agent to help with the stop",[589,1138,1139],{},[530,1140,1142],{"href":1141},"\u002Freference\u002Fcli\u002Fitem#escalate-a-stopped-item",[513,1143,1144],{},"kraft item escalate --message \"...\"",[574,1146,1147,1150],{},[589,1148,1149],{},"Skip the node it stopped on",[589,1151,1152],{},[530,1153,1154],{"href":995},[513,1155,998],{},[574,1157,1158,1161],{},[589,1159,1160],{},"Pick another model or effort for it",[589,1162,1163,1169,1170],{},[530,1164,1166],{"href":1165},"\u002Freference\u002Fcli\u002Fitem#set-item-wide-overrides",[513,1167,1168],{},"kraft item set-overrides",", or ",[530,1171,1173],{"href":1172},"\u002Freference\u002Fcli\u002Fitem#one-nodes-agent-tasks",[513,1174,1175],{},"kraft item set-node-override",[574,1177,1178,1181],{},[589,1179,1180],{},"End it as done, or as cancelled",[589,1182,1183],{},[530,1184,1185,773,1188],{"href":995},[513,1186,1187],{},"kraft item complete",[513,1189,1190],{},"kraft item cancel",[574,1192,1193,1196],{},[589,1194,1195],{},"Drop it and delete its worktree",[589,1197,1198],{},[530,1199,1200],{"href":995},[513,1201,1202],{},"kraft item abandon --yes",[563,1204,1206],{"id":1205},"housekeeping","Housekeeping",[568,1208,1209,1217],{},[571,1210,1211],{},[574,1212,1213,1215],{},[577,1214,579],{},[577,1216,582],{},[584,1218,1219,1232,1245,1264,1275,1288,1306,1319,1340,1357,1369],{},[574,1220,1221,1224],{},[589,1222,1223],{},"Check that the server is up",[589,1225,1226],{},[530,1227,1229],{"href":1228},"\u002Freference\u002Fcli\u002Fadmin#what-health-prints",[513,1230,1231],{},"kraft admin health",[574,1233,1234,1237],{},[589,1235,1236],{},"Check the whole install",[589,1238,1239],{},[530,1240,1242],{"href":1241},"\u002Freference\u002Fcli\u002Fadmin#what-doctor-checks",[513,1243,1244],{},"kraft admin doctor",[574,1246,1247,1250],{},[589,1248,1249],{},"Start, stop or restart the server",[589,1251,1252],{},[530,1253,1255,773,1258,773,1261],{"href":1254},"\u002Freference\u002Fcli\u002Fadmin#run-the-server",[513,1256,1257],{},"kraft admin start",[513,1259,1260],{},"stop",[513,1262,1263],{},"restart",[574,1265,1266,1268],{},[589,1267,160],{},[589,1269,1270],{},[530,1271,1272],{"href":279},[513,1273,1274],{},"kraft admin install-service",[574,1276,1277,1280],{},[589,1278,1279],{},"Install the newest release",[589,1281,1282],{},[530,1283,1285],{"href":1284},"\u002Freference\u002Fcli\u002Fadmin#update-kraft",[513,1286,1287],{},"kraft admin update",[574,1289,1290,1298],{},[589,1291,1292,1293,1297],{},"Reread the templates and ",[530,1294,1296],{"href":1295},"\u002Fconcepts\u002Fvocabulary#policy","policy"," after editing them",[589,1299,1300],{},[530,1301,1303],{"href":1302},"\u002Freference\u002Fcli\u002Fadmin#reload-the-configuration",[513,1304,1305],{},"kraft admin reload",[574,1307,1308,1311],{},[589,1309,1310],{},"Check my chains",[589,1312,1313],{},[530,1314,1316],{"href":1315},"\u002Freference\u002Fcli\u002Fadmin#lint-the-templates",[513,1317,1318],{},"kraft admin templates lint",[574,1320,1321,1329],{},[589,1322,1323,1324,1328],{},"Read a chain or a ",[530,1325,1327],{"href":1326},"\u002Fconcepts\u002Fvocabulary#library","library"," component",[589,1330,1331],{},[530,1332,1334,773,1337],{"href":1333},"\u002Freference\u002Fcli\u002Fadmin#show-a-chain",[513,1335,1336],{},"kraft admin templates show",[513,1338,1339],{},"templates library",[574,1341,1342,1350],{},[589,1343,1344,1345,1349],{},"See the ",[530,1346,1348],{"href":1347},"\u002Fconcepts\u002Fvocabulary#harness-profile","harness profiles"," and what selects each",[589,1351,1352],{},[530,1353,1354],{"href":279},[513,1355,1356],{},"kraft admin harnesses",[574,1358,1359,1362],{},[589,1360,1361],{},"Rescan documents into the search index",[589,1363,1364],{},[530,1365,1366],{"href":279},[513,1367,1368],{},"kraft admin reindex",[574,1370,1371,1374],{},[589,1372,1373],{},"Register Kraft with an agent",[589,1375,1376],{},[530,1377,1378],{"href":279},[513,1379,1380],{},"kraft admin init",[510,1382,1383,1386,1387,1390,1391,1395],{},[513,1384,1385],{},"kraft item progress"," and ",[513,1388,1389],{},"kraft item reply"," are ",[530,1392,1394],{"href":1393},"\u002Freference\u002Fcli\u002Fitem#verbs-a-worker-calls","called by a worker",", not by you.",[555,1397,1399],{"id":1398},"output-format","Output format",[510,1401,1402,1403,1406,1407,1410],{},"Every read and action verb accepts ",[513,1404,1405],{},"--json",", which prints the raw API payload.\nIt is the same call the matching ",[530,1408,1409],{"href":463},"MCP tool"," makes, but not\nalways the same value:",[1412,1413,1414,1430,1459],"ul",{},[1415,1416,1417,1420,1421,1425,1426,1429],"li",{},[513,1418,1419],{},"kraft view show --json"," prints the item's full detail (its effective chain, ",[530,1422,1424],{"href":1423},"\u002Fconcepts\u002Fvocabulary#worker","worker"," sessions and stop), where the ",[513,1427,1428],{},"get_work_item"," tool hands an agent a trimmed item.",[1415,1431,1432,1435,1436,773,1439,1386,1442,1445,1446,773,1449,773,1452,840,1455,1458],{},[513,1433,1434],{},"kraft item create --json"," prints a trimmed object, not the raw payload: ",[513,1437,1438],{},"id",[513,1440,1441],{},"status",[513,1443,1444],{},"title",", plus ",[513,1447,1448],{},"slots",[513,1450,1451],{},"repo_warning",[513,1453,1454],{},"bead_warning",[513,1456,1457],{},"duplicate_warning"," when one applies.",[1415,1460,1461,1464,1465,840,1468,1471,1472,1475],{},[513,1462,1463],{},"kraft view list --json"," is scoped to the repo you are in unless you pass ",[513,1466,1467],{},"--all",[513,1469,1470],{},"--repo","; ",[513,1473,1474],{},"list_work_items"," is never scoped.",[510,1477,1478],{},"These verbs do not print the payload:",[568,1480,1481,1491],{},[571,1482,1483],{},[574,1484,1485,1488],{},[577,1486,1487],{},"Verb",[577,1489,1490],{},"Use instead",[584,1492,1493,1510,1529,1546,1559,1572],{},[574,1494,1495,1500],{},[589,1496,1497],{},[513,1498,1499],{},"view watch",[589,1501,1502,1505,1506,1509],{},[513,1503,1504],{},"kraft view events --json"," (",[513,1507,1508],{},"watch"," redraws a board rather than returning a value)",[574,1511,1512,1517],{},[589,1513,1514],{},[513,1515,1516],{},"repo path",[589,1518,1519,1505,1521,1524,1525,1528],{},[513,1520,1419],{},[513,1522,1523],{},"path"," prints one plain line meant for ",[513,1526,1527],{},"cd",")",[574,1530,1531,1543],{},[589,1532,1533,773,1536,773,1538,773,1540],{},[513,1534,1535],{},"admin start",[513,1537,1260],{},[513,1539,1263],{},[513,1541,1542],{},"update",[589,1544,1545],{},"None; these print status lines.",[574,1547,1548,1556],{},[589,1549,1550,773,1553],{},[513,1551,1552],{},"admin install-service",[513,1554,1555],{},"uninstall-service",[589,1557,1558],{},"None.",[574,1560,1561,1569],{},[589,1562,1563,773,1566],{},[513,1564,1565],{},"admin mcp",[513,1567,1568],{},"admin permission-hook",[589,1570,1571],{},"None; these speak a protocol on stdio.",[574,1573,1574,1579],{},[589,1575,1576],{},[513,1577,1578],{},"admin init",[589,1580,1581,1582,1584,1585,1588],{},"None. It accepts ",[513,1583,1405],{}," and ignores it; it prints one ",[513,1586,1587],{},"kraft: wrote PATH"," line per file.",[563,1590,1592,1593],{"id":1591},"without-json","Without ",[513,1594,1405],{},[568,1596,1597,1607],{},[571,1598,1599],{},[574,1600,1601,1604],{},[577,1602,1603],{},"Verbs",[577,1605,1606],{},"What they print",[584,1608,1609,1649,1663,1681,1701,1710],{},[574,1610,1611,1642],{},[589,1612,1613,773,1615,773,1618,773,1621,773,1624,773,1627,773,1630,773,1633,773,1636,773,1639],{},[513,1614,915],{},[513,1616,1617],{},"reject",[513,1619,1620],{},"pause",[513,1622,1623],{},"resume",[513,1625,1626],{},"retry",[513,1628,1629],{},"raise-budget",[513,1631,1632],{},"skip",[513,1634,1635],{},"complete",[513,1637,1638],{},"cancel",[513,1640,1641],{},"escalate",[589,1643,1644,1645,1648],{},"One line saying what they did, most of them with where the item stands now, such as ",[513,1646,1647],{},"approved spec_approval on 4f2c…; the item is now running",".",[574,1650,1651,1660],{},[589,1652,1653,840,1656,1659],{},[513,1654,1655],{},"kraft item review approve",[513,1657,1658],{},"request-changes"," at a pending gate",[589,1661,1662],{},"The same one line.",[574,1664,1665,1674],{},[589,1666,1667,840,1670,1673],{},[513,1668,1669],{},"kraft item review request-changes",[513,1671,1672],{},"comment",", with no gate pending",[589,1675,1676,1677,1680],{},"The review's fields as ",[513,1678,1679],{},"key  value"," lines.",[574,1682,1683,1696],{},[589,1684,1685,1688,1689,1692,1693],{},[513,1686,1687],{},"kraft item abandon",", and every ",[513,1690,1691],{},"set-*"," verb except ",[513,1694,1695],{},"set-chain",[589,1697,1698,1699,1680],{},"The same ",[513,1700,1679],{},[574,1702,1703,1707],{},[589,1704,1705],{},[513,1706,692],{},[589,1708,1709],{},"The chain the item now runs.",[574,1711,1712,1722],{},[589,1713,1714,773,1716,773,1719],{},[513,1715,940],{},[513,1717,1718],{},"resolve",[513,1720,1721],{},"reopen",[589,1723,1724],{},"The thread and where it sits.",[510,1726,1727,1728,1730,1731,1648],{},"The item itself is in ",[513,1729,1405],{},", or in ",[513,1732,747],{},[510,1734,1735,1736,773,1742,773,1747,773,1752,773,1757,1386,1762,1768,1769,1771,1772,1774,1775,1777],{},"The reads you script against print as follows: ",[530,1737,1739],{"href":1738},"\u002Freference\u002Fcli\u002Fview#what-view-list-prints",[513,1740,1741],{},"view list",[530,1743,1744],{"href":744},[513,1745,1746],{},"view show",[530,1748,1749],{"href":824},[513,1750,1751],{},"repo list",[530,1753,1754],{"href":1228},[513,1755,1756],{},"admin health",[530,1758,1759],{"href":1241},[513,1760,1761],{},"admin doctor",[530,1763,1765],{"href":1764},"\u002Freference\u002Fcli\u002Fitem#what-create-prints",[513,1766,1767],{},"item create",". With ",[513,1770,1405],{},", all but ",[513,1773,1767],{}," print the API's own answer: see the ",[530,1776,428],{"href":429}," pages.",[510,1779,1780,1386,1783,1786,1787,1789,1790,1793],{},[513,1781,1782],{},"kraft view logs --json",[513,1784,1785],{},"kraft view events -f --json"," print NDJSON, one\nobject per line, because a stream has no end on which to close an array.\n",[513,1788,1504],{}," without ",[513,1791,1792],{},"-f"," prints one JSON array.",[555,1795,1797],{"id":1796},"shell-completion","Shell completion",[510,1799,1800,1802,1803,1811,1812,1814,1815,1818],{},[513,1801,515],{}," completes verbs with ",[530,1804,1808],{"href":1805,"rel":1806},"https:\u002F\u002Fgithub.com\u002Fkislyuk\u002Fargcomplete",[1807],"nofollow",[513,1809,1810],{},"argcomplete",",\nin any shell ",[513,1813,1810],{}," supports. Register it by adding\n",[513,1816,1817],{},"eval \"$(register-python-argcomplete kraft)\""," to your shell's rc file.",[555,1820,1822],{"id":1821},"in-this-section","In this section",[1412,1824,1825,1830,1835,1840],{},[1415,1826,1827,1829],{},[530,1828,266],{"href":267},": file, approve, reject, pause, resume, retry, skip, escalate, and set policy on a work item.",[1415,1831,1832,1834],{},[530,1833,270],{"href":271},": read the board, follow a running item, and review its diff and documents.",[1415,1836,1837,1839],{},[530,1838,274],{"href":275},": connect repositories and reach their worktrees.",[1415,1841,1842,1844],{},[530,1843,278],{"href":279},": run, check, update, and configure this machine's server.",{"title":1846,"searchDepth":1847,"depth":1847,"links":1848},"",2,[1849,1857,1861,1862],{"id":557,"depth":1847,"text":558,"children":1850},[1851,1853,1854,1855,1856],{"id":565,"depth":1852,"text":566},3,{"id":708,"depth":1852,"text":709},{"id":848,"depth":1852,"text":849},{"id":1014,"depth":1852,"text":1015},{"id":1205,"depth":1852,"text":1206},{"id":1398,"depth":1847,"text":1399,"children":1858},[1859],{"id":1591,"depth":1852,"text":1860},"Without --json",{"id":1796,"depth":1847,"text":1797},{"id":1821,"depth":1847,"text":1822},"Every kraft verb, grouped by what it does, and found by what you want to do.","md",null,{},{"title":10},{"title":260,"description":1863},"3JJtAQEZMvouUq4l-qKFcoLSYDVBfq7UMNQurUgoryY",[1871,1873],{"title":256,"path":257,"stem":258,"description":1872,"children":-1},"What each figure, chart and table on the Analytics screen counts.",{"title":266,"path":267,"stem":268,"description":1874,"children":-1},"The kraft item verbs: file, approve, reject, pause, resume, retry, raise a budget, skip, escalate, and set policy.",1791801254412]