sandbox ls

List the files and directories inside an app’s sandbox, the cloud environment that holds the app’s code. This reads the remote sandbox, not your local files. Every path is relative to the app root. sandbox commands don’t require a local project. Target an app by passing --app-id, setting the BASE44_APP_ID environment variable, or running the command from a linked project if you have one.

Usage

base44 sandbox ls [path]

Arguments

Argument	Description	Required
`path`	Directory to list, relative to the app root. Defaults to the app root.	No

Flags

Flag	Description
`--app-id <id>`	Target the specified app. Defaults to the app linked in the current project. See Select a target app.
`--recursive`	List nested entries.
`--max-depth <n>`	Maximum depth to descend when `--recursive` is set, between `1` and `10`. Defaults to `3`.
`--include-hidden`	Include dotfiles.
`--json`	Keep stdout to just the JSON result, without the interactive status line. See JSON output.

Output

The command returns JSON:

{
  "entries": [
    { "name": "pages", "path": "src/pages", "type": "directory" },
    { "name": "Home.jsx", "path": "src/pages/Home.jsx", "type": "file", "size": 1284 }
  ],
  "truncated": false
}

Each entry in entries has:

Field	Description
`name`	The entry’s own name, the last segment of its path.
`path`	The entry’s full path, relative to the app root. Matches `name` only for a top-level, non-recursive listing; a nested entry’s `path` carries the directory prefix that `name` leaves out.
`type`	Either `file` or `directory`.
`size`	Size in bytes. Present on files only.

The response itself also carries:

Field	Description
`truncated`	`true` when the listing hit the limit of 1000 entries and was cut short.

Example

List the src directory two levels deep:

base44 sandbox ls src --recursive --max-depth 2

Get Started

Commands

Usage

Arguments

Flags

Output

Example

See also

​Usage

​Arguments

​Flags

​Output

​Example

​See also

Usage

Arguments

Flags

Output

Example

See also