Skip to content

Conversation

@ammar-agent
Copy link
Collaborator

Generated with cmux

Overview

Establishes complete infrastructure for publishing the cmux VS Code extension to the official VS Code Marketplace.

What's Included

Documentation

  • MARKETPLACE_RELEASE.md: Comprehensive publishing guide covering Azure DevOps setup, PAT management, publishing procedures, troubleshooting, and maintenance
  • RELEASE_CHECKLIST.md: Quick reference for release workflow
  • README.md: Updated with marketplace installation as primary method

Automation

  • GitHub Actions workflow (.github/workflows/publish-vscode-extension.yml)
    • Triggers on tags matching vscode-v*
    • Builds, packages, and publishes to marketplace
    • Creates GitHub release with .vsix attached
    • Requires VSCE_PAT repository secret

Verification

  • verify-marketplace-setup.sh: Pre-publish verification script

Release Process

One-Time Setup (Required)

  1. Create Azure DevOps account
  2. Generate PAT with Marketplace: Acquire + Publish scopes
  3. Add VSCE_PAT to GitHub repository secrets
  4. Verify/create "coder" publisher: npx @vscode/vsce login coder

Publishing (Automated)

git tag vscode-v0.1.0
git push origin vscode-v0.1.0

GitHub Actions handles the rest:

  • Builds extension
  • Publishes to marketplace
  • Creates GitHub release

Future Releases

cd vscode
npm version patch
git add package.json CHANGELOG.md
git commit -m "🤖 release: VS Code extension v0.1.1"
git push origin marketplace-release
git tag vscode-v0.1.1
git push origin vscode-v0.1.1

Ready to Ship

Extension code is production-ready (already merged in #553). This PR only adds release infrastructure.

No code changes - purely documentation and CI/CD setup.

Next Steps After Merge

  1. Complete Azure DevOps setup (PAT + publisher)
  2. Add VSCE_PAT secret to repository
  3. Tag and push vscode-v0.1.0 to trigger first publish
  4. Verify on marketplace: https://marketplace.visualstudio.com/items?itemName=coder.cmux

Questions

  • Publisher name "coder" correct?
  • Ready to publish 0.1.0 immediately after merge?
  • Want pre-release flag for initial launch?

_Generated with `cmux`_

## Changes

- **MARKETPLACE_RELEASE.md**: Comprehensive guide for marketplace publishing
  - Azure DevOps PAT setup instructions
  - Pre-release checklist
  - Manual and automated publishing procedures
  - Troubleshooting guide
  - Maintenance procedures (PAT rotation, monitoring)

- **GitHub Actions workflow**: Automated publishing on tag push
  - Triggers on tags matching `vscode-v*`
  - Builds, packages, and publishes to marketplace
  - Creates GitHub release with .vsix attached
  - Uses `VSCE_PAT` secret for authentication

- **RELEASE_CHECKLIST.md**: Quick reference for release process
  - One-time setup steps
  - Per-release verification steps
  - Automated release commands
  - Post-release verification
  - Emergency manual release fallback

- **README.md**: Updated installation instructions
  - Marketplace installation as primary method
  - .vsix file installation as fallback

- **verify-marketplace-setup.sh**: Pre-publish verification script
  - Checks extension packaging
  - Verifies publisher authentication
  - Validates package.json fields
  - Confirms required files exist

## Usage

Ready to publish extension to VS Code Marketplace. See MARKETPLACE_RELEASE.md
for complete setup and publishing instructions.
Keep it simple - just provide step-by-step instructions instead of
comprehensive documentation.
Publishes on tags matching vscode-v*

Requires VSCE_PAT secret with Azure DevOps PAT
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant