Click Git
Turn VS Code Explorer into a folder-aware Git control surface.
Click Git is for workspaces with many repos, and repos with many folders. Right-click the folder your attention is already on, then stage, restore, diff, commit, pull, or push from there.
No terminal detour. No cd archaeology. No rebuilding the same pathspec by hand.
Right-click a folder. Run the Git command you meant.
Marketplace | GitHub
Watch The Flow
Why It Exists
VS Code is great when you are focused on one repository. Real work is often messier.
You may have a large folder for your knowledge base, notes, prototypes, and active projects. Some folders are just documents. Some are standalone Git repos. Some are nested experiments. When you want to stage or inspect one project, the friction is tiny but constant: open terminal, cd into the right directory, run Git, jump back.
Click Git removes that little tax. Pick the folder in Explorer and act on it.
Features
- Stage only the selected folder.
- Unstage only the selected folder.
- Commit the selected folder without accidentally including unrelated staged files.
- Restore tracked changes in the selected folder while keeping untracked files.
- Show folder-scoped status and diff in a dedicated
Click Git output channel.
- Pull the owning repository from any folder inside it.
- Push the owning repository from any folder inside it, using the current branch upstream.
- Pull many nested repositories under a parent folder, with dirty repos skipped by default.
Built For
- Personal knowledge bases that also contain project repos.
- Workspace folders that collect many independent repos.
- Developers who review generated or AI-assisted changes one folder at a time.
- People who prefer the Explorer tree for navigation but still want precise Git actions.
- Anyone tired of
cd ../../that-one-repo for small Git chores.
How It Works
- Right-click a folder in VS Code Explorer.
- Choose a
Click Git:* command.
- Click Git resolves the owning Git repository and runs the operation with an explicit pathspec.
- Results and longer output go to the
Click Git output channel.
Git pull and push are repository-scoped. If you run Pull Repo or Push Repo from a subfolder, Click Git resolves the owning repository and runs the command at the repo root. It does not claim to protect against Git commands run from terminals, VS Code SCM, other extensions, or external Git clients.
Push uses the current branch's configured upstream. Click Git does not guess origin, choose among multiple remotes, set upstream automatically, force push, push tags, or bulk-push nested repositories. If no upstream is configured, Push Repo fails closed and asks you to set upstream with Git CLI or VS Code Source Control first.
Safety Model
- Folder-scoped commands use explicit Git pathspecs.
- Pull commands are repository-scoped and default to
--ff-only.
- Push commands are repository-scoped and use plain
git push against the current branch upstream.
- Restore keeps untracked files by default.
- The extension requires a trusted workspace before it runs Git commands.
- The MVP does not install Git hooks, mutate
skip-worktree, rewrite commits, or change repository configuration.
Settings
clickGit.pull.ffOnly: use --ff-only for pull commands. Default: true.clickGit.pullNested.maxDepth: maximum directory depth for nested repository discovery. Default: 4.clickGit.pullNested.includeDirtyRepos: pull nested repositories with uncommitted changes. Default: false.clickGit.commit.autoStageFolder: stage the selected folder before committing it. Default: true.clickGit.push.confirmBeforePush: confirm repository path, current branch, and upstream before pushing. Default: true.
Development
npm install
npm run compile
npm test
.\scripts\check.ps1
Manual VS Code Smoke Test
- Open this folder in VS Code.
- Press
F5 and choose Run Click Git Extension.
- In the Extension Development Host, open any folder that contains a Git repository.
- Right-click a folder in Explorer and run one of the
Click Git:* commands.
- For status, diff, pull, push, and nested pull, inspect the
Click Git output channel.
Fast disposable repo setup:
$tmp = Join-Path $env:TEMP "click-git-manual"
Remove-Item -LiteralPath $tmp -Recurse -Force -ErrorAction SilentlyContinue
New-Item -ItemType Directory -Force -Path "$tmp\repo\selected","$tmp\repo\outside" | Out-Null
Set-Location "$tmp\repo"
git init -b main
git config user.name "Click Git Manual"
git config user.email "manual@click-git.test"
"base" | Set-Content selected\file.txt
"base" | Set-Content outside\file.txt
git add .
git commit -m initial
"changed" | Set-Content selected\file.txt
"outside" | Set-Content outside\file.txt
code "$tmp\repo"
Expected quick check:
- Right-click
selected and run Click Git: Stage Folder.
git status --porcelain should show M selected/file.txt and M outside/file.txt.
Publishing
See docs/PUBLISHING.md.
Contributing
See CONTRIBUTING.md.
License
MIT. See LICENSE.
