git-stashd(1)

• Description
• Installation
  • Homebrew
  • Manual
• Options
• Examples
• Notes

Description

git-stashd is an autostashing daemon for Git. By utilizing the stashing functionality built into Git, git-stashd stores the modified contents of a dirty worktree in a stash, which you can checkout, commit, or discard at a later point.

Installation

There are two installation methods, Homebrew and manual.

Homebrew

brew tap nickolasburr/pfa
brew install git-stashd

Manual

By default, git-stashd is installed to /usr/local/bin. You can set the prefix variable when running make to specify an alternate path.

make
make install

Options

Option	Description	Default
-F --foreground	Run daemon in foreground.	—
-i <SEC> --interval=<SEC>	Interval in seconds to check for changes.	600
-L <PATH> --log-file=<PATH>	Path to alternate log file.	$HOME/git-stashd.log
-M <COUNT> --max-entries=<COUNT>	Maximum number of stash entries.†	100
-p <PATH> --path=<PATH>	Path to Git repository.	$PWD
-h --help	Show help information.	—
-v --version	Show version information.	—

Examples

Start daemon for repository ~/projects/example

# You can omit --path ~/projects/example, if currently in the ~/projects/example directory.
git stashd --path=~/projects/example

Start daemon for repository ~/projects/example with an interval of 30 seconds

git stashd --path=~/projects/example --interval=30

Start daemon in foreground for repository ~/projects/example with an interval of 5 minutes

git stashd -F --path=~/projects/example --interval=300

Notes

† When --max-entries threshold is met, the daemon will exit.