[{"data":1,"prerenderedAt":485},["ShallowReactive",2],{"navigation_en":3,"-docs-uxd-guides-shell-completions":150,"-docs-uxd-guides-shell-completions-surround":480},{"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":77,"body":152,"description":472,"extension":473,"links":474,"meta":475,"navigation":476,"path":78,"seo":477,"stem":79,"__hash__":479},"docs_docs\u002Fdocs\u002Fuxd\u002Fguides\u002F07.shell-completions.md",{"type":153,"value":154,"toc":467},"minimark",[155,163,168,257,260,295,299,343,354,414,418,421,435,443,446,452,463],[156,157,158,162],"p",{},[159,160,161],"code",{},"uxd completions \u003Cshell>"," prints a completion script to stdout. You install it\nby sourcing that output.",[164,165,167],"h2",{"id":166},"install","Install",[169,170,171,207,229],"code-group",{},[172,173,178],"pre",{"className":174,"code":175,"filename":176,"language":176,"meta":177,"style":177},"language-bash shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","# ~\u002F.bashrc\neval \"$(uxd completions bash)\"\n","bash","",[159,179,180,189],{"__ignoreMap":177},[181,182,185],"span",{"class":183,"line":184},"line",1,[181,186,188],{"class":187},"sq92B","# ~\u002F.bashrc\n",[181,190,192,196,200,204],{"class":183,"line":191},2,[181,193,195],{"class":194},"ssYy9","eval",[181,197,199],{"class":198},"semJd"," \"$(",[181,201,203],{"class":202},"szw1H","uxd",[181,205,206],{"class":198}," completions bash)\"\n",[172,208,211],{"className":174,"code":209,"filename":210,"language":176,"meta":177,"style":177},"# ~\u002F.zshrc\neval \"$(uxd completions zsh)\"\n","zsh",[159,212,213,218],{"__ignoreMap":177},[181,214,215],{"class":183,"line":184},[181,216,217],{"class":187},"# ~\u002F.zshrc\n",[181,219,220,222,224,226],{"class":183,"line":191},[181,221,195],{"class":194},[181,223,199],{"class":198},[181,225,203],{"class":202},[181,227,228],{"class":198}," completions zsh)\"\n",[172,230,233],{"className":174,"code":231,"filename":232,"language":176,"meta":177,"style":177},"# ~\u002F.config\u002Ffish\u002Fconfig.fish\nuxd completions fish | source\n","fish",[159,234,235,240],{"__ignoreMap":177},[181,236,237],{"class":183,"line":184},[181,238,239],{"class":187},"# ~\u002F.config\u002Ffish\u002Fconfig.fish\n",[181,241,242,244,247,250,254],{"class":183,"line":191},[181,243,203],{"class":202},[181,245,246],{"class":198}," completions",[181,248,249],{"class":198}," fish",[181,251,253],{"class":252},"sklAV"," |",[181,255,256],{"class":194}," source\n",[156,258,259],{},"Open a new shell, or re-source the file, and completion is live.",[261,262,264,272,292],"tip",{"title":263},"Prefer a file over eval",[156,265,266,268,269,271],{},[159,267,195],{}," runs ",[159,270,203],{}," on every shell start. If startup time matters, write the\nscript to disk once instead:",[172,273,275],{"className":174,"code":274,"language":176,"meta":177,"style":177},"uxd completions zsh > ~\u002F.zsh\u002Fcompletions\u002F_uxd\n",[159,276,277],{"__ignoreMap":177},[181,278,279,281,283,286,289],{"class":183,"line":184},[181,280,203],{"class":202},[181,282,246],{"class":198},[181,284,285],{"class":198}," zsh",[181,287,288],{"class":252}," >",[181,290,291],{"class":198}," ~\u002F.zsh\u002Fcompletions\u002F_uxd\n",[156,293,294],{},"Regenerate it after adding a project.",[164,296,298],{"id":297},"what-gets-completed","What gets completed",[300,301,302,315],"table",{},[303,304,305],"thead",{},[306,307,308,312],"tr",{},[309,310,311],"th",{},"Position",[309,313,314],{},"Completes",[316,317,318,327,335],"tbody",{},[306,319,320,324],{},[321,322,323],"td",{},"First argument",[321,325,326],{},"Top-level verbs and your project names",[306,328,329,332],{},[321,330,331],{},"After a project",[321,333,334],{},"Workspace verbs and the slugs that already exist",[306,336,337,340],{},[321,338,339],{},"Anywhere else",[321,341,342],{},"Workspace verbs",[156,344,345,346,349,350,353],{},"The project list is baked into the script when it is generated, which is why a\nnew project in ",[159,347,348],{},"~\u002F.uxd\u002F"," needs a regenerate. Workspace slugs are looked up live\n— the script calls ",[159,351,352],{},"uxd \u003Cproject> list --json"," while you type.",[156,355,356,357,360,361,360,364,360,367,370,371,360,374,360,377,380,381,360,384,370,387,360,390,360,392,360,395,360,398,360,401,360,404,360,407,360,410,413],{},"The top-level verbs it offers are ",[159,358,359],{},"setup",", ",[159,362,363],{},"projects",[159,365,366],{},"doctor",[159,368,369],{},"config",",\n",[159,372,373],{},"completions",[159,375,376],{},"help",[159,378,379],{},"version","; the workspace verbs are ",[159,382,383],{},"list",[159,385,386],{},"clean",[159,388,389],{},"checkout",[159,391,159],{},[159,393,394],{},"run",[159,396,397],{},"exec",[159,399,400],{},"shell",[159,402,403],{},"sync",[159,405,406],{},"diff",[159,408,409],{},"info",[159,411,412],{},"rm",".",[164,415,417],{"id":416},"errors","Errors",[156,419,420],{},"Only three shells are supported. Anything else is a usage error:",[172,422,424],{"className":174,"code":423,"language":176,"meta":177,"style":177},"uxd completions ksh\n",[159,425,426],{"__ignoreMap":177},[181,427,428,430,432],{"class":183,"line":184},[181,429,203],{"class":202},[181,431,246],{"class":198},[181,433,434],{"class":198}," ksh\n",[172,436,441],{"className":437,"code":439,"language":440},[438],"language-text","error(E_USAGE): unsupported shell 'ksh'\nhint: one of: bash, zsh, fish\n","text",[159,442,439],{"__ignoreMap":177},[156,444,445],{},"Omitting the shell fails the same way:",[172,447,450],{"className":448,"code":449,"language":440},[438],"error(E_USAGE): completions requires a shell\nhint: one of: bash, zsh, fish\n",[159,451,449],{"__ignoreMap":177},[156,453,454,455,458,459,413],{},"Both exit ",[159,456,457],{},"2",". See ",[460,461,462],"a",{"href":118},"Exit codes",[464,465,466],"style",{},"html pre.shiki code .sq92B, html code.shiki .sq92B{--shiki-light:#66707B;--shiki-default:#66707B;--shiki-dark:#BDC4CC}html pre.shiki code .ssYy9, html code.shiki .ssYy9{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#91CBFF}html pre.shiki code .semJd, html code.shiki .semJd{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#ADDCFF}html pre.shiki code .szw1H, html code.shiki .szw1H{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFB757}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 .sklAV, html code.shiki .sklAV{--shiki-light:#A0111F;--shiki-default:#A0111F;--shiki-dark:#FF9492}",{"title":177,"searchDepth":191,"depth":191,"links":468},[469,470,471],{"id":166,"depth":191,"text":167},{"id":297,"depth":191,"text":298},{"id":416,"depth":191,"text":417},"Generate and install tab completion for bash, zsh, or fish, so uxd completes your project names, verbs, and existing workspace slugs.","md",null,{},{"icon":80},{"title":77,"description":478},"Install uxd tab completion for bash, zsh, and fish with uxd completions \u003Cshell> — including what gets completed and how to reload after config changes.","KmF55L1SZFn9l1eSepYUX4fOJJlDBcoZCGK-wmjkJMM",[481,483],{"title":72,"path":73,"stem":74,"description":482,"icon":75,"children":-1},"Use uxd from shell scripts and CI — the stdout\u002Fstderr contract, --json output shapes, and exit codes you can branch on.",{"title":82,"path":83,"stem":84,"description":484,"icon":85,"children":-1},"The errors uxd actually prints, what each one means, and the shortest fix — starting with uxd doctor.",1789131075547]