Edit

Lets your agent make surgical, in-place changes to a text file by replacing an exact, unique string (old_str must appear in the file exactly once).

The edit tool pairs with the read and write vended tools and supersedes file_editor.

Security Warning

This tool writes files at arbitrary absolute paths with the full permissions of the process. Only use with trusted input and consider running in a sandboxed environment for production.

Example:

Python

from strands import Agent
from strands.vended_tools import edit

agent = Agent(tools=[edit])
agent("In /tmp/hello.txt, replace 'world' with 'Strands'.")

TypeScript

import { Agent } from '@strands-agents/sdk'
import { edit } from '@strands-agents/sdk/vended-tools/edit'

const agent = new Agent({
  tools: [edit],
})

await agent.invoke("In /tmp/hello.txt, replace 'world' with 'Strands'.")

Tags

tool-authoring26