Git Stash

Seamlessly integration of git stash functionalities to your editor

Features

This extension adds a rich set of commands and an interactive explorer tree where you can create, inspect, apply and delete stashes, so managing this data becomes a breeze. It also adds a context menu option on the files listed in the source control view to selectively stash them. Every executed command is logged along its output for peace of mind.

Stashes explorer

Apply, pop, branch, drop stashes (buttons / context menu)
Diff stashed file changes + alternative diff modes
Apply changes from single stashed file
Copy to clipboard (context menu)
Configurable labels, descriptions, icons, tooltips, decorations, clipboard data
Configurable data loading strategy for files (performance related)

Source control explorer

Stash selected files (context menu)

Screenshots

GitStash preview

Tree actions

Success notification

Conflicts notification

Failure notification

Image diff

Diff view modes

Stash changes ⟷ Current

This is the main diff mode where the stashed changes are compared to the current state of the file.

Current ⟷ Stash changes

This diff view compares the current state of the file to the staged file, this helps to review how valuable may be the previous (staged) changes considering the latest updates.

Stash source ⟷ Current

This mode compares the original state of the stashed file before being modified. Being able to compare the staged file before changing can be helpful when the current state of the file has changed in a way that the staged changes don't make much cense anymore.

Current ⟷ Stash source

Alternative way to diff the stashed file without its changes.

Commands

Title	Command	Description
Stash...	gitstash.stash	Generate a stash with custom options. Use `stash only` to generate a simple stash. Use `Keep index` to stash but keep all changes added to the index intact (besides stashing them). Use `Include untracked` if you want to stash also untracked files, leaving the working directory in a very clean state. If you want to stash besides the untracked files, the ignored ones, use the `All` option instead. WARNING: Using `Include untracked` (which applies the --include-untracked option) will clean/delete any ignored file, this is not a behavior implemented on the extension but the way some old git versions work.
Pop...	gitstash.pop	Pops a stash w/ or w/o file reindexing, If reindexing selected, every change added to index will be back to that state. this can fail, when you have conflicts (which are stored in the index, where you therefore can no longer apply the changes as they were originally).
Apply...	gitstash.apply	Applies a stash w/ or w/o file reindexing. Reindexing will work the same as Stash Pop with reindex.
Branch...	gitstash.branch	Creates and checks out a new branch starting from the commit at which the stash was originally created, applies the changes recorded in the selected stash to the new working tree and index. If that succeeds the stash will be dropped.
Drop...	gitstash.drop	Drops a stash.
Clear	gitstash.clear	Removes all the repository stashes.
Refresh explorer	gitstash.explorer.refresh	Reloads the stash explorer tree.
Toggle explorer	gitstash.explorer.toggle	Shows/hides the stash explorer tree.

Extension Settings

Name	Description
`gitstash.explorer.enabled`	Shows or hides the explorer on startup
`gitstash.explorer.buttons`	Shows or hides the explorer tree buttons
`gitstash.explorer.eagerLoadStashes`	If enabled, stashes will be preloaded instead of lazy loaded. This is required to see the stashes count but may degrade performance if theres too much data
`gitstash.explorer.itemDisplayMode`	Configures if empty repositories should be listed, hidden or indicate its emptiness. This setting only applies if stashes are configured to be preloaded
`gitstash.explorer.items.repository.labelContent`	Specifies the format for each repository label. Available tokens: `${name}` - the repository name. `${directory}` - the repository directory base name. `${path}` - the repository directory path. `${stashesCount}` - the number of stashes on the repository
`gitstash.explorer.items.repository.descriptionContent`	Specifies the format for each repository description. Available tokens: Same than repository.labelContent
`gitstash.explorer.items.repository.tooltipContent`	Specifies the format for each repository tooltip. Available tokens: Same than repository.labelContent
`gitstash.explorer.items.repository.to-clipboardContent`	Specifies repository data to be set on clipboard. Available tokens: Same than repository.labelContent
`gitstash.explorer.items.stash.labelContent`	Specifies the format for each stash label. Available tokens: `${branch}` - the branch where the stash was created. `${description}` - the custom or default description for the stash. `${dateTimeLong}` - the creation date & time, long format. `${dateTimeSmall}` - the creation date & time, medium format. `${dateSmall}` - the creation date, small format. `${dateTimeIso}` - the creation date & time, ISO format. `${dateIso}` - the creation date, ISO format. `${ago}` - the creation date, ago format. `${index}` - the stash index
`gitstash.explorer.items.stash.descriptionContent`	Specifies the format for each stash description . Available tokens: Same than stash.labelContent
`gitstash.explorer.items.stash.tooltipContent`	Specifies the format for each stash tooltip . Available tokens: Same than stash.labelContent
`gitstash.explorer.items.stash.to-clipboardContent`	Specifies stash data to be set on clipboard. Available tokens: nSame than stash.labelContent
`gitstash.explorer.items.stash.popAndApply`	Defines if pop or apply will be set as item button (and the secondary action as context menu option)
`gitstash.explorer.items.stash.diffButton`	Defines which comparison to display from a file diff button
`gitstash.explorer.items.file.decoration`	Adds decorations to the tree items
`gitstash.explorer.items.file.icons`	Defines the icon to show on files
`gitstash.explorer.items.file.labelContent`	Specifies the format for each file label. Available tokens: `${filename}` - the file name. `${filepath}` - the file path. `${type}` - the change type
`gitstash.explorer.items.file.descriptionContent`	Specifies the format for each file description . Available tokens: Same than file.labelContent
`gitstash.explorer.items.file.tooltipContent`	Specifies the format for each file tooltip . Available tokens: Same than file.labelContent
`gitstash.explorer.items.file.to-clipboardContent`	Specifies file data to be set on clipboard. Available tokens: Same than file.labelContent. `${oldName}` - the previous name
`gitstash.explorer.items.renamedFile.labelContent`	Specifies the format for each renamed file label. Available tokens: `${filename}` - the file name. `${oldFilename}` - the previous file name. `${filepath}` - the file path. `${type}` - the change type
`gitstash.explorer.items.renamedFile.descriptionContent`	Specifies the format for each renamed file description . Available tokens: Same than renamedFile.labelContent
`gitstash.explorer.items.renamedFile.tooltipContent`	Specifies the format for each renamed file tooltip . Available tokens: Same than renamedFile.labelContent
`gitstash.explorer.items.renamedFile.to-clipboardContent`	Specifies file data to be set on clipboard. Available tokens: Same than renamedFile.labelContent
`gitstash.editor.diffTitleFormat`	Specifies the format for the diff editor title. Available tokens: `${filename}` - the file name. `${filepath}` - the file path. `${fileIndex}` - the file index. `${dateTimeLong}` - the stash date & time, long format. `${dateTimeSmall}` - the stash date & time, medium format. `${dateSmall}` - the stash date, small format. `${dateTimeIso}` - the stash date & time, ISO format. `${dateIso}` - the stash date, ISO format. `${ago}` - the stash date, ago format. `${description}` - the stash description. `${branch}` - the stash branch. `${stashIndex}` - the stash index. `${type}` - the change type on the file like 'Modified' or 'Deleted'. `${hint}` - like `${type}` but indicates also the editor position of the change
`gitstash.log.autoclear`	Clears the log window before showing the action result
`gitstash.advanced.repositorySearchDepth`	Search depth for finding repositories on subdirectories. If value is negative parent directory repositories will be searched

Tips

Contrary to the git stash command included in VS Code, with Stash... - Stash only you can generate a stash even though all your changes are already added to index.
Use Stash... - Keep index if you want to make two or more commits out of the changes in the working tree and you want to isolate features to test each change before committing.
With Git Stash + Stash Apply... you can make a backup in case you want to make some cleanup for incomplete features before making a commit.
You may want to control when to see the stash explorer, to do so add a key binding to execute gitstash.explorer.toggle and configure the extension to not to show the stash explorer tree when starting the editor with gitstash.explorer.enabled.

Git Stash

Arturo Rodríguez

Git Stash

Features

Stashes explorer

Source control explorer

Screenshots

Diff view modes

Stash changes ⟷ Current

Current ⟷ Stash changes

Stash source ⟷ Current

Current ⟷ Stash source

Commands

Extension Settings

Tips