## Current Behavior Nx has no shell tab-completion. Users have to type full command, project, and target names from memory. ## Expected Behavior After installing the generated completion script, users get instant (~140ms) tab-completion for: - **Commands**: `nx ` - **Subcommands**: `nx show ` → `project`, `projects`, `target` - **Projects**: `nx show project ` shows all workspace projects - **`project:target` pairs**: `nx show target ` and `nx run ` first complete project names with a trailing `:`, then a second TAB lists that project's targets — no backspace + manual `:` needed - **Target names**: `nx run-many -t ` / `nx affected -t ` - **Infix target aliases**: `nx build ` shows workspace projects ### Installation ```sh nx completion bash >> ~/.bashrc nx completion zsh >> ~/.zshrc nx completion fish > ~/.config/fish/completions/nx.fish ``` Zsh also requires `autoload -U compinit && compinit` above the nx block; the generated script prints a friendly warning pointing to this if `compdef` isn't loaded. ### Implementation notes - **Pure JS, no native binary.** The earlier Rust prototype is dropped in favor of a ~100-line completion handler that reads `.nx/workspace-data/project-graph.json` directly. - **Bin-level short-circuit.** `bin/nx.ts` detects `--get-yargs-completions` before any Nx init (workspace-root detection, dotenv, daemon, native module, yargs command tree) and delegates to a standalone `fast-complete.ts` entry. This is required because `parserConfiguration({ 'strip-dashed': true })` defeats yargs' own completion detection, otherwise causing the `$0` infix handler to fire and build the full project graph (~3s cold, spawning ~25 plugin workers). - **Trailing-colon UX for `project:target`.** Project completions in `show target` / `run` contexts return `project:` (with colon). Bash and zsh scripts detect trailing colons and suppress the inserted space (`compopt -o nospace`, `compadd -S ''`). Fish left unchanged — no per-completion nospace primitive. - **Zsh compinit warning.** Silent failure on minimal `.zshrc` setups (e.g. stock macOS) replaced with a one-time message telling the user to add `autoload -U compinit && compinit`. End-to-end completion latency: **~140ms**. ## Related Issue(s) ## How to test locally 1. `pnpm nx build nx` 2. `pnpm link ./packages/nx` 3. `nx completion >> ` (see Installation above) 4. Open a new shell and tab away Verify: - `nx ` lists commands - `nx show target ` completes to `project:` (no trailing space) - second `` lists that project's targets - `nx run-many -t ` lists target names - `nx build ` lists projects - completion feels instant (~140ms)