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.