> ## Documentation Index
> Fetch the complete documentation index at: https://hyperbrowser.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Understand the sandbox local filesystem surface and the operations available on it

This section covers the sandbox local filesystem: the files and directories inside a running sandbox.

Use it to:

* Inspect paths and metadata.
* Read and write text or bytes.
* Move, copy, and remove files.
* Watch for file system changes.
* Upload, download, and generate presigned transfer URLs.

<Note>
  This section is about the sandbox's local filesystem. Persistent volumes are a
  separate surface and are documented in [Volumes](/sandboxes/volumes).
</Note>

## Quick Start

<CodeGroup>
  ```typescript Node.js theme={null}
  await sandbox.files.writeText("/tmp/hello.txt", "hello from sandbox");

  const text = await sandbox.files.readText("/tmp/hello.txt");
  console.log(text);
  ```

  ```python Python theme={null}
  sandbox.files.write_text("/tmp/hello.txt", "hello from sandbox")

  text = sandbox.files.read_text("/tmp/hello.txt")
  print(text)
  ```

  ```bash CLI theme={null}
  hx file write <sandbox-id> /tmp/hello.txt --data 'hello from sandbox'
  hx file cat <sandbox-id> /tmp/hello.txt
  ```
</CodeGroup>