{"id":21206735,"url":"https://github.com/jscutlery/nx-completion","last_synced_at":"2025-07-10T08:33:08.472Z","repository":{"id":37961874,"uuid":"349556338","full_name":"jscutlery/nx-completion","owner":"jscutlery","description":"Nx workspace completion plugin for Zsh.","archived":false,"fork":false,"pushed_at":"2023-12-15T11:54:26.000Z","size":117,"stargazers_count":124,"open_issues_count":7,"forks_count":14,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-04-16T16:22:39.639Z","etag":null,"topics":["nx","zsh","zsh-plugin"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jscutlery.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":["edbzn"]}},"created_at":"2021-03-19T21:11:46.000Z","updated_at":"2024-04-12T17:44:38.000Z","dependencies_parsed_at":"2023-01-25T11:15:34.432Z","dependency_job_id":"5c2691e1-f12d-47eb-8a95-1760f390493f","html_url":"https://github.com/jscutlery/nx-completion","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jscutlery%2Fnx-completion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jscutlery%2Fnx-completion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jscutlery%2Fnx-completion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jscutlery%2Fnx-completion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jscutlery","download_url":"https://codeload.github.com/jscutlery/nx-completion/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225629864,"owners_count":17499295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nx","zsh","zsh-plugin"],"created_at":"2024-11-20T20:56:42.154Z","updated_at":"2025-07-10T08:33:08.466Z","avatar_url":"https://github.com/jscutlery.png","language":"Shell","funding_links":["https://github.com/sponsors/edbzn"],"categories":["Completions"],"sub_categories":["ZSH on Windows"],"readme":"# Nx completion plugin for Zsh\n\n\u003e This plugin bring Nx autocompletion to Zsh.\n\n![demo](https://user-images.githubusercontent.com/8522558/111908149-67e8d780-8a58-11eb-9343-691f6d664163.gif)\n\n## Features\n\n- ✅ **Dynamic command \u0026 option parsing**\n  Automatically discovers and updates completions from `nx --help` output\n\n- 🚀 **Intelligent caching = blazing fast completions**\n  Leverages Nx’s project graph cache and memoized command parsing\n\n- 🧠 **Workspace-aware, always up-to-date**\n  Auto-syncs completions with your Nx version, project executors, and custom generators\n\n- 🧩 **Deep integration with Nx executors**\n  Extracts and completes custom workspace commands, targets, and options\n\n- ✨ **Smart autocompletion**\n  Supports arguments, flags, projects, targets, and generators—all in context\n\n- 📦 **Version flexibility**\n  Works seamlessly across different Nx workspace versions\n\n## Install\n\n### Prerequisit\n\nInstall [`jq`](https://stedolan.github.io/jq/) dependency:\n\n```shell\napt install jq\n```\n\nOn MacOS you can install with:\n\n```shell\nbrew install jq\n```\n\n\u003e **Note**: [`jq`](https://stedolan.github.io/jq/) is a lightweight command-line JSON processor used to manipulate the workspace graph.\n\n### As an [Oh My ZSH!](https://github.com/robbyrussell/oh-my-zsh) custom plugin\n\nClone the repository into the custom plugins directory:\n\n```shell\ngit clone git@github.com:jscutlery/nx-completion.git ~/.oh-my-zsh/custom/plugins/nx-completion\n```\n\nThen load it as a plugin in your `.zshrc`:\n\n```shell\nplugins+=(nx-completion)\n```\n\n### Manually\n\nClone this repository somewhere (`~/.nx-completion` for example):\n\n```shell\ngit clone git@github.com:jscutlery/nx-completion.git ~/.nx-completion\n```\n\nThen source it in your `.zshrc`:\n\n```shell\nsource ~/.nx-completion/nx-completion.plugin.zsh\n```\n\n## Cache Management\n\nWhen reinstalling or updating the nx-completion plugin, you may need to flush the zsh completion cache to ensure you're using the latest version.\n\n### Quick Cache Clear\n\nThe simplest way to clear the zsh completion cache:\n\n```shell\n# Clear zsh completion cache and rebuild\nrm -rf ~/.zcompdump* \u0026\u0026 autoload -U compinit \u0026\u0026 compinit -D\n```\n\n### Using the Clear Cache Script\n\nRun the included script for automated cache clearing:\n\n```shell\n# Make executable and run\nchmod +x clear-cache.zsh\n./clear-cache.zsh\n```\n\n## Testing\n\nThis repository includes a comprehensive test environment in the `test/` directory with simplified project structures for easy testing and development.\n\n### Test Environment Structure\n\n```\ntest/\n├── .nx/workspace-data/project-graph.json  # Main test graph (.nodes structure)\n├── nx.json                                # Nx workspace config\n├── project-graph-nested.json              # Test graph (.graph.nodes structure)\n├── test-completion.zsh                    # Automated test script\n├── test-cache.zsh                         # Cache performance test script\n├── PERFORMANCE-TESTING.md                 # Real-world performance testing guide\n└── README.md                              # Test environment docs\n```\n\n### Quick Testing\n\n```bash\n# Run automated tests\ncd test \u0026\u0026 ./test-completion.zsh\n\n# Test caching performance\ncd test \u0026\u0026 ./test-cache.zsh\n\n# Interactive completion testing\ncd test\nsource ../nx-completion.plugin.zsh\nnx \u003cTAB\u003e  # Test completions\n\n# Performance testing guide\ncd test \u0026\u0026 cat PERFORMANCE-TESTING.md\n```\n\nThe test environment includes 5 projects (frontend-app, backend-api, shared-utils, ui-components, data-access) with realistic Nx configurations and supports testing both JSON structure formats.\n\n## License\n\nThis project is MIT licensed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjscutlery%2Fnx-completion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjscutlery%2Fnx-completion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjscutlery%2Fnx-completion/lists"}