X02 CLI

Official command-line interface for the X02 file hosting platform.

Installation

npm install -g x02-cli

For local development:

cd cli
npm install
npm link

Quick Start

x02 login
x02 upload screenshot.png
x02 upload screenshot.png report.pdf notes.txt
x02 upload --url https://example.com/photo.jpg
x02 list
x02 info screenshot.png

If you are already logged in and want to switch accounts:

x02 logout
x02 login

Or replace the saved key directly:

x02 login --replace --key YOUR_API_KEY

Commands

Authentication

x02 login
x02 login --key YOUR_API_KEY
x02 login --replace --key YOUR_API_KEY
x02 logout
x02 status

File Operations

x02 upload file.png
x02 upload file1.png file2.jpg file3.pdf
x02 upload file.png --expiry 1d --copy
x02 upload file1.png file2.jpg --dry-run
x02 upload --url https://example.com/photo.jpg
x02 upload --url https://example.com/photo.jpg --expiry 1d --copy
x02 list
x02 list --json
x02 info file.png
x02 delete file.png --force

Bulk upload is supported by passing multiple files to x02 upload. You can also upload images from remote URLs using the --url option.

Folder Operations

x02 folder list
x02 folder create Screenshots
x02 folder delete Screenshots
x02 folder move file.png Screenshots
x02 folder move file.png --root

Configuration

x02 config
x02 config get baseUrl
x02 config set baseUrl https://x02.me
x02 config set autoCopy true
x02 config delete defaultFolder

Supported config keys:

• apiKey
• baseUrl
• autoCopy
• verbose
• defaultFolder

Environment Overrides

Environment variables take precedence over stored config:

X02_API_KEY=your-key
X02_BASE_URL=https://x02.me
X02_AUTO_COPY=true
X02_VERBOSE=true
X02_DEFAULT_FOLDER=Screenshots

Behavior Notes

• Configuration is stored in ~/.x02/config.json.
• upload --dry-run and delete --dry-run validate input without making API changes.
• Bulk upload is supported: x02 upload file1.png file2.jpg file3.pdf
• URL upload is supported: x02 upload --url https://example.com/photo.jpg
• Auth-protected commands fail with exit code 1 when no API key is configured.
• Running x02 login while already logged in gives guidance instead of overwriting the saved account.
• npm start prints CLI help and exits successfully.

Development

cd cli
npm test
node bin/x02.js --help

Requirements

• Node.js >=18

Support

• Website: https://x02.me
• API Docs: https://x02.me/api-docs