Downloads of v 1.10.3:


Last Update:

13 Aug 2019

Package Maintainer(s):

Software Author(s):

  • passcod


watchexec file notify automatically execute watcher monitor change


This is not the latest version of watchexec available.

  • 1
  • 2
  • 3

1.10.3 | Updated: 13 Aug 2019



Downloads of v 1.10.3:



Software Author(s):

  • passcod

  • 1
  • 2
  • 3
watchexec 1.10.3

This is not the latest version of watchexec available.

  • 1
  • 2
  • 3

All Checks are Passing

3 Passing Tests

Validation Testing Passed

Verification Testing Passed


Scan Testing Successful:

No detections found in any package files


To install watchexec, run the following command from the command line or from PowerShell:


To upgrade watchexec, run the following command from the command line or from PowerShell:


To uninstall watchexec, run the following command from the command line or from PowerShell:


NOTE: This applies to both open source and commercial editions of Chocolatey.

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

  • Open Source or Commercial:
    • Proxy Repository - Create a proxy nuget repository on Nexus, Artifactory Pro, or a proxy Chocolatey repository on ProGet. Point your upstream to Packages cache on first access automatically. Make sure your choco clients are using your proxy repository as a source and NOT the default community repository. See source command for more information.
    • You can also just download the package and push it to a repository Download

3. Enter your internal repository url

(this should look similar to

4. Choose your deployment method:

choco upgrade watchexec -y --source="'STEP 3 URL'" [other options]

See options you can pass to upgrade.

See best practices for scripting.

Add this to a PowerShell script or use a Batch script with tools and in places where you are calling directly to Chocolatey. If you are integrating, keep in mind enhanced exit codes.

If you do use a PowerShell script, use the following to ensure bad exit codes are shown as failures:

choco upgrade watchexec -y --source="'STEP 3 URL'"

Write-Verbose "Exit code was $exitCode"
$validExitCodes = @(0, 1605, 1614, 1641, 3010)
if ($validExitCodes -contains $exitCode) {
  Exit 0

Exit $exitCode

- name: Ensure watchexec installed
    name: watchexec
    state: present
    version: 1.10.3
    source: STEP 3 URL

See docs at

chocolatey_package 'watchexec' do
  action    :install
  version  '1.10.3'
  source   'STEP 3 URL'

See docs at

    Name: watchexec,
    Version: 1.10.3,
    Source: STEP 3 URL

Requires Otter Chocolatey Extension. See docs at

cChocoPackageInstaller watchexec
   Name     = 'watchexec'
   Ensure   = 'Present'
   Version  = '1.10.3'
   Source   = 'STEP 3 URL'

Requires cChoco DSC Resource. See docs at

package { 'watchexec':
  provider => 'chocolatey',
  ensure   => '1.10.3',
  source   => 'STEP 3 URL',

Requires Puppet Chocolatey Provider module. See docs at

salt '*' chocolatey.install watchexec version="1.10.3" source="STEP 3 URL"

See docs at

5. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

Private CDN cached downloads available for licensed customers. Never experience 404 breakages again! Learn more...

This package was approved by moderator Pauby on 20 Aug 2019.



Software development often involves running the same commands over and over. Boring!

watchexec is a simple, standalone tool that watches a path and runs a command whenever it detects modifications.

Example use cases:

* Automatically run unit tests
* Run linters/syntax checkers

## Features

* Simple invocation and use
* Runs on OS X, Linux and Windows
* Monitors current directory and all subdirectories for changes
* Uses most efficient event polling mechanism for your platform (except for BSD)
* Coalesces multiple filesystem events into one, for editors that use swap/backup files during saving
* By default, uses .gitignore to determine which files to ignore notifications for
* Support for watching files with a specific extension
* Support for filtering/ignoring events based on glob patterns
* Launches child processes in a new process group
* Sets the following environment variables in the child process:
* If a single file changed (depending on the event type):
* $WATCHEXEC_CREATED_PATH, the path of the file that was created
* $WATCHEXEC_REMOVED_PATH, the path of the file that was removed
* $WATCHEXEC_RENAMED_PATH, the path of the file that was renamed
* $WATCHEXEC_WRITTEN_PATH, the path of the file that was modified
* $WATCHEXEC_META_CHANGED_PATH, the path of the file whose metadata changed
* If multiple files changed:
* $WATCHEXEC_COMMON_PATH, the longest common path of all of the files that triggered a change
* Optionally clears screen between executions
* Optionally restarts the command with every modification (good for servers)
* Does not require a language runtime

## Anti-Features

* Not tied to any particular language or ecosystem
* Does not require a cryptic command line involving xargs

## Usage Examples

Watch all JavaScript, CSS and HTML files in the current directory and all subdirectories for changes, running make when a change is detected:

$ watchexec --exts js,css,html make

Call make test when any file changes in this directory/subdirectory, except for everything below target:

$ watchexec -i target make test

Call ls -la when any file changes in this directory/subdirectory:

$ watchexec -- ls -la

Call/restart python when any Python file in the current directory (and all subdirectories) changes:

$ watchexec -e py -r python

Call/restart my_server when any file in the current directory (and all subdirectories) changes, sending SIGKILL to stop the child process:

$ watchexec -r -s SIGKILL my_server

Send a SIGHUP to the child process upon changes (Note: with using -n | --no-shell here, we're executing my_server directly, instead of wrapping it in a shell:

$ watchexec -n -s SIGHUP my_server

Run make when any file changes, using the .gitignore file in the current directory to filter:

$ watchexec make

Run make when any file in lib or src changes:

$ watchexec -w lib -w src make

## Credits

* notify for doing most of the heavy-lifting
* globset for super-fast glob matching

$ErrorActionPreference = 'Stop';

$version     = $env:chocolateyPackageVersion
$packageName = $env:chocolateyPackageName
$toolsDir    = "$(Split-Path -parent $MyInvocation.MyCommand.Definition)"

$url64       = ("{0}/watchexec-{0}" -f $version)

$packageArgs = @{
    packageName    = $packageName
    unzipLocation  = Split-Path $MyInvocation.MyCommand.Definition
    url64bit       = $url64
    checksum64     = "F831908FBB0A2BE0A3A2DC10A5B2F26303FCCCB8"
    checksumType64 = "sha1"

Install-ChocolateyZipPackage @packageArgs

Log in or click on link to see number of positives.

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Version Downloads Last Updated Status
watchexec 1.16.1 92 Sunday, May 23, 2021 Approved
watchexec 1.16.0 18 Friday, May 21, 2021 Approved
watchexec 1.13.1 377 Tuesday, June 30, 2020 Approved
watchexec 1.10.3 347 Tuesday, August 13, 2019 Approved

  • The man page was brought up-to-date to new options and a hint to use -- (#125)

This package has no dependencies.

Discussion for the watchexec Package

Ground Rules:

  • This discussion is only about watchexec and the watchexec package. If you have feedback for Chocolatey, please contact the Google Group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or watchexec, or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.
comments powered by Disqus