git-cl for VS Code

Manage git-cl changelists directly in VS Code. Organize your working changes into logical groups for focused commits — no Python dependency required.

Features

• Changelists in Source Control — Each changelist appears as a group in the Source Control sidebar with file status decorations (modified, added, deleted, untracked).
• Add files from anywhere — Right-click files in the built-in Git Changes section or the Unassigned group to assign them to a changelist.
• Stage, commit, diff, revert per changelist — Inline buttons on each changelist header let you stage, commit, diff, or revert all files in the group with one click.
• Stash & unstash changelists — Temporarily shelve a changelist (or all of them) and restore later. Stash metadata tracks source branch and timestamps.
• Branch from changelist — Create a new branch containing only the files in a specific changelist.
• Auto-refresh — The tree updates automatically when cl.json changes on disk (e.g. from the CLI tool) or when git status changes.
• Fully interoperable — Reads and writes the same .git/cl.json and .git/cl-stashes.json files as the Python CLI, so you can use both tools side by side.

Installation

From VSIX (local build)

npm install
npm run package
code --install-extension git-cl-vscode-0.0.1.vsix

Development

npm install
# Press F5 in VS Code to launch the Extension Development Host

Usage

Open a workspace that contains a .git directory. The extension activates automatically and adds a Changelists section to the Source Control sidebar.

Adding files to a changelist

• Right-click a file in the built-in Changes list and select Add to Changelist.
• Or right-click a file in the Unassigned group under Changelists.
• Or run git-cl: Add to Changelist from the Command Palette.

You'll be prompted to pick an existing changelist or create a new one. Files can only belong to one changelist at a time — adding a file to a new changelist silently moves it.

Changelist operations

Each changelist group header has inline action buttons:

Button	Action
+	Stage all tracked files in the changelist
-	Unstage all staged files in the changelist
checkmark	Commit the changelist (prompts for message)
trash	Delete the changelist (files return to Unassigned)

Additional operations are available via right-click on the changelist header or the Command Palette:

• Diff Changelist — Open diff tabs for every file in the changelist.
• Checkout (Revert) Changelist — Discard all changes, reverting files to HEAD.
• Stash Changelist — Stash the changelist's changes and save metadata.
• Branch from Changelist — Create a new branch with only this changelist's files.

Stashed changelists

Stashed changelists appear in a read-only Stashed section with their source branch and timestamp. Right-click to Unstash and restore the changelist.

Commands

All commands are available via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) under the git-cl category:

Command	Description
git-cl: Add to Changelist	Add files to a changelist
git-cl: Remove from Changelist	Remove files from their changelist
git-cl: Delete Changelist	Delete a changelist
git-cl: Delete All Changelists	Delete all changelists
git-cl: Stage Changelist	Stage tracked files in a changelist
git-cl: Unstage Changelist	Unstage files in a changelist
git-cl: Commit Changelist	Commit a changelist with a message
git-cl: Diff Changelist	Open diffs for all files in a changelist
git-cl: Checkout (Revert) Changelist	Revert files to HEAD
git-cl: Show Changelist Status	Show formatted status in the output panel
git-cl: Stash Changelist	Stash a single changelist
git-cl: Stash All Changelists	Stash all active changelists
git-cl: Unstash Changelist	Restore a stashed changelist
git-cl: Unstash Changelist (Force)	Unstash without branch/conflict checks
git-cl: Unstash All Changelists	Restore all stashed changelists
git-cl: Branch from Changelist	Create a new branch from a changelist

Requirements

• VS Code 1.85+
• Git installed and available on PATH

License

MIT