This gif is a little old! We are now using the VS Code integrated GitHub login system and the extension is prettier! The gif will be eventually updated!

The * means that the repository is dirty! So it has local changes that aren't yet commited!

To make your GitHub cloned repositories show up in the Cloned tree view, you will need to set the "git.defaultCloneDirectory" in your VSCode settings.json file to an absolute path where your cloned repositories are located (the may be deeply located there).

1.4.0 - there is now a button to set this config interactively!

By hovering the REPOSITORIES tree view title, a + button appears. Click on it, enter the new repository name, description (optional) and visibility. On success, you may choose to clone the new repository.

If you are a member of at least one organization that allows you to create repositories for it, it will be asked, before the repository name input, to pick the new repository owner: your own account or one of those organizations.

You may create a GitHub repository and push your current project within the same flow. If there are multiple folders in your workspace that may be published to GitHub, it will be prompted to pick one.

There are 2 possible cases that allows using that publish functionality:

1. Your project doesn't have a Git yet. After entering the repository name, description and visibility, the repository will be created, the git will be initialized for the workspace folder, main branch will be created and selected, GitHub remote will be added as origin and your files will then be pushed to it.

2. Your project has a Git, but it hasn't a remote yet. After filling the repository information, it will be checked if your git HEAD is master. If so, it will ask if you want the branch to be renamed to main. Then the repository will be created, the GitHub remote is added as origin and your code is pushed.

• Always Clone To Default Directory

"githubRepositoryManager.alwaysCloneToDefaultDirectory"

Always clone to the directory specified in "git.defaultCloneDirectory".

Default: false

• Default Clone Directory Maximum Depth

"githubRepositoryManager.clonedRepositoriesSearch.defaultCloneDirectoryMaximumDepth"

How deep on "git.defaultCloneDirectory" the cloned repositories will be searched. A depth of 0 means it will only search in the directory itself, a depth of 3 means it will search up to 3 directories below. The lesser the faster.

Default: 2

• Directories To Ignore

"githubRepositoryManager.clonedRepositoriesSearch.directoriesToIgnore"

Directories names that are ignored on the search for the cloned repositories. **/ is added to their start.

Default: ["node_modules", ".vscode", ".git/*", "logs", "src", "lib", "out", "build"]

• Search and clone public repositories

• Other repositories found by the Cloned Repository Searcher. Useful for quickly opening a repository you don't own.

• Visualize without cloning (useful for getting some value or checking something from some repository)

• "Order by" (alphabetically, stars, your open frequency, created on, updated on) in top menu

• Search repository by name

• Fetch repositories on demand - Some devs have hundreds or thousands of repos. Instead of fetching all of them on init and displaying all of them together, there could be a [1..100], [101, 200] tree system, for both on demand fetch and display.

• Remove cloned from local if it isn't dirty (= not locally diff from github)

For developing: clone it, run npm i, npm start and run the debugger.