shaul-cli
Command-line interface for shaul, a unified download engine for HTTP, BitTorrent, Hugging Face and ModelScope.
The crate installs a binary named shaul.
Install
$ cargo install shaul-cli
Usage
$ shaul download https://example.com/file.tar.gz
$ shaul download hf://org/repo --include "*.safetensors"
$ shaul download magnet:?xt=urn:btih:...
$ shaul add https://example.com/a.zip https://example.com/b.zip
$ shaul run
$ shaul list
$ shaul status <id-or-suffix>
$ shaul pause <id> # a running worker notices within ~500 ms
$ shaul resume <id>
$ shaul cancel <id>
$ shaul info <link>
$ shaul config init|show|get|set|edit|path
$ shaul completions bash
Useful flags include --dir, --output, --checksum, --verify/--no-verify,
--extract/--no-extract, --extract-dir, --delete-archive, --header,
--header-file, --bearer-token, --basic, --revision, --include,
--exclude, --cache/--no-cache, --json, --force, --overwrite and
--rename.
Configuration
Precedence: CLI flags > config file > environment variables > defaults.
shaul config path prints the resolved config path. --config PATH or
SHAUL_CONFIG overrides it. Task state is stored in a per-user data directory
and a single shaul run worker owns a state directory at a time.
On Unix, task sidecars are written with mode 0600. Provider tokens read from
the environment or official credential files are never persisted. --json
output redacts sensitive headers and strips query strings from task views.
Links
MSRV is Rust 1.92. License: Apache-2.0.