[DOCS] Glob tool docs omit working-directory null-byte errors

Open 💬 0 comments Opened Jul 15, 2026 by coygeek

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/tools-reference

Section/Topic

The "Glob tool behavior" section, specifically the handling of null bytes in Glob inputs.

Current Documentation

The section currently says:

A pattern or path value that contains a null byte returns an error asking Claude to remove it.

What's Wrong or Missing?

The documentation lists only pattern and path as inputs that can contain a null byte. Claude Code v2.1.208 also fixed Glob crashing with an unclear error when the working directory contained a null byte. The current wording does not tell users that the working-directory input is covered by the same validation, nor what clear error they should expect in that case.

This leaves the documented error contract incomplete for a malformed Glob invocation. A user troubleshooting the working-directory case cannot tell whether the failure is expected input validation, a filesystem problem, or an application crash.

Suggested Improvement

Update the null-byte sentence to name all affected inputs and describe the resulting diagnostic, for example:

A pattern, path, or working-directory value that contains a null byte returns a clear error asking Claude to remove it. Claude Code v2.1.208 or later validates these inputs instead of crashing with an unclear error.

If the working directory is not a direct user-settable Glob parameter, explain which resolved working-directory value is validated and how users should correct it.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/tools-reference | 151-163 | Glob inputs, result behavior, and null-byte error handling |

Total scope: 1 page affected

The missing case was fixed in Claude Code v2.1.208. The documentation already covers null bytes in pattern and path; this report is limited to the omitted working-directory case.

View original on GitHub ↗