{"id":20294195,"url":"https://github.com/teambit/bvm","last_synced_at":"2025-10-18T01:31:15.085Z","repository":{"id":37832344,"uuid":"341507256","full_name":"teambit/bvm","owner":"teambit","description":"Bit version manager","archived":false,"fork":false,"pushed_at":"2025-04-15T15:33:05.000Z","size":666,"stargazers_count":44,"open_issues_count":23,"forks_count":13,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-05-09T06:01:52.341Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/teambit.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,"zenodo":null}},"created_at":"2021-02-23T09:57:41.000Z","updated_at":"2025-02-27T21:28:51.000Z","dependencies_parsed_at":"2023-01-30T22:46:53.607Z","dependency_job_id":"c39beebd-73f1-4fe5-8ac5-f80440777fea","html_url":"https://github.com/teambit/bvm","commit_stats":{"total_commits":260,"total_committers":9,"mean_commits":28.88888888888889,"dds":"0.17307692307692313","last_synced_commit":"89bac6aea83617250aba350f457afa032c3df682"},"previous_names":[],"tags_count":63,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teambit%2Fbvm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teambit%2Fbvm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teambit%2Fbvm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teambit%2Fbvm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teambit","download_url":"https://codeload.github.com/teambit/bvm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254005504,"owners_count":21998268,"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":[],"created_at":"2024-11-14T15:28:11.729Z","updated_at":"2025-10-18T01:31:15.007Z","avatar_url":"https://github.com/teambit.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n[BVM](https://github.com/teambit/bvm) is a version manager for [Bit](https://bit.dev).  \nUsing BVM makes it easier to install and manage multiple versions of Bit in a single environment.\n\n### Features\n\n- __Consistent installation:__ All Bit dependencies are bundled together to ensure a consistent and predictable package installation that is not affected by SemVer rules.\n- __Fast installation:__ A simple and quick installation process that requires no additional time-consuming operations (post-install scripts, etc.)\n- __Friendly UX:__ Easy upgrades and version management\n- __Multiple Bit versions:__ Easily switch between Bit versions or even use multiple versions in parallel\n\n### Install BVM\n\n#### Install with NPM\n```shell\nnpm i -g @teambit/bvm\n```\n\n#### Install with pnpm\n```shell\npnpm add -g @teambit/bvm\n```\n\n#### Install with Yarn\n```shell\nyarn global add @teambit/bvm\n```\n\n### Install Bit\n#### Install Bit's latest version\n```shell\nbvm install\n```\n\n#### Install A specific Bit version\n```shell\nbvm install \u003cbit-version\u003e\n```\n#### Upgrade to Bit's latest version\nInstall the latest version and remove the version previously used.\n```shell\nbvm upgrade\n```\n\n### Manage versions\n\n#### Get the current version of BVM\n```shell\nbvm -v\n```\n\n#### List all versions of Bit available to be installed\n```shell\nbvm list --remote\n```\n\n#### Switch to another bit version\nSwitch the currently used bit version\n```shell\nbvm use \u003cbit-version\u003e\n```\n\n#### Get the local and remote versions of Bit and BVM\nGet the local used versions, local latest versions and remote latest versions of Bit and BVM\n```shell\nbvm version\n```\n\n#### List all installed Bit versions\n```shell\nbvm list\n```\n\n#### Remove an installed Bit version\n```shell\nbvm remove \u003cbit-version\u003e\n```\n\n#### Link to a specific Bit version\nLink a command name to a Bit version (link to binaries in the `PATH` variable).\n\n```shell\nbvm link \u003ccommand\u003e \u003cbit-version\u003e\n```\n\nFor example, the following line will link Bit's version `0.0.315` to the `bitty` command name\n(this will execute Bit's version `0.0.315` whenever the `bitty` command is used).\n```\nbvm link bitty 0.0.315\n```\nValidate the link by checking the version number of the new link:\n```shell\n$ bitty -v\n\n0.0.315 (@teambit/legacy: 1.0.28)\n```\n\n:::info Auto-Link Bit's latest version to `bbit`\nIf a legacy version of Bit (Bit v14) is installed on your machine,\nBVM will automatically link the latest version to `bbit` (instead of `bit`) to allow you to use both versions in parallel.\n:::\n\n### BVM configurations\n\n#### Change BVM dir via environment variable\n\nMake sure to set an env variable named `BVM_GLOBALS_DIR`.\nBvm will create its config in this folder, and will set the `BVM_DIR` inside the config to this folder as well. \n#### Get BVM configurations\n\n- `DEFAULT_LINK` -  The default command name to be linked to BVM's latest version.  \n`bit` is linked by default unless a legacy version of Bit is installed. In that case, `bbit` will be linked, instead.\n\n- `BVM_DIR` -  The location for BVM (this will no apply for the config of bvm itself, as it's configured inside the config)\nIn order to change the entire folder include config, use the `BVM_GLOBALS_DIR` env variable described above.\n\n```shell\nbvm config\n```\n\n#### Set BVM configurations\n\n```shell\nbvm config set \u003cproperty\u003e \u003cnew-value\u003e\n```\n\nFor example, to change the default link for Bit, from  `bit` to `bitty`:\n\n```shell\nbvm config set DEFAULT_LINK bitty\n```\n\n\n\n### Troubleshooting\n\n#### The PATH env variable is missing BVM's installation directory\n\n##### MacOS / Linux\n\nThe error message:\n\n```\nglobal Bit install location was not found in your PATH global variable.\nplease add the following command to your bash/zsh profile then re-open the terminal:\nexport PATH=$HOME/bin:$PATH\n```\n\n**Solution:**\n\n###### Bash\n\nRun the following command:\n\n```shell\necho 'export PATH=$HOME/bin:$PATH' \u003e\u003e ~/.bashrc \u0026\u0026 source ~/.bashrc\n```\n\n###### ZSH (Z Shell)\n\nRun the following command:\n\n```shell\necho 'export PATH=$HOME/bin:$PATH' \u003e\u003e ~/.zshrc \u0026\u0026 source ~/.zshrc\n```\n\n##### Windows\n\nThe error message:\n\n```\nglobal Bit install location was not found in your PATH global variable.\nplease run the following command and then re-open the terminal:\nsetx path \"%path%;C:\\Users\\USER\\AppData\\Local\\.bvm\" and re-open your terminal\n```\n\n**Solution:**\n\nRun the following command:\n\n```shell\nsetx path \"%path%;%LocalAppData%\\.bvm\"\n```\n\nIf you're running VSCODE - restart it (learn why [here](https://github.com/microsoft/vscode/issues/47816)).\n\n## License 💮\n\nApache License, Version 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteambit%2Fbvm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteambit%2Fbvm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteambit%2Fbvm/lists"}