Navigation
ELOWEN · Documentation

Last updated: October 27, 2026

Browse documentation · Files overview
Computers, terminal and Git

Files overview

The bundled files plugin lets Chetty read, search, list and change files wherever the current conversation can reach them, and copy or move one file between two Projects.

The ten tools

Tool What it does
Read Reads text, images, PDFs and Jupyter notebooks. Large files can be read in sections.
Write Creates a file or replaces its full contents.
Edit Replaces one exact piece of text in a file.
ListDir Lists one directory.
Search Finds text in file contents, ignoring letter case.
Grep Searches with regular expressions and options such as case sensitivity and context lines.
Glob Finds files by name pattern, newest first.
FileInfo Shows a file or directory's size, type and modified time.
GitStatus Shows the Git branch, repository and a short summary of changed files.
TransferFile Copies or moves one file between two accessible Projects, including a computer.

The plugin has no dedicated page and no slash command.

What the tools can reach

File tools follow the current conversation's Project and path access. In a managed Project the accessible filesystem is the Project's shared environment, and a path outside the allowed boundary is refused.

In a Computer Project the same tools work on that computer's own files, including absolute paths outside the folder its connection runs in, as far as that computer's operating-system account can reach them. If the connection drops, the tool reports the lost connection and never falls back to the server's files; GitStatus is unavailable there and says so.

Reading a file before you change it matters: Write and Edit refuse a change that was not preceded by a read. Read Edit a file and transfer it for the rules.

Turn the plugin on and configure it

The plugin is bundled and enabled in a fresh installation. Administrators can enable or disable it in Settings → Plugins. It is not individually grantable, and its configuration is instance-wide, edited in the plugin's detail view under Settings → Plugins.

Setting Key Default Range Purpose
Read cap readCap 100 kB 20–500 kB Maximum bytes returned by one read. The editor uses decimal kB; saved values remain bytes.
Search max matches searchMaxMatches 200 50–1,000 Results returned by Search, and results on one Grep page.
Glob max results globMax 100 10–500 Files returned by one Glob search.
PDF pages per read pdfMaxPages 20 10–20 Maximum pages requested by one PDF read.

Limits at a glance

  • Read shows 2,000 lines by default; offset and limit page through a text file.
  • Every text page must fit the configured read cap, and an unpaginated read is refused above an estimated 25,000 tokens.
  • Write, Edit and TransferFile may change files, which is why they ask for approval by default. The other tools are read-only and can be used in plan mode.
  • Search has a five-second timeout, and searchMaxMatches caps Search results and each Grep page.
  • Editing a file larger than 1 GB is refused.

Read Read, search and list files for paging, images, PDFs and search limits, and Edit a file and transfer it for changes and copies.

Read, search and list files, Edit a file and transfer it, Attach files and images, Environments overview, Plugins.