Project Atlas
Auto-record projects, quick access.
English | 中文文档
Features
Auto-tracking
Every project you open is recorded automatically. No manual setup needed.
Quick Access
Open any project from the sidebar with configurable click behavior (single/double click) and window preference. Keyboard shortcuts for instant access.
Favorites & Groups
Star projects for quick access and organize them into named groups with expand/collapse. Drag to reorder favorites.
Git Clone
Clone repositories directly into your workspace from the sidebar.
Project Type Detection
Automatically identifies 16+ project types and displays matching devicon icons.
Project Management
Rename display names, clean up invalid entries, reveal in file explorer, and right-click for quick actions.
Reveal Active File
Adds a button to the built-in file explorer's view title bar to locate the currently open file in the tree (can be toggled in settings).
Task Runner
A dedicated sidebar for running tasks defined in .vscode/tasks.json and npm scripts from package.json. Start, stop, and drag to reorder tasks with real-time status.
Usage
The extension adds two sidebars to VS Code:
Project Atlas — Project management sidebar with two views:
Recent — Shows recently opened projects, sorted by last access time. Use the toolbar to add a project manually or clone a Git repository. The overflow menu lets you clean up invalid entries and open settings.
Favorites — Displays starred projects, optionally organized into groups. Use the toolbar to add the current workspace, create groups, and expand or collapse all groups. Drag to reorder items.
Task Atlas — Task runner sidebar with one view:
Tasks — Lists all tasks from .vscode/tasks.json and npm scripts from package.json (deduplicated). Click to run, click again to stop. Drag to reorder. Tasks are grouped by type and auto-refreshed when config files change.
Click any project to open it. Right-click for more options like renaming, toggling favorites, copying path, or opening in a new window.
Configuration
| Setting |
Type |
Default |
Description |
projectExplorer.recentProjectsLimit |
number |
50 |
Maximum number of recent projects to keep |
projectExplorer.openProjectMode |
ask / currentWindow / newWindow |
ask |
Default window behavior when opening a project |
projectExplorer.openMode |
singleClick / doubleClick / followIDE |
followIDE |
How a click on a project item opens it |
projectAtlas.showRevealActiveFile |
boolean |
true |
Show 'Reveal Active File' button in the built-in file explorer view title |
Keyboard Shortcuts
| Shortcut |
Action |
Alt+O |
Open project picker |
Ctrl+Alt+O |
Focus Project Atlas sidebar |
Changelog
See CHANGELOG.md for release history.
License
This project is licensed under the GNU General Public License v3.0 — free to use, modify, and distribute. Derivative works must also be licensed under GPL 3.0.
