New

Navigate Code by Functionality, Not Just Files

Group Code transforms how you organize and navigate your codebase. Using special comments to tag related code sections across multiple files and languages, it creates a unified view that makes it easier to understand and work with complex projects.

example.ts

Features

Discover how Group Code transforms your coding experience with these powerful features

Smart Code Groups

Automatically organize your code into logical groups based on functionality using smart comment detection.

Cross-File Navigation

Easily navigate related code sections across different files and languages.

Hierarchical View

View your codebase in a hierarchical structure based on functionality rather than file location.

Quick Navigation

Quickly find and jump to related code sections using the sidebar or command palette.

Multi-Language Support

Works with 40+ programming languages, automatically detecting the appropriate comment syntax.

Auto-Detection

Automatically detects and groups code based on existing comments in your codebase.

Installation

Get started with Group Code in just a few simple steps

1

From VS Code Marketplace

The easiest way to install Group Code is directly from the VS Code Marketplace:

  1. Open VS Code
  2. Go to Extensions view (Ctrl+Shift+X / Cmd+Shift+X)
  3. Search for "Group Code"
  4. Click Install
2

Manual Installation

Alternatively, you can install the extension manually using the VSIX file:

  1. Download the groupcode-1.0.1.vsix file
  2. In VS Code, open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
  3. Run "Extensions: Install from VSIX..." and select the downloaded file
3

Getting Started

After installation, you'll see a new Group Code icon in your Activity Bar. The extension will automatically scan your workspace for code groups when you open a folder.

How to Use Group Code

Learn how to create and navigate code groups in your projects

Creating Code Groups

Add special comments to your code following this pattern: * GroupName: Description of functionality

The extension automatically recognizes different comment formats based on the file type:

JavaScript
// @group Authentication: User login process
function login(username, password) {
// Your code here
}
Python
# @group Authentication: User authentication backend
def authenticate_user(username, password):
# Your Python code here
HTML
<!-- @group Authentication: Login form layout -->
<form class="login-form">
<!-- Your HTML here -->
</form>
CSS
/* @group Authentication: Login form styling */
.login-form {
/* Your CSS here */
}

Smart Inline Comments

Group Code automatically detects inline group markers, enabling you to:

JavaScript
const apiKey = process.env.API_KEY; // @group Security: API authentication
fetchUserData(userId); // @group UserData: Fetch user information
updateUI(userData); // @group UserInterface: Update display with user data

Viewing & Navigating Code Groups

Once you've added code groups to your project, you can navigate them in several ways:

Using the Explorer

  1. Click on the Group Code icon in the Activity Bar
  2. Expand a functionality group to see all related code sections
  3. Click on any code section to navigate directly to that file and line

Using the Status Bar

  1. Click on the Group Code indicator in the status bar (or press Ctrl+Shift+G / Cmd+Shift+G)
  2. Select a functionality from the dropdown
  3. Choose which specific code section to navigate to

Available Commands

Access these commands through the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

  • Group Code in Current File: Scan only the active file for code groups
  • Group Code in Workspace: Scan all supported files in the workspace
  • Scan External Project Folder: Scan code in a folder outside your workspace
  • Show Code Groups: Display the quick picker to navigate between groups
  • Refresh Code Groups: Perform a complete rescan of all files

Supported Languages

Group Code works with 40+ programming languages

Web Technologies

JavaScript TypeScript HTML CSS SCSS Vue JSX XML

Backend Languages

Python Java C# Go PHP Ruby Rust Node.js

System Programming

C C++ Swift Objective-C Kotlin Assembly

Functional Languages

Haskell F# Clojure Scala Elm

Scripting & Others

Shell Bash PowerShell Lua R YAML Markdown

Others

SQL Dart Julia COBOL Fortran +Many More

Frequently Asked Questions

Common questions about Group Code

How does Group Code differ from regular code navigation?
+

Regular navigation is file-based, while Group Code organizes by functionality. This helps you understand the project from a feature perspective rather than a file structure perspective, making it easier to understand and maintain complex codebases.

Will Group Code slow down my editor?
+

Group Code is designed to be lightweight and efficient. It scans files incrementally and caches results to avoid performance issues. For very large projects, the initial scan might take a moment, but subsequent operations are fast.

Do I need to add comments to all my code?
+

No, you can start by adding code group comments to just the most important parts of your codebase. You can gradually add more as you work with your project. The inline comment feature makes it easy to add groups without restructuring existing code.

Does it work with version control systems?
+

Yes, the code group comments are just regular comments in your code, so they work perfectly with Git or any other version control system. The extension stores its data in a .groupcode folder which you can add to your .gitignore if you prefer not to track it.

What if I can't find my code groups?
+

If groups aren't appearing, try the "Refresh Code Groups" command. Ensure comments follow the exact pattern: * GroupName: Description. For inline comments, make sure there's a space after the comment marker (e.g., // * Group not //* Group). You can also check the Output panel (View → Output → Group Code) for detailed logs.

How do I create code groups?

Simply add special comments in your code using the pattern "* GroupName: Description". The extension will automatically detect and group related code sections.

Which languages are supported?

Group Code supports 40+ programming languages including JavaScript, Python, Java, C++, TypeScript, Ruby, Go, and many more. The extension automatically detects the appropriate comment syntax for each language.

Can I customize the group detection?

Yes! You can customize the comment patterns and group organization through VS Code settings. This allows you to adapt Group Code to your team's coding style and preferences.

Does it work with existing codebases?

Absolutely! Group Code can analyze existing codebases and automatically detect code groups based on your existing comments. It's designed to work seamlessly with both new and existing projects.

Best Practices

Get the most out of Group Code with these tips

Consistent Naming

Use the same group name across different files to ensure related code is grouped together properly.

Descriptive Groups

Choose meaningful group names that reflect functionality rather than technical details.

Hierarchical Organization

Consider using prefixes like "Auth:" for related groups to create a logical hierarchy.

Regular Refreshing

Use the "Refresh Code Groups" command after significant changes to ensure your view is up-to-date.

Mixed Approaches

Combine standalone comments for major blocks with inline comments for important individual lines.

Collaborative Usage

Agree on group naming conventions with your team to maintain consistency across the project.