File bookmarks for VS Code

Large projects rarely fit neatly into folders. A single feature can span routes, components, tests, services, configs, and database files.

Normal folders describe where files live. CodeGroup adds bookmark folders that describe which files belong together while you work—without changing your project structure.

• Keep feature files together even when they live in different directories.
• Build working sets instantly from open editors or current Git changes.
• Navigate large codebases faster with Quick Open and pinned groups.
• Share team-specific file collections through Git-friendly JSON.
• Keep reusable global groups available across projects.

Bookmarks, groups, and folders

CodeGroup uses familiar folder ideas without changing the folders on disk:

The same file can appear in multiple groups because CodeGroup stores references, not copies. Renaming or moving a tracked file updates its bookmark, and deleting a file can be cleaned from the affected groups. Your Explorer folder structure remains unchanged.

Core features

Quick start

After a fresh install, VS Code automatically opens the Getting Started with CodeGroup walkthrough. It explains the bookmark model and guides you through creating a group, adding files, and reopening a working set. You can revisit it later from Help → Get Started.

1. Install CodeGroup from the VS Code Marketplace.
2. Open the CodeGroup view inside Explorer.
3. Click + to create a group—your first bookmark folder.
4. Drag files from Explorer or open tabs into the bookmark group.
5. Click a file to open it, or use Open All for the full working set.

That is enough to start. Everything else is optional.

Visual group editor

Open any group in the visual editor to manage its name, notes, icon, color, badge, order, storage scope, presets, and file membership in one place.

Smart Groups

CodeGroup can generate useful groups automatically instead of making you organize everything manually.

Project-area grouping

Create groups such as:

• Frontend
• Backend
• Tests
• Scripts
• Documentation
• Source core

Language-family grouping

Generate groups for TypeScript, JavaScript, styles, documentation, configuration, media, and more.

Generated groups remain normal editable CodeGroup groups, so you can rename, recolor, reorder, nest, or extend them afterward.

Working Sets

Turn temporary development context into a reusable group in one action.

From open editors

Capture your currently open tabs into a group.

Useful for:

• feature work
• debugging sessions
• refactors
• research

From Git changes

Create a group from uncommitted files in the current workspace.

Useful for:

• PR review
• bugfix context
• release preparation
• keeping a change set visible while working

Drag & drop

CodeGroup supports drag & drop across the workflow:

• Explorer files → groups
• open tabs → groups
• groups → groups to create subgroups
• subgroups → root
• files → reorder inside groups
• groups → editor to open all files
• groups → Copilot Chat to attach multiple files at once

Global Groups

Create groups that are available across projects instead of being tied to a single workspace.

Typical uses:

• frequently used scripts
• shared documentation
• utility files
• reference projects

Global groups can be hidden per workspace and can be moved back to local workspace storage when needed.

Sharing and storage

Workspace groups are stored in:

.vscode/file-groups.json

Paths are relative, so the configuration can be committed to Git and shared with a team.

You can also export an individual group tree as shareable JSON and import it elsewhere.

See the copy-paste shared-group JSON recipes for frontend/backend, bugfix, PR review, and documentation workflows.

Workspace storage example:

{
  "version": 2,
  "groups": [
    {
      "id": "abc123",
      "name": "Authentication",
      "icon": "key",
      "color": "#3498DB",
      "shortDescription": "Login endpoints",
      "files": [
        { "path": "src/auth/login.ts", "name": "login.ts" }
      ]
    }
  ]
}

Screenshots

Main view

Context menu

Commands

Requirements

• VS Code 1.74.0 or newer

Development

CodeGroup is written in TypeScript.

Requirements

• Node.js 22+
• npm
• VS Code 1.74+

Setup

git clone https://github.com/MiszterSoul/codegroup.git
cd codegroup
npm ci
npm run verify

Useful commands

Install the local package with:

code --install-extension dist/codegroup-file-organizer.vsix --force

Contributing

Contributions are welcome.

See CONTRIBUTING.md for development setup and contribution guidelines.

• Report a bug
• Request a feature
• Browse good first issues
• Open pull requests

Releases

See CHANGELOG.md for release history.

The current extension manifest version is published through the VS Code Marketplace and Open VSX release flow.

License

MIT