{"name":"Write","slug":"write","family":"tool","title":"Tools","noun":"tool","description":"Edit, Write and NotebookEdit approval previews withhold the diff when the change is too large or the file can't be read","description_source":"entry","described_by":{"version":"2.1.235","anchor":"editwritenotebookedit-approval-previews-are-withheld-when"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":null},"aliases":[],"entries":[{"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.275","anchor":"editwrite-tools-now-report-a-syncedskillnext-field","heading":"Edit\/Write tools now report a syncedSkillNext field","line":"Edit and Write tool results now include a syncedSkillNext field when relevant","released_at":"2026-09-17 20:20:31","reason":"found in this entry's text"},{"version":"2.1.273","anchor":"bridge-child-sessions-now-default-to-computing-tool-use-diff","heading":"Bridge child sessions now default to computing tool-use diffs","line":"Bridge-hosted child sessions now default to computing a git diff for Write and Edit tool calls","released_at":"2026-09-15 18:06:34","reason":"found in this entry's text"},{"version":"2.1.269","anchor":"auto-denial-telemetry-event-now-excludes-path-scoped-deny-ru","heading":"Auto-denial telemetry event now excludes path-scoped deny-rule refusals of file tools","line":"Auto-denial telemetry no longer counts Read\/Edit\/Write calls blocked by a path-scoped deny rule","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"},{"version":"2.1.269","anchor":"new-staged-outcome-for-editwrite-tool-results-machine-ow","heading":"New 'staged' outcome for Edit\/Write tool results (machine-owner review hold)","line":"Edit and Write tool results can now report a change as 'staged' for owner review instead of applied","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"editwritenotebookedit-style-tools-refactored-to-a-per-sess","heading":"Edit\/Write\/NotebookEdit-style tools refactored to a per-session create() factory","line":"Edit, Write, and Read\/PDF tools were refactored internally to build themselves from a per-session factory function","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.257","anchor":"init-frame-schema-gains-host-and-serving-fields-for-loca","heading":"Init frame schema gains 'host' and 'serving' fields for local tool serving to cloud sessions","line":"The init frame can announce the local machine and whether it serves Bash, Read, Write and Edit calls to a cloud session.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text"},{"version":"2.1.257","anchor":"tool-dispatch-can-emit-a-tooloutput-telemetry-event-with","heading":"Tool dispatch can emit a 'tool.output' telemetry event with file contents\/diffs\/commands","line":"A tool.output telemetry event can carry file contents, diffs and bash commands after a successful tool call, behind a gate.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text"},{"version":"2.1.235","anchor":"editwritenotebookedit-approval-previews-are-withheld-when","heading":"Edit\/Write\/NotebookEdit approval previews are withheld when the change is too large or the file cannot be read","line":"Edit, Write and NotebookEdit approval previews withhold the diff when the change is too large or the file can't be read","released_at":"2026-08-18 18:24:10","reason":"found in this entry's text"},{"version":"2.1.207","anchor":"walnut-spire-plugin-eval-general-availability-in-development","heading":"Walnut Spire ( plugin eval General Availability) [In Development]","line":null,"released_at":"2026-07-10 22:25:09","reason":"found in this entry's text"}],"entries_total":11,"docs":[{"source":"api","path":"about-claude\/models\/migration-guide","title":"Or, for the model with the same capabilities and no access approval requirement:","documented":false},{"source":"api","path":"about-claude\/models\/optimizing-for-cost-and-intelligence","title":"optimizing-for-cost-and-intelligence","documented":false},{"source":"api","path":"about-claude\/pricing","title":"pricing","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/commerce-agents","title":"commerce-agents","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/content-moderation","title":"content-moderation","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/customer-support-chat","title":"customer-support-chat","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/legal-summarization","title":"legal-summarization","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/overview","title":"overview","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/ticket-routing","title":"ticket-routing","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/best-practices","title":"PDF Processing","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/tool\/write","family_url":"https:\/\/changelogs.core-directive.com\/reference\/tool.json"}