ggopen

A cross-platform, zero-dependency CLI for Windows, Linux, and macOS that lets you quickly browse your projects and open them in Visual Studio Code or Cursor.

ggopen automatically detects your project structure and can open projects:

• as a multi-root workspace;
• in multiple editor windows;
• or directly from their parent folder.

Installation

npm install -g @ourssympa/ggopen

Requirements

• Node.js 14 or later

• At least one of the following editors installed and available in your PATH:

  • Visual Studio Code (code)
  • Cursor (cursor)

If the command isn't available, open your editor's Command Palette and run:

• VS Code: Shell Command: Install 'code' command in PATH
• Cursor: Shell Command: Install 'cursor' command in PATH

Installing the package with npm automatically creates the ggopen command on every supported operating system (ggopen on Linux/macOS and ggopen.cmd on Windows). No additional setup is required.

Getting Started

Register one or more folders containing your projects.

For example:

ggopen add personal "~/Desktop/Personal Projects"
ggopen add work "/home/ubuntu/Projects"

Then simply run:

ggopen

If no source has been registered yet, ggopen will automatically prompt you to add one the first time it is launched.

Interactive Menu

Navigate through your projects with ease:

| Key | Action | | ------- | ------------------------- | | ↑ / ↓ | Navigate | | j / k | Vim-style navigation | | Enter | Open the selected project | | q / Esc | Quit |

If multiple sources are registered, each project is prefixed with its source name to avoid ambiguity.

When a project contains multiple folders (for example, a frontend and a backend), ggopen lets you choose how to open it:

• Multi-root workspace – Open all folders in a single editor window.
• Separate windows – Open one window per folder.
• Parent folder – Open only the project's parent directory.

Single-folder projects are opened immediately.

If the list exceeds the terminal height, it scrolls automatically.

Choosing Your Editor

ggopen works with both Visual Studio Code and Cursor.

On the first launch:

• if both editors are detected, you'll be asked which one to use by default;
• if only one is installed, it will be selected automatically.

Change the default editor

ggopen editor

or directly:

ggopen editor code
ggopen editor cursor

Override the editor for the current session

Without changing your saved preference:

ggopen --vsc

Force the current session to use Visual Studio Code.

ggopen --crs

Force the current session to use Cursor.

You can also open a project directly with a specific editor:

ggopen open <project> --vsc
ggopen open <project> --crs

Available Commands

ggopen
    Launch the interactive menu.

ggopen add <name> <path>
    Add or update a source.

ggopen remove <name>
    Remove a source.

ggopen list
    List all registered sources and their projects.

ggopen hide <project>
    Hide a project from the menu.

ggopen show <project>
    Show a previously hidden project.

ggopen open <project>
    Open a project directly.

ggopen open <project> --mode workspace
    Open as a multi-root workspace.

ggopen open <project> --mode windows
    Open each folder in a separate editor window.

ggopen open <project> --mode single
    Open only the project's parent folder.

ggopen <project>
    Shortcut for:
    ggopen open <project>

ggopen editor
    Choose or change the default editor.

ggopen --dir <path>
    Scan a directory once without registering it.

ggopen --vsc
    Use Visual Studio Code for this session.

ggopen --crs
    Use Cursor for this session.

ggopen --version
    Display the installed version.

ggopen --help
    Show the help message.

Automatic Project Detection

For every registered source, ggopen automatically analyzes your folders to make opening projects effortless.

It can:

• automatically group sibling folders such as:

myproject-api
myproject-front

into a single project;

• detect container folders and expose their child projects (frontend, backend, etc.);

• recognize project roots by looking for files such as:

package.json
requirements.txt
go.mod
Cargo.toml
*.sln
...

• identify folders that look like archived projects and label them with [archive].

License

Released under the MIT License.