Watchman is a file watching service that watches files and records when they actually change. It can also trigger actions like rebuilding assets when matching files change.
Project status
- Actively maintained, with an upstream push on 2026-10-28 and updates continuing through 2026-10-26.
- Recent updates have arrived roughly weekly, at least across the listed period.
AI summary generated
Recent updates
v2026.10.26.00
No publisher release notes were provided. The diff mainly updates build dependencies and build-system support, adds Rust and Thrift-Python build options, and changes Watchman tests; several removed C++ return statements also appear to introduce unsafe behavior.
Featuresv2026.10.19.00
No release notes were provided for v2026.10.19.00. The code diff shows mostly build-system and dependency alignment (folly label/path changes, submodule rev bumps, manifest tweaks), plus several meaningful Watchman logic changes (macOS NFS detection, Windows process handle management, fsevents root lifetime handling) and a Thrift IDL extension.
BreakingFeaturesv2026.10.12.00
This release (v2026.10.12.00) contains build system and dependency updates, plus a small Thrift schema extension and Watchman package version bumps. No publisher release notes were provided, so developers need to rely on the code diff to understand behavior changes.
BreakingFeaturesv2026.10.05.00
This release has no published release notes, but the code diff shows several meaningful behavioral and packaging changes across the build system, Watchman telemetry, and Eden service APIs. The most significant change is in Eden thrift definitions where predictive prefetching is effectively removed, plus Watchman packaging changes that remove the watchman-perf binary and adjust bpftool installation behavior.
BreakingFeaturesv2026.09.28.00
No release notes were provided for v2026.09.28.00. The code changes (14 files) primarily update getdeps vendoring metadata, bump multiple vendored dependency revisions, and adjust several build manifest dependencies and packages.
BreakingFeaturesv2026.09.21.00
This release (v2026.09.21.00) appears to be a build system update focused on `build/fbcode_builder/getdeps.py`, adding stronger offline vendoring support and improving platform/distro detection logic. Release notes were not provided, so the change impact must be inferred from the code diff: multiple behavior changes and a new Python minimum version are present.
BreakingSecurityFeaturesv2026.09.14.00
This release contains no publisher-provided release notes. The code diff shows build system and dependency bumps, a Thrift schema change for Eden, and a notable refactor to Watchman telemetry counter logic plus accompanying unit tests.
Featuresv2026.09.07.00
This release (v2026.09.07.00) contains mostly build-system and dependency updates plus a small set of Watchman runtime behavior changes. There are also additions to build manifests (notably Open/R build profiles and a new socket-lb manifest) and some Eden Thrift documentation clarifying the error logging pipeline.
BreakingFeaturesv2026.08.31.00
No publisher release notes were provided for v2026.08.31.00, so changes below are inferred directly from the code diff. The diff includes build system/dependency updates (including multiple third-party subproject revision bumps and getdeps/build manifest changes) and a Linux-specific Watchman change that introduces a binary-replacement monitor which can trigger shutdown via configuration.
Featuresv2026.08.24.00
No release notes were provided for v2026.08.24.00. The diff shows mostly removal of Pyre type-checker pragmas and comments, plus a few meaningful dependency and schema changes.
v2026.08.17.00
This release contains internal build and API schema updates, plus a set of Rust dependency and build-configuration changes for the Watchman CLI. It also extends the Eden Thrift API to expose new hgcache usage state information in prefetch results.
Featuresv2026.08.10.00
This release (v2026.08.10.00) has no publisher release notes. The code diff shows primarily build dependency pin changes and an API contract update in EdenFS Thrift IDL, introducing a new shutdown-related error condition for streaming RPCs.
Featuresv2026.08.03.00
Release v2026.08.03.00 has no publisher-provided release notes. The code diff shows a mix of build-system changes, dependency submodule/commit bumps, Thrift IDL changes for eden/fs, and significant internal telemetry and filesystem watcher modifications.
Featuresv2026.07.27.00
No release notes were provided for v2026.07.27.00. The code diff shows internal refactoring and behavior changes focused on process file descriptor cleanup, plus additions for a new Rust “rage” reporter integration and several dependency revisions.
v2026.07.20.00
This release, v2026.07.20.00, includes major Eden filesystem Thrift IDL extensions for prefetching, adding optional page-cache preload capabilities with stats and progress tracking. In addition, it updates multiple third-party submodule revisions (fb303, fbthrift, folly, mvfst, wangle, edencommon, fizz) and changes Buck build settings for Watchman tests to explicitly allow or deny network access. No release notes were provided, so these changes are not documented by the publisher.
Featuresv2026.07.13.00
This release contains mostly internal build and test changes plus some POSIX-only runtime guarding in Watchman components. There are also multiple upstream subproject commit bumps and a new Linux-only security harness source file for the Watchman Python bser module decoding path. No release notes were provided, so all documented items below are inferred from the code diff.
BreakingSecurityFeaturesv2026.07.06.00
No release notes were provided for v2026.07.06.00, so documented behavior changes cannot be confirmed. The code diff shows build configuration updates (including CI/Xcode path handling), a Thrift schema extension, and updated pinned third-party dependency revisions.
v2026.06.29.00
Release v2026.06.29.00 has no publisher-provided release notes. The code diff mainly updates the build system and dependency manifests, adds a c-ares patch affecting DNS timeout handling, and extends the Eden Thrift IDL with a new optional MountInfo field.
BreakingFeaturesv2026.06.22.00
No publisher release notes were provided for v2026.06.22.00. The code diff mainly updates build and CI configuration (sccache action version), bumps multiple third-party dependency commit hashes, and introduces a Thrift IDL change in eden/fs/service/eden.thrift by adding a new ConflictType enum value.
BreakingFeaturesv2026.06.15.00
No release notes were provided for v2026.06.15.00. The actual diff shows multiple build and dependency changes, including upgrades of several vendored third-party commits, new shared-library build options in several build manifests, a glog CMake visibility patch, an upgrade of patchelf, and a Python package version bump for pywatchman.
BreakingFeatures