File Tools¶

10 tools for file operations.

read_file¶

Read entire file contents.

read_file(path: str) -> str

Example:

> read main.py

Read specific lines from a file.

read_file_chunk(path: str, start_line: int, end_line: int) -> str

Example:

> show lines 10-50 of main.py

Create a new file with content.

create_file(path: str, content: str) -> str

Example:

> create a config.yaml file with default settings

Backup

Creates backup if file exists and is overwritten.

Replace entire file content.

modify_file(path: str, content: str) -> str

Example:

> replace main.py with async version

Backup

Creates backup before modification.

Apply partial changes using find/replace.

patch_file(path: str, find: str, replace: str) -> str

Example:

> change print("hello") to print("world") in main.py

Preferred

Use patch_file instead of modify_file for small changes. It's safer and more precise.

Delete a file.

delete_file(path: str) -> str

Example:

> delete old_config.py

Backup

Creates backup before deletion.

Move or rename a file.

move_file(source: str, destination: str) -> str

Example:

> rename utils.py to helpers.py

Restore file from backup.

restore_backup(path: str, timestamp: str = None) -> str

Example:

> restore main.py from last backup

List available backups for a file.

list_backups(path: str) -> str

Example:

> show backups for config.py

Show differences between current and backup.

show_diff(path: str, timestamp: str = None) -> str

Example:

> show diff for main.py

Output:

- old_function()
+ new_function()
  unchanged_line()