FileGravity

中文说明: README.zh-CN.md

Why FileGravity?

"Stop getting lost in trees with hundreds or thousands of files."

In large projects, developers usually work on only a small set of core files repeatedly. FileGravity is a VS Code navigation enhancement extension designed for focused, high-efficiency workflows. It lets you collect scattered project resources into a dedicated sidebar view, so you can jump across deep directory structures without depending on their physical location.

Highlights

• Cross-directory aggregation: add deeply nested files or folders into one working view with a single action
• Logical groups: organize saved items by feature area, task flow, or any grouping strategy that matches your work
• Deeply integrated operations: create, rename, copy paths, open in terminal, and manage items directly from the sidebar
• Flexible storage: keeps compatibility with the existing favorites.* settings and can store data in .vscfavoriterc

Current Behavior

• The Explorer context menu provides Add to FileGravity
• After invoking it, the extension prompts you to choose which group the item should be added to
• The dedicated sidebar view title is FileGravity
• The top view actions currently keep Refresh and Create New Group
• Change Current Group and Toggle Sort are no longer shown as top shortcuts

Installation

Open VS Code Quick Open and run:

ext install lanxiuyun.file-gravity

You can also install a locally packaged .vsix with Extensions: Install from VSIX....

Usage

Add an Item

1. Right-click a file or folder in Explorer.
2. Choose Add to FileGravity.
3. Select the target group from the popup list.

Manage Items

Inside the FileGravity view, you can:

• Create files and folders under directory items
• Copy item paths
• Open locations in terminal or system explorer
• Rename files and folders
• Delete files and folders
• Remove an item from FileGravity without deleting the real file

Configuration

The extension keeps compatibility with the existing favorites.* configuration keys:

{
  "favorites.resources": [],
  "favorites.sortOrder": "ASC",
  "favorites.saveSeparated": false,
  "favorites.groups": ["Default"],
  "favorites.currentGroup": "Default"
}

Development

Install Dependencies

cmd /c npm install

Build

cmd /c npm run build

Package VSIX

cmd /c npm run pk

The generated .vsix file is written to the repository root.

Version

Current extension version: 26.4.14

Acknowledgements

This repository is a forked and customized project built on top of the favorites-extension ecosystem. Thanks to the original upstream work and contributors, especially leftstick/vscode-favorites, for the foundation this project builds on.

License

GPL v3 License