File editor

Deprecated

file_editor / fileEditor is deprecated in favor of the focused edit, read, and write tools. It will be removed in a future release. Calling make_file_editor emits a DeprecationWarning in Python; makeFileEditor and fileEditor are marked @deprecated in TypeScript. Docker and SSH sandboxes still vend file_editor as sandbox_file_editor for continuity.

Lets your agent read and modify files on disk: useful for coding agents, config management, or any workflow where the agent inspects output and makes targeted edits.

Security Warning

This tool reads and 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:

TypeScript

import { Agent } from '@strands-agents/sdk'
import { fileEditor } from '@strands-agents/sdk/vended-tools/file-editor'

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

// Create, view, and edit files
await agent.invoke('Create a file /tmp/config.json with {"debug": false}')
await agent.invoke('Replace "debug": false with "debug": true in /tmp/config.json')
await agent.invoke('View lines 1-10 of /tmp/config.json')

Python

from strands import Agent
from strands.vended_tools import file_editor

agent = Agent(tools=[file_editor])
agent("Create a file at /tmp/hello.txt with the contents 'Hello, world!'")

Full API reference

Tags

tool-authoring26