Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.277 ·

Filesystem bridge gains network-location checks, ancestor search bounds, and read/stat options

The plugin/hook filesystem bridge can now reject remote paths, bound ancestor searches, read raw bytes, and report symlink info

TierUnder the hoodhow much it should matter to you
Useful2my rating, 1 to 5
Signal2worth watching, 1 to 5
AreaPlugin Hookswhat it touches
KindInternal Changesin v2.1.277,
Group of 5 Under the hood

The plugin/hook filesystem bridge can now reject remote paths, bound ancestor searches, read raw bytes, and report symlink info

What

  • Skill/tool file-path arguments now reject a "network location not reached from here" (for example a different git remote or host than the current worktree), checked on both the existing path parameter and a new below parameter.
  • The ancestor CLAUDE.md/memory-file search now skips remote workspaces, returning early with a log message, and accepts an optional below boundary so the upward directory walk stops once it would go above that path.
  • The plugin/hook filesystem bridge's read and stat calls now accept an options object: as for read encoding (defaulting to "text") and resolve for stat (defaulting to false); ancestors also gained the below bound.
  • $.fs.read can now return raw bytes as base64 when as: 'bytes' is requested, instead of always decoding the content as UTF-8 text.
  • fs.stat responses now include isLink (whether the entry is a symbolic link) and, when resolve is set and the link target stays within the allowed paths, a realPath field; list responses also now include isLink per entry.

Why

These changes make the filesystem APIs available to plugins and hooks safer, by blocking paths outside the reachable network location, and more capable, by supporting bounded ancestor searches, raw byte reads, and symlink awareness, which matters for plugins that need to work with binary files or symlinks correctly.

See this entry in the whole of v2.1.277 →

Feedback