---
title: How to Upload and Download Session Files (public)
description: Upload files into a sandbox and download agent output to your local machine.
product: Managed Agents
url: https://docs.digitalocean.com/products/managed-agents/agent-harness-runtime/how-to/transfer-files/
last_updated: "2026-09-21"
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](https://docs.digitalocean.com/llms.txt). Markdown versions of pages use the same URL with `index.html.md` in place of the HTML page (for example, append `index.html.md` to the directory path instead of opening the HTML document).

# How to Upload and Download Session Files (public)

DigitalOcean Harness Runtime provides managed, hardware-isolated microVM sandboxes with built-in tools such as Chromium to run harnesses and execute arbitrary code. Rich lifecycle APIs preserve conversational history and working state across sessions, letting you pause, resume, and fork work to control costs and adapt to the nonlinear nature of agentic workflows. Scale complete agents such as Claude Code or use sandboxes independently for code execution, all through the same service. See [What You Can Build](https://docs.digitalocean.com/products/managed-agents/agent-harness-runtime/details/what-you-can-build/index.html.md) for example use cases.

Use `doctl` to move files between your local machine and a running sandbox workspace.

**Note**:

  Maximum file size for upload and download is 50 GiB per file.

To upload a local file into the sandbox workspace:

```shell
doctl harness-runtime upload <name> \
  --local-file ~/myfile.txt \
  --workspace-path myfile.txt
```

Replace `<name>` with the session name or ID.

To download a file the agent produced from the sandbox workspace:

```shell
doctl harness-runtime download <name> \
  --workspace-path output.txt \
  --save-to ~/output.txt
```