NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #5433 most downloaded on crates.io
Find, parse, and interpret ignore files
Latest stable
3.0.8
Last release 1 months ago
02 Oct 2026
Ships fairly regularly
a new release about every 4 months
Nearly every release is documented
notes for 17 of 17 stable releases
1 version withdrawn
withdrawn after publishing
4 years old
18 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
chore: Release package ignore-files version 3.0.8
chore: Release package ignore-files version 3.0.8
chore: Release package ignore-files version 3.0.7
chore: Release package ignore-files version 3.0.7
IgnoreFilter::match_path_or_ancestors and IgnoreFilter::check_dir for top-down recursive source filtering. An ignored ancestor prunes its subtree; a descendant negation cannot reopen it.VCS_DIR_NAMES so ignore discovery and clients can share the same metadata-directory list.Your coding agent can read these notes before it upgrades. Set up the MCP server →
chore: Release package ignore-files version 3.0.6
chore: Release package ignore-files version 3.0.6
Fix: match git's behaviour for finding ignores
Calls to add_globs() and add_file() dynamically create a new ignore entry if there isn't one at the location of applies_in param. This allows users to
add_globs() and add_file() dynamically create a new ignore entry if there isn't one at the location of applies_in param. This allows users to e.g. add globs to a path that previously has no ignore files in. (#908)- Deps: gix-config 0.43
- Deps: gix-config 0.40
Hide fmt::Debug spew from ignore crate, use full_debug feature to restore.
full_debug feature to restore.- Deps: gix-config 0.36 - Deps: miette 7
New: -W, --watch-non-recursive for watching paths without also watching subfolders.
-W, --watch-non-recursive for watching paths without also watching subfolders..git is a file rather than a folder)normalize-path).IgnoreFilesFromOriginArgs for that purpose.The idea, however, is to start a new era of Watchexec releases, where breaking changes are allowed more easily (to give an idea of how breaking-change…
This is the first breaking release. Most of it is cleaning up a number of deprecated options, and changing some defaults. The idea, however, is to start a new era of Watchexec releases, where breaking changes are allowed more easily (to give an idea of how breaking-change-averse the project has been: this release was planned in January 2022! and ever-delayed since).
Fear not! The cadence of breaking releases will be at most once or twice a year, and whenever possible a deprecation will precede a break by at least three months. Watchexec will remain a stable part of your workflow, while allowing ourselves some evolution.
$SHELL when it is present. (#210)
Use --shell=sh to switch back if your $SHELL is something else.--shell=cmd to switch back to CMD.EXE, or set the SHELL environment variable.
A reminder that Windows 7 is not supported, and hasn't been for years.--on-busy-update defaults to do-nothing now (was queue).
Events received while a command is running won't trigger a run of the command immediately following this one.-W / --watch-when-idle is removed, as it is now the default.--stop-timeout is now 10 seconds.--debounce, --delay-run, --poll, and --stop-timeout now prefer durations with a unit, and warn if given unit-less durations. The default units for these are millisecond for --debounce and --poll, and seconds for --delay-run and --stop-timeout, which is a source of confusion. Unit-less durations will be removed in a future breaking release.--no-shell is removed.
Use --shell=none instead. The -n short option remains as an alias to --shell=none.-k / --kill is removed.
Use --signal=KILL instead.--changes-only is removed.
Use --print-events instead.--emit-events-to defaults to none, and the environment mode is deprecated.--emit-events-to no longer accepts stdin (deprecated alias for stdio) and json-stdin(deprecated alias for json-stdio).--no-ignore is removed.
Use --no-project-ignore instead.--no-environment is deprecated.--clear=reset will reset the screen on graceful shutdown. (#797)--no-process-group is deprecated.WATCHEXEC_FILTERER environment variable.--wrap-process=MODE lets you choose between using process groups, process sessions, or nothing at all. (#794)WATCHEXEC_TMPDIR environment variable can be used to customize where Watchexec will write temporary files, if for some reason your $TMPDIR is unwritable. (#814)As a treat, this release also features an experimental new option: -j or --filter-prog, which lets you write filter programs.
-j, --filter-prog EXPRESSIONProvide your own custom filter programs in jaq (similar to jq) syntax. Programs are given an event in the same format as described in --emit-events-to and must return a boolean. In addition to the jaq stdlib, watchexec adds some custom filter definitions:
path | file_meta returns file metadata or null if the file does not exist.path | file_size returns the size of the file at path, or null if it does not exist.path | file_read(bytes) returns a string with the first n bytes of the file at path. If the file is smaller than n bytes, the whole file is returned. There is no filter to read the whole file at once to encourage limiting the amount of data read and processed.string | hash, and path | file_hash return the hash of the string or file at path. No guarantee is made about the algorithm used: treat it as an opaque value.any | kv_store(key), kv_fetch(key), and kv_clear provide a simple key-value store. Data is kept in memory only, there is no persistence. Consistency is not guaranteed.any | printout, any | printerr, and any | log(level) will print or log any given value to stdout, stderr, or the log (levels = error, warn, info, debug, trace), and pass the value through (so [1] | log("debug") | .[] will produce a 1 and log [1]).All filtering done with such programs, and especially those using kv or filesystem access, is much slower than the other filtering methods. If filtering is too slow, events will back up and stall watchexec. Take care when designing your filters.
If the argument to this option starts with an '@', the rest of the argument is taken to be the path to a file containing a jaq program.
Jaq programs are run in order, after all other filters, and short-circuit: if a filter (jaq or not) rejects an event, execution stops there, and no other filters are run. Additionally, they stop after outputting the first value, so you'll want to use 'any' or 'all' when iterating, otherwise only the first item will be processed, which can be quite confusing!
Regexp ignore filter on paths:
all(.tags[] | select(.kind == "path"); .absolute | test("[.]test[.]js$")) | not
Pass any event that creates a file:
any(.tags[] | select(.kind == "fs"); .simple == "create")
Pass events that touch executable files:
any(.tags[] | select(.kind == "path" && .filetype == "file"); .absolute | metadata | .executable)
Ignore files that start with shebangs:
any(.tags[] | select(.kind == "path" && .filetype == "file"); .absolute | read(2) == "#!") | not
More examples can be found and contributed in the discussion thread
Deps: upgrade to gix-config 0.31.0
Use Tokio's canonicalize instead of dunce::simplified.
Automatically deployed release
Automatically deployed release
Search for .gitignore files in parent dirs
--run-initially flag.gitignore files in parent dirs$WATCHEXEC_UPDATED_PATH to the first updated path--force-poll optionfrom_environment() no longer looks at WATCHEXEC_IGNORE_FILES.Add missing Send bound to async functions.
Send bound to async functions.Deps: update git-config to 0.7.1
Initial release as a separate crate.
One column per quarter.