{"name":"NotebookEdit","slug":"notebookedit","family":"tool","title":"Tools","noun":"tool","description":"Notebooks over 100 MB are refused for reads and edits, with a suggestion to slice them.","description_source":"entry","described_by":{"version":"2.1.227","anchor":"notebook-reads-and-edits-now-refuse-files-over-100-mb"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.309","builds":150,"mined_builds":150,"first_cited":{"version":"2.1.265","released_at":"2026-09-08 19:05:16","spans":2}},"aliases":[],"entries":[{"version":"2.1.300","anchor":"edit-and-notebookedit-validate-the-path-with-a-new-extra-che","heading":"File and notebook edits run an extra check on the file path","line":"The Edit and NotebookEdit tools now run an extra check on the file path first, so some paths that passed before may be refused","released_at":"2026-10-14 14:27:26","reason":"found in this entry's text"},{"version":"2.1.299","anchor":"notebook-edit-refuses-non-text-files","heading":"NotebookEdit now checks whether a notebook is text before editing","line":"NotebookEdit now refuses a notebook it reads as not being text, using a new check in place of the earlier decoding check","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text"},{"version":"2.1.296","anchor":"non-utf-8-files-are-refused-by-notebookedit-instead-of-being","heading":"NotebookEdit refuses notebooks that are not UTF-8 instead of quietly rewriting them","line":"NotebookEdit now refuses to edit a notebook that is not valid UTF-8 and leaves the file untouched","released_at":"2026-10-09 16:58:10","reason":"found in this entry's text"},{"version":"2.1.295","anchor":"notebook-and-file-read-state-tracking-tweaks","heading":"Notebook and file edits check content instead of timestamps","line":"NotebookEdit and file writes now compare what Claude last saw with the file itself, instead of comparing timestamps","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.288","anchor":"edit-write-and-notebookedit-reject-paths-ending-in-white-sp","heading":"File tools refuse paths that end in a space","line":"Read, Edit, Write and NotebookEdit now refuse a file path that ends in white space once `.` and `..` are worked out","released_at":"2026-10-02 18:30:40","reason":"found in this entry's text"},{"version":"2.1.284","anchor":"read-tool-results-can-be-returned-from-another-process-or-ma","heading":"Read tool results can come back from another process or machine","line":"The Read and NotebookEdit tools can now accept results produced by another process, and tools aimed at an unknown machine or another session are refused","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"file-tools-add-a-new-early-validation-step","heading":"File tools add a new early validation step","line":"Read, Edit, Write and NotebookEdit now run a shared check on the file path before any of their other input checks","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"notebookedit-network-path-message-softened","heading":"NotebookEdit network-path message softened","line":"NotebookEdit's refusal message now says the notebook \"may be\" on a network path instead of stating it as fact","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"editnotebookedit-checkpermissions-runs-an-extra-path-check","heading":"Edit\/NotebookEdit checkPermissions runs an extra path check after the base decision","line":"Edit and NotebookEdit permission checks now run an extra path check that can override an allow or ask decision","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.277","anchor":"per-tool-backgrounding-classification-rolled-out-across-ne","heading":"Per-tool 'backgrounding' classification rolled out across nearly all built-in tools","line":"Nearly every built-in tool now carries a 'backgrounding' classification of never, self, or detach","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"}],"entries_total":22,"docs":[{"source":"api","path":"api\/beta\/organization\/analytics","title":"Analytics","documented":false},{"source":"api","path":"api\/beta\/organization\/analytics\/users","title":"Users","documented":false},{"source":"api","path":"api\/beta\/organization\/analytics\/users\/list","title":"List User Activity","documented":false},{"source":"api","path":"manage-claude\/claude-code-analytics-api","title":"First request","documented":false},{"source":"claude-code","path":"agent-sdk\/file-checkpointing","title":"Rewind file changes with checkpointing","documented":false},{"source":"claude-code","path":"agent-sdk\/hooks","title":"Intercept and control agent behavior with hooks","documented":false},{"source":"claude-code","path":"agent-sdk\/permissions","title":"Configure permissions","documented":false},{"source":"claude-code","path":"agent-sdk\/python","title":"Agent SDK reference - Python","documented":false},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"agent-view","title":"Manage multiple agents with agent view","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/tool\/notebookedit","family_url":"https:\/\/changelogs.core-directive.com\/reference\/tool.json"}