[{"data":1,"prerenderedAt":804},["ShallowReactive",2],{"navigation_en":3,"-docs-cli-project-verbs":153,"-docs-cli-project-verbs-surround":799},{"gettingStarted":4,"guides":41,"cli":87,"configuration":123},[5],{"title":6,"icon":7,"path":8,"stem":9,"children":10,"page":7},"Getting Started",false,"\u002Fdocs\u002Fgetting-started","docs\u002Fgetting-started",[11,16,21,26,31,36],{"title":12,"path":13,"stem":14,"icon":15},"Introduction","\u002Fdocs\u002Fgetting-started\u002Fintroduction","docs\u002Fgetting-started\u002F01.introduction","i-lucide-house",{"title":17,"path":18,"stem":19,"icon":20},"Installation","\u002Fdocs\u002Fgetting-started\u002Finstallation","docs\u002Fgetting-started\u002F02.installation","i-lucide-download",{"title":22,"path":23,"stem":24,"icon":25},"Quick Start","\u002Fdocs\u002Fgetting-started\u002Fquick-start","docs\u002Fgetting-started\u002F03.quick-start","i-lucide-zap",{"title":27,"path":28,"stem":29,"icon":30},"How It Works","\u002Fdocs\u002Fgetting-started\u002Fhow-it-works","docs\u002Fgetting-started\u002F04.how-it-works","i-lucide-workflow",{"title":32,"path":33,"stem":34,"icon":35},"Refs","\u002Fdocs\u002Fgetting-started\u002Frefs","docs\u002Fgetting-started\u002F05.refs","i-lucide-git-branch",{"title":37,"path":38,"stem":39,"icon":40},"Workspaces & Worktrees","\u002Fdocs\u002Fgetting-started\u002Fworkspaces","docs\u002Fgetting-started\u002F06.workspaces","i-lucide-folder-tree",[42],{"title":43,"icon":7,"path":44,"stem":45,"children":46,"page":7},"Guides","\u002Fdocs\u002Fguides","docs\u002Fguides",[47,52,57,62,67,72,77,82],{"title":48,"path":49,"stem":50,"icon":51},"Review a Pull Request","\u002Fdocs\u002Fguides\u002Freview-a-pull-request","docs\u002Fguides\u002F01.review-a-pull-request","i-lucide-git-pull-request",{"title":53,"path":54,"stem":55,"icon":56},"Run Dev Servers in Parallel","\u002Fdocs\u002Fguides\u002Frun-dev-servers-in-parallel","docs\u002Fguides\u002F02.run-dev-servers-in-parallel","i-lucide-plug",{"title":58,"path":59,"stem":60,"icon":61},"Seed Local Files","\u002Fdocs\u002Fguides\u002Fseed-local-files","docs\u002Fguides\u002F03.seed-local-files","i-lucide-sprout",{"title":63,"path":64,"stem":65,"icon":66},"Refresh a Workspace","\u002Fdocs\u002Fguides\u002Frefresh-a-workspace","docs\u002Fguides\u002F04.refresh-a-workspace","i-lucide-refresh-cw",{"title":68,"path":69,"stem":70,"icon":71},"Clean Up Workspaces","\u002Fdocs\u002Fguides\u002Fclean-up-workspaces","docs\u002Fguides\u002F05.clean-up-workspaces","i-lucide-trash-2",{"title":73,"path":74,"stem":75,"icon":76},"Script with uxd","\u002Fdocs\u002Fguides\u002Fscript-with-uxd","docs\u002Fguides\u002F06.script-with-uxd","i-lucide-braces",{"title":78,"path":79,"stem":80,"icon":81},"Install Shell Completions","\u002Fdocs\u002Fguides\u002Fshell-completions","docs\u002Fguides\u002F07.shell-completions","i-lucide-keyboard",{"title":83,"path":84,"stem":85,"icon":86},"Troubleshooting","\u002Fdocs\u002Fguides\u002Ftroubleshooting","docs\u002Fguides\u002F08.troubleshooting","i-lucide-stethoscope",[88],{"title":89,"icon":7,"path":90,"stem":91,"children":92,"page":7},"CLI Reference","\u002Fdocs\u002Fcli","docs\u002Fcli",[93,98,103,108,113,118],{"title":94,"path":95,"stem":96,"icon":97},"Command Grammar","\u002Fdocs\u002Fcli\u002Foverview","docs\u002Fcli\u002F01.overview","i-lucide-terminal",{"title":99,"path":100,"stem":101,"icon":102},"Workspace Verbs","\u002Fdocs\u002Fcli\u002Fworkspace-verbs","docs\u002Fcli\u002F02.workspace-verbs","i-lucide-folder-git-2",{"title":104,"path":105,"stem":106,"icon":107},"Project Verbs","\u002Fdocs\u002Fcli\u002Fproject-verbs","docs\u002Fcli\u002F03.project-verbs","i-lucide-boxes",{"title":109,"path":110,"stem":111,"icon":112},"Top-Level Verbs","\u002Fdocs\u002Fcli\u002Ftop-level-verbs","docs\u002Fcli\u002F04.top-level-verbs","i-lucide-wrench",{"title":114,"path":115,"stem":116,"icon":117},"Global Flags","\u002Fdocs\u002Fcli\u002Fglobal-flags","docs\u002Fcli\u002F05.global-flags","i-lucide-flag",{"title":119,"path":120,"stem":121,"icon":122},"Exit Codes","\u002Fdocs\u002Fcli\u002Fexit-codes","docs\u002Fcli\u002F06.exit-codes","i-lucide-circle-alert",[124],{"title":125,"icon":7,"path":126,"stem":127,"children":128,"page":7},"Configuration","\u002Fdocs\u002Fconfiguration","docs\u002Fconfiguration",[129,134,139,144,148],{"title":130,"path":131,"stem":132,"icon":133},"Overview","\u002Fdocs\u002Fconfiguration\u002Foverview","docs\u002Fconfiguration\u002F01.overview","i-lucide-settings",{"title":135,"path":136,"stem":137,"icon":138},"Project File","\u002Fdocs\u002Fconfiguration\u002Fproject-file","docs\u002Fconfiguration\u002F02.project-file","i-lucide-file-code",{"title":140,"path":141,"stem":142,"icon":143},"Commands & Hooks","\u002Fdocs\u002Fconfiguration\u002Fcommands-and-hooks","docs\u002Fconfiguration\u002F03.commands-and-hooks","i-lucide-play",{"title":145,"path":146,"stem":147,"icon":76},"Environment & Templates","\u002Fdocs\u002Fconfiguration\u002Fenvironment-and-templates","docs\u002Fconfiguration\u002F04.environment-and-templates",{"title":149,"path":150,"stem":151,"icon":152},"Editors","\u002Fdocs\u002Fconfiguration\u002Feditors","docs\u002Fconfiguration\u002F05.editors","i-lucide-app-window",{"id":154,"title":104,"body":155,"description":790,"extension":791,"links":792,"meta":793,"navigation":794,"path":105,"seo":795,"stem":106,"__hash__":798},"docs_cli\u002Fdocs\u002Fcli\u002F03.project-verbs.md",{"type":156,"value":157,"toc":786},"minimark",[158,162,173,179,189,212,218,337,375,393,518,540,543,549,553,556,585,662,674,736,741,747,750,756,759,765,768,774,782],[159,160,161],"p",{},"These verbs take a project and no ref:",[163,164,169],"pre",{"className":165,"code":167,"language":168},[166],"language-text","uxd \u003Cproject> \u003Cverb> [flags]\n","text",[170,171,167],"code",{"__ignoreMap":172},"",[174,175,177],"h2",{"id":176},"list",[170,178,176],{},[159,180,181,182,184,185,188],{},"The project's workspaces. ",[170,183,176],{}," is what a bare ",[170,186,187],{},"uxd \u003Cproject>"," falls back to\nwhen there is no TTY.",[163,190,194],{"className":191,"code":192,"language":193,"meta":172,"style":172},"language-bash shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","uxd my-project list\n","bash",[170,195,196],{"__ignoreMap":172},[197,198,201,205,209],"span",{"class":199,"line":200},"line",1,[197,202,204],{"class":203},"szw1H","uxd",[197,206,208],{"class":207},"semJd"," my-project",[197,210,211],{"class":207}," list\n",[163,213,216],{"className":214,"code":215,"language":168},[166],"SLUG        KIND    BRANCH      STATUS  PORT  AGE  LAST USED\nfeat-login  branch  feat\u002Flogin  clean   3053  1m   0m\n",[170,217,215],{"__ignoreMap":172},[219,220,221,234],"table",{},[222,223,224],"thead",{},[225,226,227,231],"tr",{},[228,229,230],"th",{},"Column",[228,232,233],{},"Meaning",[235,236,237,252,276,286,304,314,324],"tbody",{},[225,238,239,245],{},[240,241,242],"td",{},[170,243,244],{},"SLUG",[240,246,247,248,251],{},"The workspace identifier — what ",[170,249,250],{},"clean"," and the workspace verbs accept",[225,253,254,259],{},[240,255,256],{},[170,257,258],{},"KIND",[240,260,261,264,265,264,268,271,272,275],{},[170,262,263],{},"branch",", ",[170,266,267],{},"pr",[170,269,270],{},"commit",", or ",[170,273,274],{},"path"," (adopted)",[225,277,278,283],{},[240,279,280],{},[170,281,282],{},"BRANCH",[240,284,285],{},"The checked-out branch, when there is one",[225,287,288,293],{},[240,289,290],{},[170,291,292],{},"STATUS",[240,294,295,264,297,264,300,303],{},[170,296,250],{},[170,298,299],{},"dirty",[170,301,302],{},"missing"," — or, for PRs, the PR state plus a CI mark",[225,305,306,311],{},[240,307,308],{},[170,309,310],{},"PORT",[240,312,313],{},"The first allocated port",[225,315,316,321],{},[240,317,318],{},[170,319,320],{},"AGE",[240,322,323],{},"Time since the workspace was created",[225,325,326,331],{},[240,327,328],{},[170,329,330],{},"LAST USED",[240,332,333,334,336],{},"Time since a ",[170,335,204],{}," command last touched it",[219,338,339,349],{},[222,340,341],{},[225,342,343,346],{},[228,344,345],{},"Flag",[228,347,348],{},"Effect",[235,350,351,361],{},[225,352,353,358],{},[240,354,355],{},[170,356,357],{},"--du",[240,359,360],{},"Add a disk-usage column",[225,362,363,368],{},[240,364,365],{},[170,366,367],{},"--json",[240,369,370,371,374],{},"Machine-readable array — deterministic and offline (no ",[170,372,373],{},"gh"," refresh)",[163,376,378],{"className":191,"code":377,"language":193,"meta":172,"style":172},"uxd my-project list --json\n",[170,379,380],{"__ignoreMap":172},[197,381,382,384,386,389],{"class":199,"line":200},[197,383,204],{"class":203},[197,385,208],{"class":207},[197,387,388],{"class":207}," list",[197,390,392],{"class":391},"ssYy9"," --json\n",[163,394,398],{"className":395,"code":396,"language":397,"meta":172,"style":172},"language-json shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","[{\"slug\":\"feat-login\",\"ref\":\"feat\u002Flogin\",\"kind\":\"branch\",\"branch\":\"feat\u002Flogin\",\"path\":\"~\u002Fdev\u002Fuxd\u002Fmy-project\u002Ftrees\u002Ffeat-login\",\"adopted\":false,\"ports\":[3053],\"createdAt\":\"2026-07-25T06:00:28.086Z\",\"lastUsedAt\":\"2026-07-25T06:00:28.148Z\",\"dirty\":false,\"missing\":false}]\n","json",[170,399,400],{"__ignoreMap":172},[197,401,402,406,410,413,416,419,422,424,427,429,432,434,437,439,441,443,445,447,450,452,455,457,460,462,465,467,470,473,476,479,482,484,487,489,492,494,497,499,502,504,506,508,511,513,515],{"class":199,"line":200},[197,403,405],{"class":404},"s7iLA","[{",[197,407,409],{"class":408},"sb7M8","\"slug\"",[197,411,412],{"class":404},":",[197,414,415],{"class":207},"\"feat-login\"",[197,417,418],{"class":404},",",[197,420,421],{"class":408},"\"ref\"",[197,423,412],{"class":404},[197,425,426],{"class":207},"\"feat\u002Flogin\"",[197,428,418],{"class":404},[197,430,431],{"class":408},"\"kind\"",[197,433,412],{"class":404},[197,435,436],{"class":207},"\"branch\"",[197,438,418],{"class":404},[197,440,436],{"class":408},[197,442,412],{"class":404},[197,444,426],{"class":207},[197,446,418],{"class":404},[197,448,449],{"class":408},"\"path\"",[197,451,412],{"class":404},[197,453,454],{"class":207},"\"~\u002Fdev\u002Fuxd\u002Fmy-project\u002Ftrees\u002Ffeat-login\"",[197,456,418],{"class":404},[197,458,459],{"class":408},"\"adopted\"",[197,461,412],{"class":404},[197,463,464],{"class":391},"false",[197,466,418],{"class":404},[197,468,469],{"class":408},"\"ports\"",[197,471,472],{"class":404},":[",[197,474,475],{"class":391},"3053",[197,477,478],{"class":404},"],",[197,480,481],{"class":408},"\"createdAt\"",[197,483,412],{"class":404},[197,485,486],{"class":207},"\"2026-07-25T06:00:28.086Z\"",[197,488,418],{"class":404},[197,490,491],{"class":408},"\"lastUsedAt\"",[197,493,412],{"class":404},[197,495,496],{"class":207},"\"2026-07-25T06:00:28.148Z\"",[197,498,418],{"class":404},[197,500,501],{"class":408},"\"dirty\"",[197,503,412],{"class":404},[197,505,464],{"class":391},[197,507,418],{"class":404},[197,509,510],{"class":408},"\"missing\"",[197,512,412],{"class":404},[197,514,464],{"class":391},[197,516,517],{"class":404},"}]\n",[519,520,522,523,525,526,529,530,533,534,536,537,539],"note",{"title":521},"PR status is best-effort","For PR workspaces, ",[170,524,292],{}," shows the PR state plus a CI mark (",[170,527,528],{},"✓"," pass,\n",[170,531,532],{},"✗"," fail), refreshed from ",[170,535,373],{}," stale-while-revalidate and bounded to about two\nseconds. The table always renders, even when ",[170,538,373],{}," is slow or absent.",[159,541,542],{},"With no workspaces:",[163,544,547],{"className":545,"code":546,"language":168},[166],"→ no workspaces for 'my-project'\n",[170,548,546],{"__ignoreMap":172},[174,550,551],{"id":250},[170,552,250],{},[159,554,555],{},"Removes workspaces by explicit slug or by filter. Explicit slugs and filters\ncannot be combined.",[163,557,559],{"className":191,"code":558,"language":193,"meta":172,"style":172},"uxd my-project clean feat-login\nuxd my-project clean --all\n",[170,560,561,573],{"__ignoreMap":172},[197,562,563,565,567,570],{"class":199,"line":200},[197,564,204],{"class":203},[197,566,208],{"class":207},[197,568,569],{"class":207}," clean",[197,571,572],{"class":207}," feat-login\n",[197,574,576,578,580,582],{"class":199,"line":575},2,[197,577,204],{"class":203},[197,579,208],{"class":207},[197,581,569],{"class":207},[197,583,584],{"class":391}," --all\n",[219,586,587,597],{},[222,588,589],{},[225,590,591,594],{},[228,592,593],{},"Filter",[228,595,596],{},"Removes",[235,598,599,609,619,632],{},[225,600,601,606],{},[240,602,603],{},[170,604,605],{},"--all",[240,607,608],{},"Every workspace for the project",[225,610,611,616],{},[240,612,613],{},[170,614,615],{},"--merged",[240,617,618],{},"Branches merged into the default branch (git-only check)",[225,620,621,626],{},[240,622,623],{},[170,624,625],{},"--closed",[240,627,628,629,631],{},"Workspaces whose PR is closed or merged (prefers ",[170,630,373],{},")",[225,633,634,639],{},[240,635,636],{},[170,637,638],{},"--older-than \u003Cdur>",[240,640,641,642,645,646,649,650,649,653,649,656,649,659,631],{},"Workspaces idle for at least ",[170,643,644],{},"\u003Cdur>"," (",[170,647,648],{},"s","\u002F",[170,651,652],{},"m",[170,654,655],{},"h",[170,657,658],{},"d",[170,660,661],{},"w",[159,663,664,665,669,670,673],{},"Filters ",[666,667,668],"strong",{},"intersect",": ",[170,671,672],{},"--merged --older-than 7d"," removes only workspaces that\nare both.",[219,675,676,684],{},[222,677,678],{},[225,679,680,682],{},[228,681,345],{},[228,683,348],{},[235,685,686,696,706,716,726],{},[225,687,688,693],{},[240,689,690],{},[170,691,692],{},"--force",[240,694,695],{},"Remove dirty worktrees too (discards changes)",[225,697,698,703],{},[240,699,700],{},[170,701,702],{},"--include-adopted",[240,704,705],{},"Include workspaces adopted from a path",[225,707,708,713],{},[240,709,710],{},[170,711,712],{},"--prune-state",[240,714,715],{},"Drop state entries whose worktree is gone",[225,717,718,723],{},[240,719,720],{},[170,721,722],{},"--yes",[240,724,725],{},"Skip the confirmation prompt",[225,727,728,733],{},[240,729,730],{},[170,731,732],{},"--dry-run",[240,734,735],{},"Print the plan and stop",[159,737,738,740],{},[170,739,250],{}," always prints a plan first:",[163,742,745],{"className":743,"code":744,"language":168},[166],"→ plan:\n  feat-login (clean, 16 KB)\n",[170,746,744],{"__ignoreMap":172},[159,748,749],{},"and then, once approved, the removed slugs and the space reclaimed:",[163,751,754],{"className":752,"code":753,"language":168},[166],"feat-login\n→ freed 16 KB\n",[170,755,753],{"__ignoreMap":172},[159,757,758],{},"Dirty worktrees are skipped with a warning rather than removed:",[163,760,763],{"className":761,"code":762,"language":168},[166],"warning: skipping feat-login: worktree is dirty (use --force)\n",[170,764,762],{"__ignoreMap":172},[159,766,767],{},"Without confirmation on a non-interactive terminal:",[163,769,772],{"className":770,"code":771,"language":168},[166],"error(E_USAGE): refusing to remove 1 workspace(s) without confirmation\nhint: pass --yes for non-interactive use\n",[170,773,771],{"__ignoreMap":172},[159,775,776,777,781],{},"See ",[778,779,780],"a",{"href":69},"Clean up workspaces"," for the full\nworkflow.",[783,784,785],"style",{},"html pre.shiki code .szw1H, html code.shiki .szw1H{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFB757}html pre.shiki code .semJd, html code.shiki .semJd{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#ADDCFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .ssYy9, html code.shiki .ssYy9{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#91CBFF}html pre.shiki code .s7iLA, html code.shiki .s7iLA{--shiki-light:#0E1116;--shiki-default:#0E1116;--shiki-dark:#F0F3F6}html pre.shiki code .sb7M8, html code.shiki .sb7M8{--shiki-light:#024C1A;--shiki-default:#024C1A;--shiki-dark:#72F088}",{"title":172,"searchDepth":575,"depth":575,"links":787},[788,789],{"id":176,"depth":575,"text":176},{"id":250,"depth":575,"text":250},"Reference for list and clean — the verbs that take a project but no ref.","md",null,{},{"icon":107},{"title":796,"description":797},"uxd Project Verbs","Reference for uxd list and clean — columns, filters, safety rules, and the JSON shapes they emit.","k8M3ilTUaKTg0TUcCgZm7mthmWesqEu3JGNmmx9bCHo",[800,802],{"title":99,"path":100,"stem":101,"description":801,"icon":102,"children":-1},"Reference for checkout, code, run, exec, shell, sync, diff, info and rm — the verbs that take a project and a ref.",{"title":109,"path":110,"stem":111,"description":803,"icon":112,"children":-1},"Reference for setup, projects, doctor, config, completions, help and version — the verbs that take no project.",1784975261696]