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

# Drive

> Upload, download, list, and share files in your MuleRun Drive (Barn)

`mulerun drive` is the CLI for **Drive** (also known internally as Barn) —
your cloud storage on MuleRun.

This page is a quick overview. Detailed per-subcommand pages are coming
soon.

## File operations

```bash theme={null}
mulerun drive ls /path/to/dir            # list directory
mulerun drive stat /path/to/file         # file info + presigned download URL
mulerun drive mkdir /new/directory       # create directory
mulerun drive upload local.txt /remote/path/file.txt
mulerun drive cp /from/path /to/path     # server-side copy
mulerun drive rm /path/to/file
mulerun drive rm -r /path/to/dir         # recursive
mulerun drive search "query"             # full-text search
```

## Sharing

```bash theme={null}
# Time-limited share links
mulerun drive share list
mulerun drive share create /path/to/file --expires 2026-12-31T00:00:00Z
mulerun drive share create /path/to/file --expires 2026-12-31T00:00:00Z --password "secret"
mulerun drive share get    <share-id>
mulerun drive share access <share-id> --password "secret"
mulerun drive share delete <share-id>
```

## Public files

```bash theme={null}
# Mark a file as world-readable
mulerun drive public list
mulerun drive public set    /path/to/asset.png
mulerun drive public get    /path/to/asset.png --preview
mulerun drive public delete /path/to/asset.png
```

## Tips

* `drive stat` returns a presigned download URL — pipe it to `curl` for a
  one-shot download.
* `drive upload` streams the file directly; no need for an intermediate
  local copy.
* Share links require an explicit `--expires`; there is no "never expires"
  default by design.