{"id":16985581,"url":"https://github.com/hendriknielaender/zvm","last_synced_at":"2025-03-17T09:30:31.522Z","repository":{"id":191269968,"uuid":"684302215","full_name":"hendriknielaender/zvm","owner":"hendriknielaender","description":"⚡ Fast and simple zig version manager (zvm)","archived":false,"fork":false,"pushed_at":"2025-03-14T16:51:14.000Z","size":2086,"stargazers_count":30,"open_issues_count":12,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-14T17:34:00.737Z","etag":null,"topics":["version","version-manager","zig","ziglang","zvm"],"latest_commit_sha":null,"homepage":"","language":"Zig","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/hendriknielaender.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","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":"2023-08-28T21:33:11.000Z","updated_at":"2025-03-14T16:51:18.000Z","dependencies_parsed_at":"2023-10-15T16:33:08.459Z","dependency_job_id":"fb95e987-58b4-4c8b-8548-097c783a3011","html_url":"https://github.com/hendriknielaender/zvm","commit_stats":null,"previous_names":["hendriknielaender/zvm"],"tags_count":41,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hendriknielaender%2Fzvm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hendriknielaender%2Fzvm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hendriknielaender%2Fzvm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hendriknielaender%2Fzvm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hendriknielaender","download_url":"https://codeload.github.com/hendriknielaender/zvm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243853683,"owners_count":20358461,"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":["version","version-manager","zig","ziglang","zvm"],"created_at":"2024-10-14T02:43:46.897Z","updated_at":"2025-03-17T09:30:31.516Z","avatar_url":"https://github.com/hendriknielaender.png","language":"Zig","funding_links":[],"categories":["Fundamentals"],"sub_categories":["Package and Version Manager"],"readme":"\u003ch1 align=\"center\"\u003e\n   \u003cimg src=\"logo.png\" width=\"40%\" height=\"40%\" alt=\"zvm logo\" title=\"zvm logo\"\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  ⚡ Zig Version Manager (\u003ccode\u003ezvm\u003c/code\u003e)\n\u003c/h1\u003e\n\u003cdiv align=\"center\"\u003e⚡ Fast and simple zig version manager\u003c/div\u003e\n\u003cbr\u003e\u003cbr\u003e\nzvm is a command-line tool that allows you to easily install, manage, and switch between multiple versions of Zig.\n\n## Features\n\n- List available Zig/zls versions (both remote and local).\n- Install specific Zig or zls versions.\n- Switch between installed Zig or zls versions.\n- Remove installed Zig or zls versions.\n- Display the current zvm version and helpful usage information.\n\n\n## Install\n\nTo install zvm with Homebrew, aka. `brew`, run the following commands:\n\n```bash\nbrew tap hendriknielaender/zvm\nbrew install zvm\n```\n\nNow add this line to your `~/.bashrc`, `~/.profile`, or `~/.zshrc` file.\n\n```bash\nexport PATH=\"$HOME/.zm/current/zig:$PATH\"\n```\n\n### Windows\n\n#### PowerShell\n\n```ps1\nirm https://raw.githubusercontent.com/hendriknielaender/zvm/master/install.ps1 | iex\n```\n\n#### Command Prompt\n\n```cmd\npowershell -c \"irm https://raw.githubusercontent.com/hendriknielaender/zvm/master/install.ps1 | iex\"\n```\n\n## Shell Completions\n\n`zvm` provides built-in shell completion scripts for both Zsh and Bash. This enhances the command-line experience by allowing tab-completion of subcommands, flags, etc.\n\n### Zsh\n\n **Generate** the Zsh completion script:\n   ```bash\n   zvm completions zsh \u003e _zvm\n   ```\n **Move** `_zvm` into a directory that Zsh checks for autoloaded completion scripts. For example:\n   ```bash\n   mkdir -p ~/.zsh/completions\n   mv _zvm ~/.zsh/completions\n   ```\n **Add** this to your `~/.zshrc`:\n   ```bash\n   fpath+=(~/.zsh/completions)\n   autoload -U compinit \u0026\u0026 compinit\n   ```\n **Reload** your shell:\n   ```bash\n   source ~/.zshrc\n   ```\n\n### Bash\n\n**Generate** the Bash completion script:\n   ```bash\n   zvm completions bash \u003e zvm.bash\n   ```\n**Source** it in your `~/.bashrc` (or `~/.bash_profile`):\n   ```bash\n   echo \"source $(pwd)/zvm.bash\" \u003e\u003e ~/.bashrc\n   source ~/.bashrc\n   ```\n\n## Usage\n\n**General Syntax:**\n```bash\nzvm \u003ccommand\u003e [arguments]\n```\n\n**Available Commands:**\n- `zvm ls` or `zvm list`  \n  Lists all available versions of Zig or zls remotely by default.  \n  Use `--system` to list only locally installed versions.\n  ```bash\n  zvm ls\n  zvm ls --system\n  zvm ls zls --system\n  ```\n\n- `zvm i` or `zvm install`  \n  Installs the specified version of Zig or zls.\n  ```bash\n  zvm install \u003cversion\u003e         # Installs Zig and zls for the specified version\n  zvm install zig \u003cversion\u003e     # Installs only Zig for the specified version\n  zvm install zls \u003cversion\u003e     # Installs only zls for the specified version\n  ```\n\n- `zvm use`  \n  Switches to using the specified installed version of Zig or zls.\n  ```bash\n  zvm use \u003cversion\u003e         # Use this version of Zig and zls if installed\n  zvm use zig \u003cversion\u003e     # Use this version of Zig only\n  zvm use zls \u003cversion\u003e     # Use this version of zls only\n  ```\n\n- `zvm remove`  \n  Removes the specified installed version of Zig or ZLS.\n  ```bash\n  zvm remove \u003cversion\u003e      # Removes this version of Zig and/or zls if installed\n  zvm remove zig \u003cversion\u003e  # Removes only the specified Zig version\n  zvm remove zls \u003cversion\u003e  # Removes only the specified zls version\n  ```\n- `zvm clean`\n  Remove old download artifacts.\n\n- `zvm --version`  \n  Displays the current version of zvm.\n\n- `zvm --help`  \n  Displays detailed usage information.\n\n**Examples:**\n```bash\n# List all available remote Zig versions\nzvm ls\n\n# List all installed local Zig versions\nzvm ls --system\n\n# List all installed local zls versions\nzvm ls zls --system\n\n# Install Zig version 0.12.0\nzvm install 0.12.0\n\n# Use Zig version 0.12.0\nzvm use zig 0.12.0\n\n# Remove Zig version 0.12.0\nzvm remove zig 0.12.0\n\n# Remove old download artifacts.\nzvm clean\n```\n\n### Compatibility Notes\nZig is in active development and the APIs can change frequently, making it challenging to support every dev build. This project currently aims to be compatible with stable, non-development builds to provide a consistent experience for the users.\n\n***Supported Version***: As of now, zvm is tested and supported on Zig version ***0.14.0***.\n\n### Contributing\nContributions, issues, and feature requests are welcome!\n\n### Clarification\nPlease note that our project is **not** affiliated with [ZVM](https://github.com/tristanisham/zvm) maintained by @tristanisham. Both projects operate independently, and any similarities are coincidental.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhendriknielaender%2Fzvm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhendriknielaender%2Fzvm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhendriknielaender%2Fzvm/lists"}