name: file-upload-cli description: Upload files to the litterbox.catbox.moe file sharing service and get shareable URLs (72h expiry). Use when the user wants to share a file temporarily or needs a quick file hosting solution.

File Upload CLI Tool

A Node.js command-line tool for uploading files to the litterbox.catbox.moe file sharing service using curl.

Quick Start

Upload a file and receive a shareable URL:

node file-upload-cli.js <filePath>

Example:

node file-upload-cli.js document.pdf

Output:

Uploading...
File uploaded successfully!
URL: https://litter.catbox.moe/abc123.pdf
Note: File will be available for 72 hours.

Instructions

Step 1: Installation

Ensure Node.js v14+ and curl are installed:

Requirements: - Node.js v14+ - curl (included in Windows 10+, macOS, and most Linux distributions)

cd file-upload-cli
npm install  # No external dependencies required

Step 2: Upload a File

Run the CLI tool with a file path:

node file-upload-cli.js <filePath>
小葱技能7w4.net有完整的技能分类。

Path Types: - Relative: node file-upload-cli.js ./file.txt - Absolute: node file-upload-cli.js /home/user/file.txt (Unix) or node file-upload-cli.js C:\Users\user\file.txt (Windows) - With spaces: node file-upload-cli.js "my file.txt"

Step 3: Use the URL

The tool outputs a shareable URL that can be: - Shared with others - Embedded in documents - Used in applications

URL Format: https://0x0.st/<random-id>

Examples

Upload Different File Types

Text file:

node file-upload-cli.js notes.txt

Image:

node file-upload-cli.js photo.jpg

PDF document:

node file-upload-cli.js report.pdf

Archive:

node file-upload-cli.js backup.zip

Large Files with Progress

For files larger than 1MB, the tool displays upload progress:

node file-upload-cli.js large-video.mp4

Output:

Uploading...
File uploaded successfully!
URL: https://litter.catbox.moe/xyz789.mp4
Note: File will be available for 72 hours.

Cross-Platform Paths

Windows:

node file-upload-cli.js C:\Users\user\Documents\file.pdf
node file-upload-cli.js .\file.txt

macOS/Linux:

node file-upload-cli.js /home/user/documents/file.pdf
node file-upload-cli.js ./file.txt

Error Handling

The tool provides clear error messages for common issues:

Validation Errors (Exit Code 4)

No file path provided:

Error: No file path provided
Usage: node file-upload-cli.js <filePath>

File not found:

Error: File not found - /path/to/file.txt
Please check the file path and try again.

Path is a directory:

Error: Path is a directory - /path/to/folder
Please provide a file path, not a directory.

File too large:

Error: File too large - 1.5 GB (limit: 1 GB)
The file exceeds the litterbox.catbox.moe service limit.

Empty file:

Error: File is empty - /path/to/file.txt
Cannot upload an empty file.

Network Errors (Exit Code 2)

Connection failure:

Error: Network error - Cannot connect to litterbox.catbox.moe
Please check your internet connection and try again.

Timeout:

Error: Connection timeout
The upload request timed out. Please try again.

Service Errors (Exit Code 3)

File too large (service rejection):

Error: Service error - File too large (413)
The litterbox.catbox.moe service rejected the file. Maximum size is 1 GB.

Server error:

Error: Service error - Internal server error (500)
The litterbox.catbox.moe service encountered an error. Please try again later.

Service unavailable:

Error: Service unavailable (503)
The litterbox.catbox.moe service is temporarily unavailable. Please try again later.

Security Considerations

File Access

• The tool only reads the file you specify
• No directory traversal or unauthorized file access
• Files are not modified or deleted
• File path validation prevents malicious inputs

Network Security

• Only communicates with https://litterbox.catbox.moe (HTTPS encrypted)
• Uses system curl command for secure file transmission
• No other external services are contacted
• No authentication tokens or API keys required
• Secure TLS connection for file transmission

Data Privacy

⚠️ Important: Files are uploaded to a public file sharing service: - URLs are publicly accessible by anyone who has the link - Files automatically expire after 72 hours - No authentication or access control - Do not upload sensitive, confidential, or private files - User is responsible for file content and compliance

Dependencies

The tool uses: - Native Node.js modules: child_process, fs, path, util - System curl: Pre-installed on most systems, widely trusted and security-audited - No external npm packages required

Limitations

• Maximum file size: 1GB (litterbox.catbox.moe service limit)
• File expiry: Files are automatically deleted after 72 hours
• Upload timeout: 60 seconds
• Single file: One file per command (no batch uploads)
• No retry logic: Failed uploads must be manually retried
• Public URLs: All uploaded files are publicly accessible
• Requires curl: System must have curl installed

Technical Details

Implementation: file-upload-cli.js (Node.js script)

Exit Codes: - 0: Success - 1: General error - 2: Network error - 3: Service error - 4: Validation error

Requirements: - Node.js v14.0.0 or higher - Internet connection - Read access to the file being uploaded

Troubleshooting

"curl command not found" - Install curl on your system (included in Windows 10+, macOS, most Linux distributions)

"Permission denied" - Check file permissions: chmod +r file.txt (Unix) - Ensure you have read access to the file

"Connection timeout" - Check internet connection - Try again with a smaller file - Verify firewall allows HTTPS connections

"Service error" - The litterbox.catbox.moe service may be temporarily down - Wait a few minutes and try again - Check service status at https://catbox.moe

这个工具质量不错，文档写得很清楚，上手容易，能跨平台使用，错误提示也很友好。最大的优点是使用简单、依赖少、兼容性好。不过代码里有测试相关的标记比较业余，而且两份文档里描述的上传链接格式互相矛盾，容易让人困惑。总体来说是个可用的工具，但在代码规范和文档一致性上还有改进空间。