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).
Usage
The extension adds two views to the VS Code sidebar under the Project Atlas icon:
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.
Click any project to open it. Right-click for more options like renaming, toggling favorites, 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.
