pidrive gives your AI agents a filesystem backed by S3. Install the CLI, mount your drive, and use standard unix commands. No SDK, no API calls — just files.
curl -sSL https://pidrive.ressl.ai/install.sh | bash
This installs the pidrive CLI binary. On Linux it also installs davfs2 for WebDAV mount support. macOS has WebDAV built in.
pidrive register --email agent@company.com --name "My Agent" --server https://pidrive.ressl.ai
Check your email for the verification code:
pidrive verify --email agent@company.com --code 123456
Your API key is saved to ~/.pidrive/credentials.
pidrive mount
This mounts your drive with two folders:
/drive/my/ Your files (read/write) /drive/shared/ Files others shared with you (read-only)
On macOS the path is ~/drive/. Every file you create is stored in S3. Nothing is saved locally.
Use any unix command. They all work:
ls /drive/my/ echo "hello world" > /drive/my/notes.txt cat /drive/my/notes.txt cp report.pdf /drive/my/ mkdir /drive/my/output/ grep -r "error" /drive/my/logs/ head -20 /drive/my/data.csv rm /drive/my/old-file.txt
Shared files are organized by sender:
ls /drive/shared/ cat /drive/shared/alice@company.com/report.txt
pidrive share report.pdf --to other-agent@company.com
The other agent sees your live file in their /shared/ folder. No copies — if you update the file, they see the update.
pidrive share report.pdf --to stranger@company.com
They get an invite email. When they sign up with that email, the shared file appears in their drive automatically.
pidrive share data.csv --link
Returns a public URL like https://pidrive.ressl.ai/s/abc123. Anyone with the link can download the file.
pidrive share data.csv --link --expires 7d
pidrive shared pidrive revoke <share-id>
pidrive pull https://pidrive.ressl.ai/s/abc123 ./local-copy.csv
pidrive search "quarterly revenue"
Full-text search across all your files. Text files are indexed automatically in the background. Supported formats: .txt, .md, .csv, .json, .yaml, .py, .js, .go, .log, and more.
pidrive trash pidrive restore report.txt
Deleted files are kept for 30 days before permanent removal.
pidrive status
Shows mount status, server connection, account info, and storage usage.
pidrive whoami
Shows your email, plan, and storage quota.
pidrive usage
Shows storage used and bandwidth consumed.
pidrive activity
Shows recent events: mounts, shares, revokes, restores.
pidrive plans
| Free | $0/mo | 1 GB storage | 100 MB bandwidth |
| Pro | $5/mo | 100 GB storage | 10 GB bandwidth |
| Team | $20/mo | 1 TB storage | Unlimited bandwidth |
pidrive upgrade --plan pro
pidrive unmount
pidrive register Register a new agent pidrive login Login to existing account pidrive verify Verify email code pidrive whoami Show account info pidrive mount Mount your drive pidrive unmount Unmount your drive pidrive status Show connection status pidrive share Share a file pidrive shared List shares pidrive revoke Revoke a share pidrive pull Download shared file pidrive search Full-text search pidrive activity Recent events pidrive trash List deleted files pidrive restore Restore from trash pidrive usage Storage stats pidrive plans Available plans pidrive upgrade Change plan
No. The mount point (/drive/) is a tunnel to the server. All data lives in S3. If your VM dies, nothing is lost.
Yes. ls, cat, grep, cp, mv, rm, head, tail, wc, find, pipes, redirects — everything works. The mount behaves like a normal directory.
S3 is an API. You need SDKs, presigned URLs, multipart uploads. pidrive is a filesystem. You just echo "data" > /drive/file.txt.
No. Each agent is isolated. Your files are in /my/. Sharing is explicit — shared files appear in /shared/sender@email/. You can share with anyone, even people not yet on pidrive.
It goes to trash. You have 30 days to restore it. After that, it is permanently deleted.
Free plan: 1 GB total storage. Pro: 100 GB. Team: 1 TB. Individual files can be up to your remaining quota.
Yes. Install the CLI, set credentials, mount, read/write files. Works in GitHub Actions, GitLab CI, Docker containers — anywhere Linux runs.