{"name":"Edit","slug":"edit","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.293","anchor":"claude-test-permission-rules-reworked-claudemdclaude-edi","heading":"claude-test plugin's built-in edit permission rules reworked","line":"The claude-test plugin drops its explicit edit rules for CLAUDE.md, .claude and .mcp.json and adds rules for .claude-test files","released_at":"2026-10-07 17:18:04","reason":"found in this entry's text"},{"version":"2.1.285","anchor":"tools-handling-extracted-into-a-helper","heading":"Handling of the --tools flag reorganized, with the same warnings","line":"The code that reads `--tools` and warns about unknown tool names was moved into one place; the warning text is unchanged","released_at":"2026-09-29 17:32:09","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.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":"edit-tools-uxxxx-escape-text-search-hardened-with-a-length","heading":"Edit tool's \\uXXXX-escape text search hardened with a length guard and clearer failure","line":"Edit tool's handling of \\uXXXX text in search strings is hardened with a size check and clearer error","released_at":"2026-09-18 16:22:26","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"},{"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":"managed-settings-denyask-rules-starting-with-are-now-re","heading":"Managed-settings deny\/ask rules starting with '!' are now rejected with a warning","line":"Managed-settings deny\/ask rules starting with '!' are now dropped with a warning instead of applied","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"}],"entries_total":23,"docs":[{"source":"api","path":"about-claude\/api-credits-for-subscribers","title":"api-credits-for-subscribers","documented":false},{"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\/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},{"source":"api","path":"agents-and-tools\/agent-skills\/claude-api-skill","title":"claude-api-skill","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/enterprise","title":"enterprise","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/tool\/edit","family_url":"https:\/\/changelogs.core-directive.com\/reference\/tool.json"}