Enkaidu

Wed, 16 Sep 2026 13:45:19 -0400

Text Line-based Editing Toolset Documentation

This toolset provides tools for editing text-based files within the current directory using line-based operations to replace and insert text.

When using this toolset make sure to instruct the AI model to read text files with line numbers included.

`str_insert_in_text_file`

Insert text at a specific line-number location in a text file within the current directory.

Parameters

Parameter	Type	Required	Description
`file_path`	String	Yes	The relative path to the text file to modify.
`insert_line`	Integer	Yes	The line number after which to insert the text (0 for beginning of file, -1 to append at the end)
`insert_text`	String	Yes	The text to insert

Notes

Ensures the file is within the current directory and is a text file.
Returns the modified contents of the file.

`str_replace_lines_in_text_file`

Replace a range of lines in a text file with given text. Ensures the file is within the current directory and is a text file.

Fri, 04 Sep 2026 17:10:24 -0400

File Management Toolset

Generated byAI

`create_directory`

Creates a new directory at the specified relative path. The operation is restricted to remain inside the current working directory.

Parameters

Parameter	Type	Required	Description
`directory_path`	String	Yes	The relative path of the directory to create.

Notes

The tool ensures the directory is created within the current working directory.
It supports creating nested directories using Dir.mkdir_p.

`delete_file`

Deletes a specified file by moving it to a .deleted_files/ folder with a ms-resolution timestamp prepended to the filename. This allows for file recovery if deletion was accidental.

Fri, 04 Sep 2026 17:10:24 -0400

Text Editing Toolset Documentation

Generated byAI

This toolset provides tools for reading, creating, and modifying text-based files within the current directory.

`read_text_file`

Read the contents of a text file within the current directory. Read the entire file or a specific range of lines.

Parameters

Parameter	Type	Required	Description
`file_path`	String	Yes	The relative path to the text file to read.
`include_line_numbers`	Boolean	No	If true, prepends 1-indexed line numbers like `cat -n`. Defaults to false.
`line_range`	Array	Yes	An array of two integers specifying the start and end line numbers to view. Line numbers are 1-indexed, and -1 for the end line means read to the end of the file.

Notes

Ensures the file is within the current directory and is not a binary file.
Supports plain text, code files, markdown, and other text-based formats.

`str_replace_in_text_file`

Searches for the specified text in a text-based file and replaces it with alternative text. Ensures the file is within the current directory and is a text file.

Wed, 26 Aug 2026 21:18:36 -0400

Audio Editing Toolset

Generated byAI

This toolset provides tools for reading and creating audio files within the current directory.

`read_audio_file`

Reads the content of a specified audio file in the current directory and returns it as a base64 encoded data URL string.

Parameters

Parameter	Type	Required	Description
`file_path`	String	Yes	The relative path to the audio file to read.

Notes

Supported audio formats are WV and MP3
The tool ensures the file is within the current directory and is a valid audio file.

`write_audio_file`

Writes an audio file from base64 encoded audio data at the specified path. Ensures the file is created within the current directory and does not overwrite existing files unless requested.

Wed, 26 Aug 2026 21:18:36 -0400

Date and Time Toolset

Generated byAI

`get_current_datetime`

Returns both the local date/time and a separate ISO-8601 UTC value.

Parameters

This tool does not require any parameters.

Notes

The returned ISO 8601 format value includes the date (YYYY-MM-DD), time (HH:MM:SS), and timezone offset (+00:00 for UTC).
The datetime is generated at the moment the tool is executed, ensuring real-time accuracy.

Wed, 26 Aug 2026 21:18:36 -0400

Experimental Toolset Documentation

Generated byAI

Caution: This toolset contains experimental tools that may undergo significant changes or be removed in future updates. Use with caution and ensure you have backups of your data.

`apply_patch_to_text_file`

Applies a patch using the diff format to a specified text file using the patch command.

Parameters

Parameter	Type	Required	Description
`file_path`	String	Yes	The relative path to the file to be patched.
`patch_content`	String	Yes	The content of the patch to apply.

Notes

The tool uses the patch command with the --no-backup-if-mismatch flag.
It ensures the file is within the current directory and is a valid text file.

`regex_text_edit_tool`

Finds patterns using a regex in a text-based file and replaces them with new text.

Wed, 26 Aug 2026 21:18:36 -0400

Image Editing Toolset

Generated byAI

This toolset provides tools for reading and creating image files within the current directory.

`read_image_file`

Reads the content of a specified image file in the current directory and returns it as a base64 encoded data URL string.

Parameters

Parameter	Type	Required	Description
`file_path`	String	Yes	The relative path to the image file to read.

Notes

Supported image formats are PNG and JPEG.
The tool ensures the file is within the current directory and is a valid image file.

`write_image_file`

Writes an image file from base64 encoded image data at the specified path. Ensures the file is created within the current directory and does not overwrite existing files unless requested.

Wed, 26 Aug 2026 21:18:36 -0400

Web Toolset Documentation

Generated byAI

This toolset provides tools for making HTTP GET requests to retrieve web content.

`http_get_web_page`

Makes an HTTP GET request to a given URL that returns text and returns the content type and content. It strips line indents and coalesces line breaks for HTML, JSON, and XML. Unless asked not to, it removes the head, script, and style elements as well as all class attributes from HTML content. Content size of response must be less than 256K.