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