olares-files

Manages files across multiple Olares cloud and local storage backends via CLI.

5.2k|320|Updated Apr 29, 2024
One-click install
npx skills add https://github.com/beclab/Olares --skill olares-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: olares-files
Source: https://github.com/beclab/Olares/tree/main/cli/skills/olares-files
Command: npx skills add https://github.com/beclab/Olares --skill olares-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The olares-files skill provides a unified CLI to manage files across all per-user storage backends in Olares, enabling scriptable file operations without logging into the web UI.

Core Features & Use Cases

  • List, upload, download, cat, mkdir, remove, copy, move, rename, and share across drives (Home/Data), Seafile sync libraries, node-local caches, externals, and cloud drives (S3, Google Drive, Dropbox).
  • Support batch operations, resumable uploads, recursive directory transfers, and server-side tasks for cross-volume operations.
  • Use cases include automated backup of local folders to Olares, rapid retrieval of remote files, and bulk management of user data across multiple backends.

Quick Start

Use olares-cli files ls drive/Home/ to inspect the root of the Home drive and confirm access.

Frequently Asked Questions about olares-files

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage per-user files in the Olares backend without using the web UI?

You can manage per-user files in the Olares backend via a unified CLI that covers listing, uploading, downloading, renaming, copying, moving, and sharing across drives, sync libraries, and cloud backends.

Can I upload local folders to Olares drives recursively from the command line?

Yes, you can upload local folders to Olares drives recursively from the command line. The CLI supports batch operations, resumable uploads, and recursive directory transfers across drive/Home and drive/Data.

How does the Olares CLI handle authentication for file operations?

The Olares CLI enforces token-based authentication with automatic refresh for file operations. It uses endpoints like /api/resources, /api/raw, and /api/share to interact with the backend securely.

What file storage backends does the Olares CLI support for cross-volume operations?

The Olares CLI supports cross-volume operations across drive/Home, drive/Data, Seafile sync libraries, node-local caches, externals, and cloud drives including S3, Google Drive, and Dropbox.

Does the Olares CLI support server-side tasks for moving files between volumes?

Yes, the Olares CLI supports server-side tasks for cross-volume operations, allowing you to move or copy files between different drives and sync libraries without downloading them locally first.

Why does the Olares CLI return a 500 error when requesting a file path?

The Olares CLI may return a 500 error on non-trailing-slash file requests due to backend quirks. It also handles directory auto-rename issues to ensure stable file management operations.