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
In the Explorer sidebar, right-click a file or folder.
Select 📌 Pin File or 📌 Pin Folder.
The item appears in the Pinned Items view (click the pin icon in the Activity Bar).
Single-click a pinned file to open it. Expand a pinned folder to browse its contents.
Right-click a pinned item to Unpin, Move, or Reveal in Explorer.
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
Bump the version in package.json and commit.
Create a git tag (e.g., v0.2.0) and push it:
git tag v0.2.0
git push origin v0.2.0
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
