{"id":16981225,"url":"https://github.com/mordechaihadad/bob","last_synced_at":"2025-05-13T18:14:38.910Z","repository":{"id":36950144,"uuid":"456199616","full_name":"MordechaiHadad/bob","owner":"MordechaiHadad","description":"A version manager for neovim","archived":false,"fork":false,"pushed_at":"2025-05-05T08:55:34.000Z","size":1986,"stargazers_count":1617,"open_issues_count":3,"forks_count":42,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-05-12T01:36:45.939Z","etag":null,"topics":["command-line","hacktoberfest","neovim","neovim-version-manager","rust","tool","version-manager"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/MordechaiHadad.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,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"polar":"MordechaiHadad","github":["MordechaiHadad"]}},"created_at":"2022-02-06T16:05:09.000Z","updated_at":"2025-05-11T23:25:29.000Z","dependencies_parsed_at":"2023-01-17T07:31:37.007Z","dependency_job_id":"d2822b28-aafa-4eb5-b943-569415acd927","html_url":"https://github.com/MordechaiHadad/bob","commit_stats":{"total_commits":612,"total_committers":32,"mean_commits":19.125,"dds":0.1797385620915033,"last_synced_commit":"0b05a89b7789b5ff18bd19d0d40ccb0e4fe1715b"},"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MordechaiHadad%2Fbob","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MordechaiHadad%2Fbob/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MordechaiHadad%2Fbob/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MordechaiHadad%2Fbob/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MordechaiHadad","download_url":"https://codeload.github.com/MordechaiHadad/bob/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254000885,"owners_count":21997443,"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":["command-line","hacktoberfest","neovim","neovim-version-manager","rust","tool","version-manager"],"created_at":"2024-10-14T02:04:53.276Z","updated_at":"2025-05-13T18:14:38.898Z","avatar_url":"https://github.com/MordechaiHadad.png","language":"Rust","funding_links":["https://polar.sh/MordechaiHadad","https://github.com/sponsors/MordechaiHadad"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"resources/bob.png\" width=315\u003e\n\n\u003c/div\u003e\n\n# Bob\n\n\u003e Struggle to keep your Neovim versions in check? Bob provides an easy way to install and switch versions on any system!\n\nBob is a cross-platform and easy-to-use Neovim version manager, allowing for easy switching between versions right from the command line.\n\n## 🌟 Showcase\n\n\u003cimg src=\"./resources/tapes/demo.gif\"\u003e\n\n## 🔔 Notices\n\n- **2022-10-29**: Moved bob's symbolic link and downloads folder on macos from `/Users/user/Library/Application Support` to `~/.local/share` please make sure to move all of your downloads to the new folder, run `bob use \u003cyour desired version\u003e` and update your PATH\n- **2023-02-13**: Bob has recently switched to using a proxy executable for running Neovim executables. To switch from the old method that Bob used, follow these steps:\n\n    1. Remove the current Neovim path from your global $PATH environment variable.\n    2. Delete the following directory:\n        On Unix: `~/.local/share/neovim`\n        On Windows: `C:\\Users\\\u003cusername\u003e\\AppData\\Local\\neovim`\n\n    Secondly the name of the downloads directory property in the configuration file has changed. Please refer to the updated list of properties for the new name.\n- **2024-03-04**: Due to Neovim's recent MacOS binary changes, bob now supports arm completely, but unfortunately, it comes with some breaking changes specifically for bob's proxy executable. To fix that, follow these steps (which will not be necessary soon):\n\n  1. Remove `nvim` binary from `nvim-bin` which is located in the same directory the same as the neovim binaries downloads folder.\n  2. Copy your newly downloaded bob binary and put the copy inside of `nvim-bin`\n  3. Rename your bob binary inside `nvim-bin` to `nvim`.\n\n- **2024-05-17**: Support for `nvim-qt` is now deprecated as Neovim no longer supports it in newer releases. If you're currently using `nvim-qt`, we recommend switching to a different Neovim GUI or using Neovim in the terminal. Please refer to the Neovim documentation for more information on supported GUIs.\n- **2024-05-19**: Important notice for users who built Neovim from source using a commit hash before the newest Bob version: Due to recent changes in Bob, these versions will need to be rebuilt. Alternatively, you can manually add a file named `full-hash.txt` at the root of the directory. This file should contain the full hash of the commit used to build Neovim. This change ensures better tracking and management of versions built from source. We apologize for any inconvenience and appreciate your understanding.\n\n## 📦 Requirements\n\nMake sure you don't have Neovim already installed via other ways e.g. a package manager.\n\n#### Building bob\n\nMake sure [rustup](https://www.rust-lang.org/tools/install) is installed.\n\n(Optional) `openssl` if built with `native-tls` feature.\n\n#### Building Neovim\n\nFor further information refer to the [Neovim wiki](https://github.com/neovim/neovim/wiki/Building-Neovim#build-prerequisites).\n\n\u003cdetails\u003e\n\u003csummary\u003eAll platforms\u003c/summary\u003e\n\n- CMake\n- Git\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eWindows\u003c/summary\u003e\n\n- [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) with C++ extension pack\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eUnix\u003c/summary\u003e\n\n- Clang or GCC\n\n**MacOS note**: [follow these instructions](https://github.com/neovim/neovim/wiki/Building-Neovim#macos--homebrew)\n\n\u003c/details\u003e\n\n## 🔧 Installation\n\n### Install from releases\n\n1. Download the bob release suitable for your platform: either `bob-{platform}-x86_64.zip` for the standard version or `bob-{platform}-x86_64-openssl.zip` for the OpenSSL version.\n2. Unzip it\n3. Run it with `bob`\n\n### Install with pacman\n\n1. On Arch Linux, you can install `bob` from the [extra repository](https://archlinux.org/packages/extra/x86_64/bob/) using pacman: `pacman -S bob`\n2. Run it with `bob`\n\n### Install from source\n\nFor the standard version:\n\n1. `cargo install --git https://github.com/MordechaiHadad/bob.git`\n2. Run Bob with `bob`\n\nFor the OpenSSL version:\n\n1. To install, include the `--no-default-features --features native-tls` flags with your command:  `cargo install --git https://github.com/MordechaiHadad/bob.git --no-default-features --features native-tls`\n2. Run Bob with `bob`\n\n### Install from crates.io\n\n1. `cargo install bob-nvim`\n2. Run bob with `bob`\n\n## ❓ Usage\n\nA version-string can either be `vx.x.x` or `x.x.x` examples: `v0.6.1` and `0.6.0`\n\n---\n\n- `bob use |nightly|stable|latest|\u003cversion-string\u003e|\u003ccommit-hash\u003e|`\n\n`--no-install` flag will prevent bob from auto invoking install command when using `use`\n\nSwitch to the specified version, by default will auto-invoke install command if the version is not installed already\n\n---\n\n- `bob run |nightly|stable|latest|\u003cversion-string\u003e|\u003ccommit-hash\u003e| [args...]`\n\nRun a specific installed Neovim version with the provided arguments. `[args...]` are passed directly to the Neovim instance.\n\nExample: `bob run nightly --clean my_file.txt`\n\n---\n\n- `bob install |nightly|stable|latest|\u003cversion-string\u003e|\u003ccommit-hash\u003e|`\n\nInstall the specified version, can also be used to update out-of-date nightly version.\n\n---\n\n- `bob sync`\n\nIf Config::version_sync_file_location is set, the version in that file will be parsed and installed.\n\n---\n\n- `bob uninstall [|nightly|stable|latest|\u003cversion-string\u003e|\u003ccommit-hash\u003e|]`\n\nUninstall the specified version. If no version is specified a prompt is used to select all the versions\nto be uninstalled.\n\n---\n\n- `bob rollback`\n\nRollback to an existing nightly rollback\n\n---\n\n- `bob erase`\n\nErase any change bob ever made including Neovim installation, Neovim version downloads and registry changes.\n\n---\n\n- `bob list`\n\nList all installed and used versions.\n\n---\n\n- `bob complete bash|elvish|fish|powershell|zsh`\n\nGenerate shell completion.\n\n---\n\n- `bob update |nightly|stable|--all|`\n\nUpdate existing version, can specify either a version or the flag `--all`\n\n---\n\n- `bob list-remote`\n\nList all remote neovim versions available for download.\n\n---\n\n## ⚙ Configuration\n\nThis section is a bit more advanced and thus the user will have to do the work himself since bob doesn't do that.\n\nBob's configuration file can be written in either JSON or TOML format. The file should be located at `config_dir/bob/config.json` or `config_dir/bob/config.toml` respectively. However, the location of the configuration file can be customized as explained [below](#config-location), to be more specific:\n\n\u003cdetails\u003e\n\u003csummary\u003eOn Linux\u003c/summary\u003e\n\n`/home/user/.config/bob/config.json|toml`\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eOn Windows\u003c/summary\u003e\n\n`C:\\Users\\user\\AppData\\Roaming\\bob\\config.json|toml`\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eOn MacOS\u003c/summary\u003e\n\n`/Users/user/Library/Application Support/bob/config.json|toml`\n\n\u003c/details\u003e\n\n### Increasing Github rate-limit\n\nIt is possible to use `GITHUB_TOKEN` to prevent rate-limit for API calls. There are two ways to do it:\n\n- You can prepend any of the `bob` commands with `GITHUB_TOKEN=\u003cyour token\u003e`\n```console\nGITHUB_TOKEN=\u003csome token\u003e bob update -a\n```\n- perform `export GITHUB_TOKEN=\u003cyour token\u003e` and then run `bob` commands.\n```console\nexport GITHUB_TOKEN=\u003csome token\u003e\nbob update -a\n```\n\n### \u003ca name=\"config-location\"\u003e\u003c/a\u003eCustom Location\n\nBob's config file location can be configured by using an environment variable called `$BOB_CONFIG`.\nExample: `export BOB_CONFIG=/path/to/config/config.json|toml`\n\n### Syntax\n\n| Property                       | Description                                                                                                                                                    | Default Value                                                                                                 |\n| -------------------------------| ---------------------------------------------------------------------------------------------------------------------------------------------------------------| --------------------------------------------------------------------------------------------------------------|\n| **enable_nightly_info**        | Will show new commits associated with new nightly release if enabled                                                                                           | `true`                                                                                                        |\n| **enable_release_build**       | Compile neovim nightly or a certain hash version as a release build (slightly improved performance, no debug info)                                        | `false`                                                                                                       |\n| **downloads_location**         | The folder in which neovim versions will be downloaded to, bob will error if this option is specified but the folder doesn't exist                             | unix: `/home/\u003cusername\u003e/.local/share/bob`, windows: `C:\\Users\\\u003cusername\u003e\\AppData\\Local\\bob`                   |\n| **installation_location**      | The path in which the proxied neovim installation will be located in                                                                                           | unix: `/home/\u003cusername\u003e/.local/share/bob/nvim-bin`, windows: `C:\\Users\\\u003cusername\u003e\\AppData\\Local\\bob\\nvim-bin` |\n| **version_sync_file_location** | The path to a file that will hold the neovim version string, useful for config version tracking, bob will error if the specified file is not a valid file path | `Disabled by default`                                                                                         |\n| **rollback_limit**             | The amount of rollbacks before bob starts to delete older ones, can be up to 255                                                                               | `3`                                                                                                           |\n| **github_mirror**              | Specify the github mirror to use instead of `https://github.com`, example: `https://mirror.ghproxy.com`                                                                                 | `Disabled by default`                                                                                         |\n\n### Example \n\n```jsonc\n// /home/user/.config/bob/config.json\n{\n  \"enable_nightly_info\": true, // Will show new commits associated with new nightly release if enabled\n  \"enable_release_build\": false, // Compile neovim nightly or a certain hash version as a release build (slightly improved performance, no debug info)\n  \"downloads_location\": \"$HOME/.local/share/bob\", // The folder in which neovim versions will be installed too, bob will error if this option is specified but the folder doesn't exist\n  \"installation_location\": \"/home/user/.local/share/bob/nvim-bin\", // The path in which the used neovim version will be located in\n  \"version_sync_file_location\": \"/home/user/.config/nvim/nvim.version\", // The path to a file that will hold the neovim version string, useful for config version tracking, bob will error if the specified file is not a valid file path\n  \"rollback_limit\": 3, // The amount of rollbacks before bob starts to delete older ones, can be up to 225\n  \"github_mirror\": \"https://github.com\" // github or github mirror\n}\n\n```\n\n## 💻 Shell Completion\n\n- Bash\n\nCompletion files are commonly stored in `/etc/bash_completion.d/` for system-wide commands, but can be stored in `~/.local/share/bash-completion/completions` for user-specific commands. Run the command:\n\n```bash\nmkdir -p ~/.local/share/bash-completion/completions\nbob complete bash \u003e\u003e ~/.local/share/bash-completion/completions/bob\n```\n\nThis installs the completion script. You may have to log out and log back in to your shell session for the changes to take effect.\n\n- Bash (macOS/Homebrew)\n\nHomebrew stores bash completion files within the Homebrew directory. With the `bash-completion` brew formula installed, run the command:\n\n```bash\nmkdir -p $(brew --prefix)/etc/bash_completion.d\nbob complete bash \u003e $(brew --prefix)/etc/bash_completion.d/bob.bash-completion\n```\n\n- Fish\n\nFish completion files are commonly stored in `$HOME/.config/fish/completions`. Run the command:\n\n```fish\nmkdir -p ~/.config/fish/completions\nbob complete fish \u003e ~/.config/fish/completions/bob.fish\n```\n\nThis installs the completion script. You may have to log out and log back in to your shell session for the changes to take effect.\n\n- Zsh\n\nZsh completions are commonly stored in any directory listed in your `$fpath` variable. To use these completions, you must either add the generated script to one of those directories, or add your own to this list.\n\nAdding a custom directory is often the safest bet if you are unsure of which directory to use. First create the directory; for this example we'll create a hidden directory inside our `$HOME` directory:\n\n```zsh\nmkdir ~/.zfunc\n```\n\nThen add the following lines to your `.zshrc` just before `compinit`:\n\n```zsh\nfpath+=~/.zfunc\n```\n\nNow you can install the completions script using the following command:\n\n```zsh\nbob complete zsh \u003e ~/.zfunc/_bob\n```\n\nYou must then either log out and log back in, or simply run\n\n```zsh\nexec zsh\n```\n\nfor the new completions to take effect.\n\n- PowerShell\n\nThe PowerShell completion scripts require PowerShell v5.0+ (which comes with Windows 10, but can be downloaded separately for windows 7 or 8.1).\n\nFirst, check if a profile has already been set\n\n```powershell\nTest-Path $profile\n```\n\nIf the above command returns `False` run the following\n\n```powershell\nNew-Item -path $profile -type file -force\n```\n\nNow open the file provided by `$profile` (if you used the `New-Item` command it will be `${env:USERPROFILE}\\Documents\\WindowsPowerShell\\Microsoft.PowerShell_profile.ps1`\n\nNext, we either save the completions file into our profile, or into a separate file and source it inside our profile. To save the completions into our profile simply use\n\n```powershell\nbob complete powershell \u003e\u003e ${env:USERPROFILE}\\Documents\\WindowsPowerShell\\Microsoft.PowerShell_profile.ps1\n```\n\n## 🛠️ Troubleshooting\n\n`sudo: nvim: command not found`\nThis error can be caused when `secure_path` is enabled in `/etc/sudoers` like in distros such as Fedora and Ubuntu. Possible workarounds:\n\n1. Set `$VISUAL` to location of bob nvim binary and use `sudoedit` instead of `sudo nvim` when running bob as sudo\n2. Run `sudo env \"PATH=$PATH\" nvim`\n3. Set `$SUDO_USER` to location of bob nvim binary: `SUDO_EDITOR='/home/user/.local/share/bob/nvim-bin/nvim`\n\nThese workarounds were devised by @nfejzic and @s11s11, thanks to them.\n\n## :heart: Credits And Inspiration\n\n- [nvm](https://github.com/nvm-sh/nvm) A node version manager\n- [nvenv](https://github.com/NTBBloodbath/nvenv) A Neovim version manager written by NTBBloodbath\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmordechaihadad%2Fbob","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmordechaihadad%2Fbob","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmordechaihadad%2Fbob/lists"}