{"id":29195445,"url":"https://github.com/hongkongkiwi/vsix-cli","last_synced_at":"2026-04-21T16:31:44.279Z","repository":{"id":300379512,"uuid":"1005972799","full_name":"hongkongkiwi/vsix-cli","owner":"hongkongkiwi","description":"Script to download vsix files from any marketplace (and optionally install them)","archived":false,"fork":false,"pushed_at":"2025-06-21T15:01:59.000Z","size":450,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-28T19:05:00.110Z","etag":null,"topics":["bash","cursor","trae","vscode","vscodium","vsix","windsurf"],"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/hongkongkiwi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-21T07:45:29.000Z","updated_at":"2025-06-21T15:02:03.000Z","dependencies_parsed_at":"2025-06-21T11:38:47.843Z","dependency_job_id":null,"html_url":"https://github.com/hongkongkiwi/vsix-cli","commit_stats":null,"previous_names":["hongkongkiwi/vsix-cli"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/hongkongkiwi/vsix-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongkongkiwi%2Fvsix-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongkongkiwi%2Fvsix-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongkongkiwi%2Fvsix-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongkongkiwi%2Fvsix-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hongkongkiwi","download_url":"https://codeload.github.com/hongkongkiwi/vsix-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongkongkiwi%2Fvsix-cli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263077630,"owners_count":23410167,"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","cursor","trae","vscode","vscodium","vsix","windsurf"],"created_at":"2025-07-02T05:04:28.763Z","updated_at":"2026-04-21T16:31:39.241Z","avatar_url":"https://github.com/hongkongkiwi.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VSIX Command Line Tools\n\n[![GitHub](https://img.shields.io/badge/GitHub-hongkongkiwi%2Fvsix--cli-blue?logo=github)](https://github.com/hongkongkiwi/vsix-cli)\n[![Version](https://img.shields.io/badge/version-4.0.1-green)](#)\n[![License](https://img.shields.io/badge/license-MIT-blue)](#license)\n\nA powerful command-line tool for downloading and installing VS Code extensions (.vsix files) from multiple marketplaces. Supports batch operations, multiple editors, and various extension sources.\n\n## 🚀 Features\n\n- **Multi-Marketplace Support**: Download from VS Code Marketplace, Open VSX Registry, Coder Marketplace, and Eclipse Marketplace\n- **Multi-Editor Support**: Install to Cursor, Windsurf, Trae, VSCodium, VS Code, or all at once\n- **Flexible Input**: Accept extension IDs, marketplace URLs, or batch operations via stdin\n- **Version Control**: Download specific versions or latest releases\n- **Search \u0026 Info**: Search for extensions and get detailed information\n- **Configuration Management**: Persistent settings with `config` command\n- **Auto-Update**: Built-in script update functionality\n- **Cross-Platform**: Works on Linux, macOS, Windows (including WSL)\n- **Multiple Installation Methods**: Direct download, Git, Docker, or Homebrew\n- **Progress Indicators**: Visual feedback for downloads\n- **Dry Run Mode**: Preview operations without executing them\n\n## 📋 Table of Contents\n\n- [Installation](#installation)\n- [Quick Start](#quick-start)\n- [Commands](#commands)\n- [Examples](#examples)\n- [Supported Marketplaces](#supported-marketplaces)\n- [Supported Editors](#supported-editors)\n- [Configuration](#configuration)\n- [URL Formats](#url-formats)\n- [Advanced Usage](#advanced-usage)\n- [Contributing](#contributing)\n- [License](#license)\n\n## 🛠️ Installation\n\n### Direct Download\n\n```bash\n# Download the script\ncurl -O https://raw.githubusercontent.com/hongkongkiwi/vsix-cli/main/vsix-cli\n\n# Make it executable\nchmod +x vsix-cli\n\n# Move to a directory in your PATH (optional)\nsudo mv vsix-cli /usr/local/bin/\n```\n\n### Using Git\n\n```bash\ngit clone https://github.com/hongkongkiwi/vsix-cli.git\ncd vsix-cli\nchmod +x vsix-cli\n\n# Optionally add to PATH\nsudo ln -s \"$(pwd)/vsix-cli\" /usr/local/bin/vsix-cli\n```\n\n### Docker\n\n```bash\n# Pull the image\ndocker pull hongkongkiwi/vsix-cli:latest\n\n# Or from GitHub Container Registry\ndocker pull ghcr.io/hongkongkiwi/vsix-cli:latest\n\n# Run directly\ndocker run --rm hongkongkiwi/vsix-cli:latest --help\n\n# Download extensions to current directory\ndocker run --rm -v $(pwd):/output hongkongkiwi/vsix-cli:latest download ms-python.python\n\n# Search for extensions\ndocker run --rm hongkongkiwi/vsix-cli:latest search python\n```\n\n### Homebrew\n\n```bash\n# Add the tap and install\nbrew tap hongkongkiwi/vsix-cli\nbrew install vsix-cli\n\n# Or install directly without adding the tap\nbrew install hongkongkiwi/vsix-cli/vsix-cli\n```\n\n**Using the tap repository:**\nThe Homebrew formula is maintained in the [hongkongkiwi/homebrew-vsix-cli](https://github.com/hongkongkiwi/homebrew-vsix-cli) repository and is automatically updated with each release.\n\n**Update to latest version:**\n```bash\nbrew update\nbrew upgrade vsix-cli\n```\n\n**Uninstall:**\n```bash\nbrew uninstall vsix-cli\nbrew untap hongkongkiwi/vsix-cli  # Optional: remove the tap\n```\n\n### Dependencies\n\nThe script requires one of the following for downloads:\n- `curl` (recommended)\n- `wget`\n\nOptional dependencies for enhanced functionality:\n- `jq` - For JSON parsing and better extension info display\n- `git` - For auto-update functionality\n\n**Note:** When installing via Homebrew, all required dependencies (`bash`, `curl`, `jq`) are automatically installed.\n\n**Homebrew Formula Updates:** The formula is automatically updated when new releases are published, ensuring you always have access to the latest version through Homebrew.\n\n## ⚡ Quick Start\n\n```bash\n# Search for extensions\nvsix-cli search python\n\n# Download an extension\nvsix-cli download ms-python.python\n\n# Install to Cursor editor\nvsix-cli install --editors cursor ms-python.python\n\n# Install from marketplace URL\nvsix-cli install \"https://marketplace.visualstudio.com/items?itemName=ms-python.python\"\n\n# Install from Open VSX Registry\nvsix-cli install --marketplace openvsx ms-python.python\n```\n\n## 📖 Commands\n\n### `search \u003cterm\u003e`\nSearch for extensions matching the given term.\n\n```bash\nvsix-cli search \"python formatter\"\nvsix-cli search --limit 5 jupyter\n```\n\n### `info \u003cextension-id-or-url\u003e`\nShow detailed information about an extension.\n\n```bash\nvsix-cli info ms-python.python\nvsix-cli info --version 2021.5.842923320 ms-python.python\n```\n\n### `download \u003cext-id-or-url\u003e...`\nDownload extension(s) to local files.\n\n```bash\nvsix-cli download ms-python.python\nvsix-cli download --output ~/extensions/ ms-python.python github.copilot\nvsix-cli download --marketplace openvsx ms-python.python\n```\n\n### `install \u003cext-id-or-url\u003e...`\nDownload and install extension(s) to editor(s).\n\n```bash\nvsix-cli install ms-python.python\nvsix-cli install --editors cursor,vscode ms-python.python\nvsix-cli install --editors all github.copilot\n```\n\n### `config [get|set|reset]`\nManage configuration settings.\n\n```bash\nvsix-cli config get\nvsix-cli config set default_marketplace openvsx\nvsix-cli config set default_editors \"cursor,vscode\"\n```\n\n### `update`\nUpdate the script to the latest version.\n\n```bash\nvsix-cli update\nvsix-cli update --check  # Check for updates only\n```\n\n### `help [command]`\nShow help information.\n\n```bash\nvsix-cli help\nvsix-cli help download\n```\n\n## 🎯 Examples\n\n### Basic Operations\n\n```bash\n# Download Python extension\nvsix-cli download ms-python.python\n\n# Install GitHub Copilot to Cursor\nvsix-cli install --editors cursor github.copilot\n\n# Search for React extensions\nvsix-cli search react\n```\n\n### Version-Specific Downloads\n\n```bash\n# Download specific version\nvsix-cli download --version 2021.5.842923320 ms-python.python\n\n# Version in extension ID format\nvsix-cli download ms-python.python@2021.5.842923320\n```\n\n### Multi-Marketplace Usage\n\n```bash\n# From Open VSX Registry\nvsix-cli download --marketplace openvsx ms-python.python\n\n# From Coder Marketplace\nvsix-cli download --marketplace coder github.copilot\n\n# From marketplace URLs\nvsix-cli download \"https://open-vsx.org/extension/ms-python/python\"\n```\n\n### Batch Operations\n\n```bash\n# Multiple extensions at once\nvsix-cli install --editors cursor ms-python.python github.copilot prettier.prettier\n\n# From file\ncat extensions.txt | vsix-cli install --editors all\n\n# Pipe from echo\necho \"ms-python.python github.copilot\" | vsix-cli download\n```\n\n### Advanced Usage\n\n```bash\n# Dry run to preview actions\nvsix-cli install --dry-run --editors all ms-python.python\n\n# Quiet mode for scripts\nvsix-cli download --quiet --yes ms-python.python\n\n# Verbose output for debugging\nvsix-cli download --verbose ms-python.python\n\n# Disable colors for logging\nvsix-cli download --no-color ms-python.python\n```\n\n## 🏪 Supported Marketplaces\n\n| Marketplace | Identifier | Description | Status |\n|-------------|------------|-------------|---------|\n| **VS Code Marketplace** | `official` | Microsoft's official marketplace | ✅ Full Support |\n| **Open VSX Registry** | `openvsx` | Open-source alternative | ✅ Full Support |\n| **Coder Marketplace** | `coder` | For code-server environments | ✅ Full Support |\n| **Eclipse Marketplace** | `eclipse` | Eclipse Foundation marketplace | ⚠️ Experimental |\n\n## 💻 Supported Editors\n\n| Editor | Identifier | Description |\n|--------|------------|-------------|\n| **Cursor** | `cursor` | AI-first code editor |\n| **Windsurf** | `windsurf` | Codeium's editor |\n| **Trae** | `trae` | Lightweight editor |\n| **VSCodium** | `vscodium` | Open-source VS Code |\n| **VS Code** | `vscode` | Microsoft's editor |\n| **All** | `all` | Install to all detected editors |\n\n## ⚙️ Configuration\n\n### Configuration File\nSettings are stored in: `${XDG_CONFIG_HOME:-$HOME/.config}/vsix-cli/config`\n\n### Available Settings\n\n| Setting | Description | Default | Values |\n|---------|-------------|---------|---------|\n| `default_marketplace` | Default marketplace to use | `official` | `official`, `openvsx`, `coder`, `eclipse` |\n| `default_editors` | Default editors for install | `cursor` | Comma-separated editor list |\n| `show_progress` | Show progress indicators | `true` | `true`, `false` |\n| `auto_yes` | Auto-answer prompts | `false` | `true`, `false` |\n| `no_color` | Disable colored output | `false` | `true`, `false` |\n\n### Configuration Examples\n\n```bash\n# Set Open VSX as default marketplace\nvsix-cli config set default_marketplace openvsx\n\n# Set multiple default editors\nvsix-cli config set default_editors \"cursor,vscode,vscodium\"\n\n# Disable progress indicators\nvsix-cli config set show_progress false\n\n# View current configuration\nvsix-cli config get\n\n# Reset to defaults\nvsix-cli config reset\n```\n\n## 🔗 URL Formats\n\nThe tool supports various URL formats from different marketplaces:\n\n### VS Code Marketplace\n```\nhttps://marketplace.visualstudio.com/items?itemName=publisher.name\nhttps://marketplace.visualstudio.com/items/publisher.name\n```\n\n### Open VSX Registry\n```\nhttps://open-vsx.org/extension/publisher/name\n```\n\n### Coder Marketplace\n```\nhttps://extensions.coder.com/extension/publisher/name\n```\n\n### Eclipse Marketplace\n```\nhttps://marketplace.eclipse.org/content/extension-name\n```\n\n## 🔧 Advanced Usage\n\n### Environment Variables\n\n- `VSIX_CLI_UPDATE_URL` - Custom update URL\n- `VSIX_CLI_VERSION_URL` - Custom version check URL\n- `NO_COLOR` - Disable colors globally\n\n### Scripting Integration\n\n```bash\n#!/bin/bash\n# Install development extensions\nextensions=(\n    \"ms-python.python\"\n    \"github.copilot\"\n    \"prettier.prettier\"\n    \"esbenp.prettier-vscode\"\n)\n\nfor ext in \"${extensions[@]}\"; do\n    vsix-cli install --quiet --yes --editors cursor \"$ext\"\ndone\n```\n\n### CI/CD Usage\n\n```yaml\n# GitHub Actions example - Direct download\n- name: Install extensions\n  run: |\n    curl -O https://raw.githubusercontent.com/hongkongkiwi/vsix-cli/main/vsix-cli\n    chmod +x vsix-cli\n    ./vsix-cli install --quiet --yes --editors all ms-python.python\n\n# GitHub Actions example - Homebrew (macOS runners)\n- name: Install via Homebrew\n  run: |\n    brew tap hongkongkiwi/vsix-cli\n    brew install vsix-cli\n    vsix-cli install --quiet --yes --editors all ms-python.python\n\n# GitHub Actions example - Docker\n- name: Download extensions\n  run: |\n    docker run --rm -v ${{ github.workspace }}:/output \\\n      hongkongkiwi/vsix-cli:latest download ms-python.python github.copilot\n```\n\n### Docker Examples\n\n```bash\n# Download extensions with custom marketplace\ndocker run --rm -v $(pwd):/output \\\n  hongkongkiwi/vsix-cli:latest download --marketplace openvsx ms-python.python\n\n# Search with limit and save results\ndocker run --rm hongkongkiwi/vsix-cli:latest search --limit 5 python\n\n# Get extension info\ndocker run --rm hongkongkiwi/vsix-cli:latest info ms-python.python\n\n# Run with custom config (mount config directory)\ndocker run --rm -v $(pwd):/output -v ~/.config/vsix-cli:/home/vsix/.config/vsix-cli \\\n  hongkongkiwi/vsix-cli:latest download ms-python.python\n\n# Dry run to preview downloads\ndocker run --rm hongkongkiwi/vsix-cli:latest download --dry-run ms-python.python\n\n# Batch download from file\ncat extensions.txt | docker run --rm -i -v $(pwd):/output \\\n  hongkongkiwi/vsix-cli:latest download\n```\n\n## 🔄 Global Options\n\n| Option | Short | Description |\n|--------|-------|-------------|\n| `--quiet` | `-q` | Suppress non-error output |\n| `--verbose` | `-V` | Show detailed output |\n| `--yes` | `-y` | Auto-answer yes to prompts |\n| `--no-color` | `-c` | Disable colored output |\n| `--marketplace` | `-m` | Use specific marketplace |\n| `--help` | `-h` | Show help message |\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n### Repositories\n\n- **Main Project**: [hongkongkiwi/vsix-cli](https://github.com/hongkongkiwi/vsix-cli) - Main script and documentation\n- **Homebrew Formula**: [hongkongkiwi/homebrew-vsix-cli](https://github.com/hongkongkiwi/homebrew-vsix-cli) - Homebrew tap repository (auto-updated)\n\n### Development Setup\n\n```bash\ngit clone https://github.com/hongkongkiwi/vsix-cli.git\ncd vsix-cli\nchmod +x vsix-cli\n```\n\n### Testing\n\n```bash\n# Test basic functionality\n./vsix-cli --help\n./vsix-cli search test\n./vsix-cli info ms-python.python\n```\n\n## 📝 License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## 🐛 Issues and Support\n\nIf you encounter any issues or have questions:\n\n1. Check the [existing issues](https://github.com/hongkongkiwi/vsix-cli/issues)\n2. Create a new issue with detailed information\n3. Include your OS, shell, and the command that failed\n\n## 🎉 Acknowledgments\n\n- VS Code team for the marketplace API\n- Open VSX Registry for the open-source alternative\n- All contributors and users of this tool\n\n---\n\n**Made with ❤️ for the developer community**\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhongkongkiwi%2Fvsix-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhongkongkiwi%2Fvsix-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhongkongkiwi%2Fvsix-cli/lists"}