> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://platform.bctrl.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://platform.bctrl.ai/_mcp/server.

# List Runtime files

> List immediate children in the bounded Runtime workspace.

List files, directories, and symlinks in a live Runtime workspace. Paths are
relative to the workspace root; absolute paths and `..` segments are not
allowed.

## List workspace entries

```ts
const result = await bctrl.tools.call("runtime.files.list", {
  path: "reports",
  limit: 100,
}, { runtimeId: runtime.id });

for (const entry of result.entries) {
  console.log(entry.kind, entry.path, entry.size);
}
```

The Runtime must be active. Omit `path` to list the workspace root.

## Request parameters

| Parameter | Type      | Required | Description                                                   |
| --------- | --------- | -------- | ------------------------------------------------------------- |
| `path`    | `string`  | No       | Workspace-relative directory. Defaults to the workspace root. |
| `cursor`  | `string`  | No       | Cursor returned by the previous page.                         |
| `limit`   | `integer` | No       | Results per page. Defaults to `100`; maximum `500`.           |

## Response

| Field                  | Type                                 | Always present | Description                                        |
| ---------------------- | ------------------------------------ | -------------- | -------------------------------------------------- |
| `entries[].path`       | `string`                             | Yes            | Workspace-relative entry path.                     |
| `entries[].kind`       | `"file" \| "directory" \| "symlink"` | Yes            | Entry type.                                        |
| `entries[].size`       | `number \| null`                     | Yes            | Size in bytes for a file, when available.          |
| `entries[].modifiedAt` | `string \| null`                     | Yes            | Last modification time, when available.            |
| `nextCursor`           | `string \| null`                     | Yes            | Cursor for the next page, or `null` when complete. |

## Next

* [Stage Runtime file](/sdk/tools/runtime/runtime-files-stage) — copy a durable File in
* [Collect Runtime file](/sdk/tools/runtime/runtime-files-collect) — save workspace output
* [Files](/sdk/files) — manage durable storage