htx-cli

htx-cli is a command-line client for the Disk backend API. It supports:

• SSO-based login by exchanging an authorization code for the backend JWT token
• Listing remote Disk directories
• Uploading a local file into a remote Disk directory
• Uploading a local directory recursively while recreating its folder structure remotely
• Resumable multipart uploads with real remote-part progress

Install

pip install htx-cli

For local development:

pip install -e .

Commands

Print the SSO authorization URL:

htx login --print-url

Interactive login:

htx login

You can also paste the full callback URL directly:

htx login --code 'https://d.6-79.cn/oauth/qtb/callback?code=...'

Show the authenticated user:

htx whoami

List the root directory:

htx ls

List a nested remote directory by path:

htx ls /Photos/2024

List a remote resource directly by resource ID:

htx ls id:Ab12Cd

The shorter @资源ID form works too:

htx ls @Ab12Cd

Upload a local file into a remote directory:

htx upload ./report.pdf /Docs

Upload a local directory recursively. The local directory name is created or reused under the target remote directory:

htx upload ./albums /Photos

Only upload selected extensions:

htx upload ./albums /Photos --include-ext jpg --include-ext png

Exclude specific extensions:

htx upload ./albums /Photos --exclude-ext tmp --exclude-ext log

You can combine both flags. --exclude-ext takes precedence when both match the same file.

Create a directory under the remote root:

htx mkdir Projects

Create a directory under a specific remote folder:

htx mkdir 2026 /Photos
htx mkdir Archive @Ab12Cd

Rename a remote resource:

htx rename /Photos/old-name.jpg new-name.jpg

Move a remote resource into another remote directory:

htx mv /Photos/new-name.jpg /Archive

Delete a remote file:

htx rm /Archive/new-name.jpg

Delete a non-empty remote directory recursively:

htx rm --recursive /Archive

Download a remote file to the current directory:

htx download /Docs/report.pdf

Download a remote file into a chosen local path:

htx download @Ab12Cd ./downloads/report.pdf

Download a remote directory recursively:

htx download @Ab12Cd ./downloads/Archive

Create a remote link resource:

htx link Search https://www.google.com /Bookmarks

State File

The CLI stores the backend JWT token and the last fetched user payload in:

~/.config/htx-cli/state.json

Use --config to point to a different state file.

Multipart upload resume records are stored under:

~/.config/htx-cli/upload-records/