Pin Files

Pin important files and folders for quick access in a dedicated sidebar view.

Features

• 📌 Pin files & folders — Right-click any file or folder in the Explorer and select Pin File or Pin Folder.
• 📂 Dedicated view — All pinned items appear in the "Pinned Items" sidebar, always one click away.
• 🔄 Real-time sync — When a pinned file or folder is renamed, moved, or has its contents changed, the view updates automatically.
• ↕️ Reorder — Drag-and-drop or use the Move Up / Move Down context menu to arrange your pinned items.
• 👁️ Missing item indicator — Deleted items are shown dimmed so you know they're gone and can unpin them.
• 📁 Expandable folders — Pinned folders expand to show their contents directly in the view.

Usage

1. In the Explorer sidebar, right-click a file or folder.
2. Select 📌 Pin File or 📌 Pin Folder.
3. The item appears in the Pinned Items view (click the pin icon in the Activity Bar).
4. Single-click a pinned file to open it. Expand a pinned folder to browse its contents.
5. Right-click a pinned item to Unpin, Move, or Reveal in Explorer.
6. Drag-and-drop pinned items to reorder them.

Requirements

• VSCode 1.74.0 or later

Extension Settings

This extension does not contribute any settings. Pinned items are stored per-workspace and persist across sessions.

Known Limitations

• File watching only works for items within open workspace folders.
• Rapid batch operations (e.g. git checkout, npm install) are debounced (300ms) before refreshing.

Release & Publishing

This extension uses GitHub Actions for automated releases and Marketplace publishing.

How to publish a new version

1. Bump the version in package.json and commit.
2. Create a git tag (e.g., v0.2.0) and push it:

git tag v0.2.0
git push origin v0.2.0

1. The GitHub Actions workflow (.github/workflows/release.yml) will:
   • Build and package the extension (.vsix)
   • Create a GitHub Release with the .vsix attached
   • Publish to the VS Code Extension Marketplace

Prerequisites for Marketplace publishing

You need a Personal Access Token (PAT) from Azure DevOps for the publisher hitzhangjie. Add it as a GitHub secret named VSCE_PAT in the repository's Settings → Secrets and variables → Actions.

Development

npm install
npm run compile
# Press F5 in VSCode to launch the Extension Development Host