Plugin reference

Files & Repository Tools

Open Settings → Plugins → Installed to inspect and configure the bundled files plugin. In chat, Elowen can use its nine tools to read, search, list, and change files in places the current conversation can access. The plugin has no dedicated page or slash command.

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.

File access and safe edits

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

Read a file before changing it with Write or Edit. The tools also refuse an edit when the file has changed since it was read. A shell command that displays a file does not meet this requirement; use Read.

Write replaces the whole file. Use Edit for a targeted change; it replaces one exact match at a time. A successful read of a large file can be paged, but the read-before-write check covers the complete file.

Enable and configure the plugin

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

Setting	Key	Default	Range	Purpose
Read cap	`readCap`	100,000 bytes	20,000–500,000	Maximum bytes returned by one read.
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 and behavior

Read shows 2,000 lines by default. Use offset and limit to page through a text file.
An unpaginated read is refused if its estimated token cost exceeds 25,000. PDFs up to 10 pages can omit a page range; larger PDFs need one. Use page ranges such as 3, 1-5, or 1,3,5. Scanned pages are returned as images, up to five per call.
Supported images are JPG, PNG, GIF, WebP, and BMP. They are returned as attachments and resized to a 2,000-pixel long edge. Images above about 3.75 MB cannot be embedded.
Write and Edit may change files; the other tools are read-only and can be used in plan mode.
Search and Grep require ripgrep. Search ignores letter case; Grep is case-sensitive unless asked otherwise. Set multiline: true to match across lines. Search skips .git, node_modules, dist, web-dist, .next, and .turbo.
Search has a five-second timeout. Search results and Grep pages are capped by searchMaxMatches; use offset to continue a Grep listing. Match lines are limited to 500 columns. Grep returns at most 200 results by default, and its content mode shows the matching lines.
Glob returns at most 100 files by default and stops after visiting 10,000 files. A managed-project directory listing is limited to 10,000 entries. GitStatus shows at most 120 changed-file entries.
Editing a file larger than 1 GB is refused. Reads of selected device files and file types the plugin cannot display are refused.
PDF support requires Poppler utilities (pdfinfo, pdftotext, and pdftoppm) and has a 30-second limit per call. Scanned pages are rendered as images, with at most five rendered pages per call.

See Plugins for plugin lifecycle and Sandbox & Environments for managed-project file access.