File Operations

`read_file`

Read the contents of a file at a given path.

Permission: Read

Name	Type	Required	Description
`path`	string	yes	The file path to read
`offset`	integer	no	Line number to start reading from (0-based)
`limit`	integer	no	Maximum number of lines to read

Read an entire file:

agsh [r] > show me the contents of src/main.rs

Read lines 10-20:

agsh [r] > show me lines 10 through 20 of src/main.rs

The agent will call read_file with offset: 10 and limit: 10.

Make a string replacement in a file. Replaces the first occurrence of old_string with new_string.

Permission: Write

Name	Type	Required	Description
`path`	string	yes	The file path to edit
`old_string`	string	yes	The exact string to find and replace
`new_string`	string	yes	The replacement string

Reads the file, performs the replacement, and writes it back.
Only the first occurrence of old_string is replaced.
If old_string is not found, the tool returns an error message (without modifying the file).

agsh [w] > change the function name "foo" to "bar" in src/lib.rs

agsh [w] > fix the typo "recieve" to "receive" in README.md

Create or overwrite a file with the given content.

Permission: Write

Name	Type	Required	Description
`path`	string	yes	The file path to write
`content`	string	yes	The content to write to the file

agsh [w] > create a new file called hello.py that prints "hello world"

agsh [w] > write a .gitignore file for a Rust project