# list_files

Source: https://modulify.ai/docs/mcp/code/list-files

Lists the source files of a site with their sizes.

- Title: List the source files of a site
- Scope: `code:read`
- Access: Read only

The files come from the preview branch of the site repository, not from the container the preview runs in, and that branch is only as fresh as the last sync. Straight after a generation you can see a file the agent has already replaced, or miss one it has just written.

Pass `path` to narrow the list to one folder. At most 2,000 entries come back, each with its `path` and `size`, while `total` reports how many matched, so `truncated:true` means you are seeing only part of the list and should narrow the path.

If the site repository cannot be read at that moment, the call fails with `Could not read your code from GitHub. Please try again in a moment!` instead of returning an empty list, so retry shortly rather than treating the site as empty. A site with no code yet answers `There is no code for this site yet!`

To change code, use `write_file` when you know exactly what the new file should contain, or describe the change to `send_message` and let the site agent edit it when the change depends on the surrounding code. See [Files and code](https://modulify.ai/docs/editor/files-and-code).

## Inputs

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `projectId` | string | Yes | The site id. |
| `path` | string | No | Only list the files inside this folder, for example `app/` or `components/`. Folder names match whole, so `comp` does not match `components/`, and leading and trailing slashes are ignored. Leave it out to list the whole site. |