{"id":19413101,"url":"https://github.com/joknarf/complete-ng","last_synced_at":"2026-05-28T00:01:41.322Z","repository":{"id":220645730,"uuid":"752184945","full_name":"joknarf/complete-ng","owner":"joknarf","description":"bash completion nextgen","archived":false,"fork":false,"pushed_at":"2024-04-16T17:36:44.000Z","size":24,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-07T15:43:00.634Z","etag":null,"topics":["bash","completion","interactive","menu","nextgen","plugin"],"latest_commit_sha":null,"homepage":"","language":null,"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/joknarf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"publiccode":null,"codemeta":null}},"created_at":"2024-02-03T09:27:25.000Z","updated_at":"2024-12-21T11:36:43.000Z","dependencies_parsed_at":"2024-04-16T06:31:17.225Z","dependency_job_id":"6eb762de-55dd-4021-ae0f-b684c5f45a12","html_url":"https://github.com/joknarf/complete-ng","commit_stats":null,"previous_names":["joknarf/complete-ng"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joknarf%2Fcomplete-ng","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joknarf%2Fcomplete-ng/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joknarf%2Fcomplete-ng/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joknarf%2Fcomplete-ng/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joknarf","download_url":"https://codeload.github.com/joknarf/complete-ng/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240593170,"owners_count":19825930,"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":["bash","completion","interactive","menu","nextgen","plugin"],"created_at":"2024-11-10T12:30:46.723Z","updated_at":"2026-05-02T12:06:25.557Z","avatar_url":"https://github.com/joknarf.png","language":null,"funding_links":[],"categories":["Completions"],"sub_categories":["ZSH on Windows"],"readme":"[![Joknarf Tools](https://img.shields.io/badge/Joknarf%20Tools-Visit-darkgreen?logo=github)](https://joknarf.github.io/joknarf-tools)\n[![bash](https://img.shields.io/badge/shell-bash%20|%20zsh%20-blue.svg)]()\n[![Licence](https://img.shields.io/badge/licence-MIT-blue.svg)](https://shields.io/)\n\n# complete-ng\nbash/zsh \u003ckbd\u003eTab\u003c/kbd\u003e completion nextgen with interactive/search menu and parameters description\n\n\u003cimg width=\"1584\" height=\"406\" alt=\"image\" src=\"https://github.com/user-attachments/assets/aa9a23b7-5cad-4862-b4d1-da9ad17ea8ef\" /\u003e\n\n\n## features\n\n* replace bash/zsh completion multiple choices output by interactive selector menu\n* display parameters help description \n* browse directories inside the menu\n* view/edit files directly from the menu\n* single \u003ckbd\u003eTab\u003c/kbd\u003e on command line displays choices\n* launch menu from empty command line with \u003ckbd\u003eTab\u003c/kbd\u003e to browse files/directories\n\n## pre-requisites\n\n* gnu awk (need brew install gawk on macOS)\n* gnu grep (need brew install grep on macOS)\n* bash-completion/zsh-completion\n\n## install\n\nYou can use a shell plugin manager like the famous [thefly](https://github.com/joknarf/thefly) (multi shell plugin/dotfiles manager and teleporter anywhere)\n```\nfly add joknarf/complete-ng\n```\nor just\n```\ngit clone https://github.com/joknarf/complete-ng\nsource complete-ng/complete-ng.plugin.\u003cyourshell\u003e\n```\n\nfor a complete next-gen shell experience, see also this project:\n\n* [joknarf/shell-ng](https://github.com/joknarf/shell-ng) : compilation of joknarf shell plugins which includes\n  * [joknarf/nerdp](https://github.com/joknarf/nerdp) : dynamic PS1 prompt (you can see it in the demo)\n  * [joknarf/complete-ng](https://github.com/joknarf/complete-ng) : Tab completion nextgen (this plugin)\n  * [joknarf/redo](https://github.com/joknarf/redo) : replacement of shell history command search (\u003ckbd\u003eCtrl\u003c/kbd\u003e\u003ckbd\u003eR\u003c/kbd\u003e or \u003ckbd\u003eEsc\u003c/kbd\u003e\u003ckbd\u003e/\u003c/kbd\u003e) with interactive menu\n  * [joknarf/seedee](https://github.com/joknarf/seedee) :  directory history navigation with arrows + interactive menu\n\n## demo\n\n![complete-ng](https://github.com/joknarf/complete-ng/assets/10117818/e8993060-4134-4ab5-8a1f-c2ea6d0d5696)\n\n![demo](https://github.com/joknarf/complete-ng/assets/10117818/44831cb1-ea69-4982-9852-e339a453e803)\n\n## file/folder icons\n\nAs depending to your terminal font, the icons may not render correctly, you can choose the icons you want using environment variables, here are some sample of dir/file icons, choose the ones fitting your terminal font (use nerd version of your font to have more choice):\n```\nSELECTOR_FOLDER_ICON='' # 🖿 🗀 📁 📂 🖿         \nSELECTOR_FILE_ICON=''   #  🗎            🗋 🖹  \n```\n\n## keys in menu\n\n|key                             | action                                                |\n|--------------------------------|-------------------------------------------------------|\n|\u003ckbd\u003e▼\u003c/kbd\u003e                    | select next item                                      | \n|\u003ckbd\u003e▲\u003c/kbd\u003e                    | select prev item                                      |\n|\u003ckbd\u003eEnd\u003c/kbd\u003e                  | select last item                                      |\n|\u003ckbd\u003eHome\u003c/kbd\u003e                 | select first item                                     | \n|\u003ckbd\u003e▶\u003c/kbd\u003e                    | browse selected directory                             |\n|\u003ckbd\u003e◀\u003c/kbd\u003e                    | browse parent directory                               |\n|\u003ckbd\u003eF3\u003c/kbd\u003e                   | view file using PAGER (or less)                       |\n|\u003ckbd\u003eF4\u003c/kbd\u003e                   | edit file usint EDITOR (or vi)                        |\n|\u003ckbd\u003eShift\u003c/kbd\u003e\u003ckbd\u003e▼\u003c/kbd\u003e/\u003ckbd\u003ePgUp\u003c/kbd\u003e/\u003ckbd\u003eCtl\u003c/kbd\u003e\u003ckbd\u003eF\u003c/kbd\u003e| next page      |\n|\u003ckbd\u003eShift\u003c/kbd\u003e\u003ckbd\u003e▲\u003c/kbd\u003e/\u003ckbd\u003ePgDn\u003c/kbd\u003e/\u003ckbd\u003eCtl\u003c/kbd\u003e\u003ckbd\u003eB\u003c/kbd\u003e| previous page  |\n|\u003ckbd\u003eEsc\u003c/kbd\u003e                  | exit                                                  |\n|\u003ckbd\u003eCtrl\u003c/kbd\u003e\u003ckbd\u003eA\u003c/kbd\u003e     | use all screen to display menu                        |\n|\u003ckbd\u003eEnter\u003c/kbd\u003e/\u003ckbd\u003eTab\u003c/kbd\u003e | put selected item on command line                     |\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoknarf%2Fcomplete-ng","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoknarf%2Fcomplete-ng","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoknarf%2Fcomplete-ng/lists"}