Guides

Cloud drives

Store, stream, cache, and share regular files from the Parlo filesystem.

Parlo drives are cloud-backed folders mounted next to your API connections.

bash4 lines
1~/parlo/2  main/3  github/4  linear/

Use drives for normal files: PDFs, videos, screenshots, datasets, exported reports, generated artifacts, and agent working files.

bash3 lines
1cp report.pdf ~/parlo/main/reports/2vim ~/parlo/main/notes/ideas.md3open ~/parlo/main/videos/demo.mp4

Streaming files

Large files can be listed quickly and read in chunks. Video players, PDF viewers, and scripts request the bytes they need as they go.

bash1 line
1open ~/parlo/main/videos/demo.mp4

Local cache

Parlo caches chunks locally so repeat reads do not need to re-download the same bytes.

bash2 lines
1parlo cache status2parlo pin ~/parlo/main/videos/demo.mp4

Pinning is useful for files you know you will reuse on a machine.

Write-through uploads

Saving or copying into a drive uploads to Parlo Cloud.

bash2 lines
1printf "release notes\n" > ~/parlo/main/notes/release.md2cp ./dataset.csv ~/parlo/main/data/dataset.csv

Create a public link for a file:

bash1 line
1parlo share ~/parlo/main/reports/report.pdf

Why drives live beside APIs

Many tasks need structured systems and raw files together: read a ticket, generate an export, save it to a drive, share it, and let another agent or teammate continue from the same folder.